Specira sample artefact. Rendered from the governed default template on a fictional company. Names, figures and dates are illustrative.All artefacts →
SAMPLE
seeded demo data · specira.ai
Specira CI/CD Pipeline: Governed Template Rendering
Governed template rendering reference: CI/CD Pipeline Design default v2 (draft) definition af33c8d8…6ddc
CI/CD Pipeline Design · Project artifact SPECIRA

CI/CD Pipeline Design: Dispatch Modernization

Meridian Field Services: instructional example, not project evidence

Draft · watermark policy: draft_only template cicd_pipeline v2 · pack: specira_default_delivery a promotion contract: stages prove claims, gates cite the strategy
§1

Pipeline Stages

mandatory 1 decision1 evidence rule validators: every_stage_states_what_it_proves · artifact_built_once_promoted_by_reference · secrets_use_short_lived_scoped_credentials

Each stage proves a claim before the next runs. One immutable artifact, promoted by reference; a rebuild anywhere breaks the provenance chain and fails the check.

StageProvesGates run here
1 · build The four services compile and package: one immutable versioned image set per commit unit
2 · verify Logic and contracts hold against production-shaped dependencies integration · contract
3 · stage-deploy Production-shaped runtime works: images promoted by reference smoke + liveness (DV-1, DV-2[1]) · e2e critical · a11y
4 · prod-deploy Real traffic holds: rolling deploy behind the health gates (§3) health gates

Provenance: image digest pinned commit-to-production. Credentials: the platform's workload identity issues short-lived stage-scoped tokens (machine identity[2]); the build runner cannot deploy. The pipeline definition lives as code in the repository, cited.

§2

Testing Gates

mandatory 1 decision1 evidence rule validators: every_gate_cites_test_strategy_layer · no_inline_test_layer_definitions · informational_gates_carry_promotion_rule

Gates SELECT from the strategy's ladder: every row is a citation; "informational" never means ignored.

Gate (cites the ladder)StageStatusOwnerNote
unit[3] 1BLOCKING Committing engineerFix before merge
contract[3] 2BLOCKING API owner Instantiates the promises (endpoint specs[4])
integration[3] 2BLOCKING Feature engineern/a
e2e critical paths[3] 3BLOCKING QA owner The pilot-critical set only (risk prioritization[3])
performance nightly[5] off-pathinformational E. Sandoval Promotion rule: two consecutive nightly regressions past 10% on any PS series turns it blocking
accessibility audit[6] 3informational QA owner Promotion rule: flips blocking at pilot exit (§4 question)

No test layer defined here: the strategy owns what exists; this table only wires.

§3

Deployment Strategy & Rollback

mandatory 2 decisions1 evidence rule validators: deployment_strategy_logged_as_decision · rollback_trigger_cites_deployment_verification_id · dora_targets_stated_per_metric
Decision: rolling with health gates

What: rolling replaces instances behind the health check; blue-green doubles capacity for a clean cutover; canary splits traffic against live metrics. Why considered: pilot traffic is one hub; a meaningful canary slice of one hub's dispatchers is too small to move the metrics before full exposure, and blue-green's capacity double buys nothing at four services. Findings: rolling wins at pilot; the canary re-decision trigger is hub three, when traffic can carry a meaningful slice (deployment strategy[7]).

Rollback, automated: triggers cited from the rollback triggers[1]: error-rate and latency ceilings watched by the platform's release automation; breach rolls back without a meeting; the release owner's manual pull authority (OD-1[7]) complements the automation. Branch flow: trunk-based with short-lived branches and flags; feature-branch flow rejected (integration pain outweighs release-scheduling control for one team) (branch flow[7]).

DORA measureTargetMeasured from
Deployment frequencyon demand; ≥ weekly during pilot Pipeline data, computed in the delivery dashboard (dashboards[8])
Lead time for changes< 1 day
Change-failure rate< 10%
Time to restore< 1 h (the automation's ceiling)
§4

Open Questions

mandatory1 decision
QuestionOwnerAnswer byBlocks
Does the accessibility gate flip to blocking at pilot exit or at the week-6 value review (two candidate events, one gate)? QA ownerSep 26, 2026 The gate table's stage-3 row only
Refs

References & Package Contents

In the Specira workspace

specira [1] Deployment verification: DV-1, DV-2, rollback triggers app.specira.ai/projects/dispatch-modernization/artifacts/deployment-verification
specira [2] Auth & authz policy: machine identity (workload tokens) app.specira.ai/projects/dispatch-modernization/artifacts/auth-authz-policy#machine
specira [3] Test strategy: the ladder, risk prioritization app.specira.ai/projects/dispatch-modernization/artifacts/test-strategy
specira [4] API contracts: endpoint specifications (contract tests' source) app.specira.ai/projects/dispatch-modernization/artifacts/api-contracts
specira [5] Performance test scenarios: the nightly PS series app.specira.ai/projects/dispatch-modernization/artifacts/performance-test-scenarios
specira [6] NFR catalog: NFR-U3 accessibility app.specira.ai/projects/dispatch-modernization/artifacts/nfr-catalog#usability
specira [7] Decision log: deployment strategy, branch flow, OD-1 app.specira.ai/projects/dispatch-modernization/artifacts/decision-log
specira [8] Observability: the delivery dashboard app.specira.ai/projects/dispatch-modernization/artifacts/observability-monitoring#dashboards
Generated by Specira · template cicd_pipeline v2 (draft) · pack specira_default_delivery lineage af33c8d8…6ddc · page 1 of 4