Generated from corpus/lines/software/workflows/delivery.yml. Do not edit by hand — run python scripts/generate-corpus-docs.py.

corpus/lines/software/workflows/delivery.yml

Title / id: workflow.software

id: workflow.software
status: active
line: software
stages:
- id: frame
  entry:
  - A Software workstream has an authorized outcome and scope owner.
  bindings:
  - inv.software.app-kind
  roles:
  - role.engineering-lead
  artifacts:
  - software.frame
  evidence:
  - Outcome
  - users
  - constraints
  - definition of done
  exit:
  - Scope and acceptance are reviewable before design.
  next_stages:
  - design
  validation:
    mode: judgment
    checks:
    - definition of done is testable
    - exclusions and unresolved questions are explicit
    on_gap: gap.stage.software.frame
  recovery:
    action: remain_at_stage
    preserve:
    - artifacts
    - evidence
    - decision_log
- id: design
  entry:
  - Frame is accepted and material design choices are identified.
  bindings:
  - inv.software.brand
  - inv.software.arch-checklist
  roles:
  - role.engineering-lead
  artifacts:
  - software.design
  evidence:
  - Architecture
  - data boundaries
  - interfaces
  - pattern choice
  exit:
  - Design covers material risks and records known/adapt/novel mode.
  next_stages:
  - implement
  validation:
    mode: judgment
    checks:
    - pattern evidence is complete
    - security and recovery risks are addressed
    on_gap: gap.stage.software.design
  recovery:
    action: return_to_previous_stage
    preserve:
    - artifacts
    - evidence
    - decision_log
- id: implement
  entry:
  - Design, exact plan, repository target, and authorization are current.
  bindings:
  - inv.software.blueprint
  - inv.software.tech-stack
  roles:
  - role.engineering-lead
  - role.implementer
  artifacts:
  - software.change-set
  evidence:
  - Commit diff
  - dependency changes
  - implementation notes
  exit:
  - The authorized scope is implemented without unexplained drift.
  next_stages:
  - verify
  validation:
    mode: deterministic
    checks:
    - changed files fit authorized plan
    - dependencies and secrets policy pass
    on_gap: gap.stage.software.implement
  recovery:
    action: return_to_previous_stage
    preserve:
    - artifacts
    - evidence
    - decision_log
- id: verify
  entry:
  - Implementation is complete and verification profile is bound.
  bindings:
  - inv.software.verify-profile
  roles:
  - role.engineering-lead
  artifacts:
  - software.verification-report
  evidence:
  - Test results
  - static checks
  - security checks
  - acceptance evidence
  exit:
  - All required checks pass or failures block promotion.
  next_stages:
  - promote
  validation:
    mode: deterministic
    checks:
    - required commands exit zero
    - acceptance evidence maps to definition of done
    on_gap: gap.stage.software.verify
  recovery:
    action: return_to_previous_stage
    preserve:
    - artifacts
    - evidence
    - decision_log
- id: promote
  entry:
  - Verification passed and the exact promotion target is authorized.
  bindings:
  - inv.software.promote-target
  roles:
  - role.platform-engineer
  artifacts:
  - software.promotion-record
  evidence:
  - Source revision
  - target path
  - backup or rollback reference
  exit:
  - The reviewed revision is present at the promotion target.
  next_stages:
  - deploy
  validation:
    mode: deterministic
    checks:
    - source revision matches reviewed commit
    - rollback reference exists
    on_gap: gap.stage.software.promote
  recovery:
    action: return_to_previous_stage
    preserve:
    - artifacts
    - evidence
    - decision_log
- id: deploy
  entry:
  - Promoted revision, host/shape bindings, and deployment authorization exist.
  bindings:
  - inv.software.host
  - inv.software.shape
  roles:
  - role.platform-engineer
  artifacts:
  - software.deployment-record
  evidence:
  - Deployment revision
  - health checks
  - URL or service identity
  - rollback result
  exit:
  - The exact revision is healthy or rollback has completed.
  next_stages:
  - document
  validation:
    mode: deterministic
    checks:
    - deployed revision matches promotion
    - health checks pass
    - rollback is executable
    on_gap: gap.stage.software.deploy
  recovery:
    action: return_to_previous_stage
    preserve:
    - artifacts
    - evidence
    - decision_log
- id: document
  entry:
  - Verified implementation and operational behavior are stable.
  bindings:
  - inv.software.doc-profile
  roles:
  - role.engineering-lead
  artifacts:
  - software.documentation
  evidence:
  - Setup
  - architecture
  - operations
  - recovery
  - known limitations
  exit:
  - Documentation reproduces setup and recovery for the shipped revision.
  next_stages: []
  validation:
    mode: deterministic
    checks:
    - documented commands and references resolve
    - revision is identified
    on_gap: gap.stage.software.document
  recovery:
    action: return_to_previous_stage
    preserve:
    - artifacts
    - evidence
    - decision_log
estate_note: Estate intent comes from portfolio classify; units under units/sw.estate.*
schema_version: corpus-unit.v2
kind: workflow
version: 1.0.0
layer: organization
depends_on:
- id: core.stage-contract
  version: ^1.0.0
- id: org.roles
  version: ^1.0.0