Capability Guide: Baseline, Impact, and Operations¶
Purpose¶
Govern release state, evaluate change impact, and produce actionable readiness plans.
Modules In Scope¶
baseline_mgmtimpact_assessmentops_mgmt
When To Use This Guide¶
- preparing release candidate governance reviews
- evaluating downstream effects of baseline changes
- converting impact findings into readiness actions/milestones
Release Governance Flow¶
sequenceDiagram
autonumber
participant Base as Baseline
participant Impact as Impact
participant Ops as Operations
participant Gov as Governance
Base->>Impact: release candidate
Impact->>Ops: impact implications
Ops->>Gov: readiness and milestones
Gov-->>Base: release decision feedback Step-by-Step¶
- Build release candidate and compare against prior state.
- Package release candidate with relevant trace/evidence context.
- Perform impact assessment against dependent artifacts.
- Create/update readiness actions and milestone dependencies.
- Submit governance decision package.
- Feed decision outcomes back into planning.
Artifacts Produced¶
- baseline history/compare records
- release pack details
- impact findings/reports
- readiness backlog and milestone plans
Integration Consumers¶
- governance stakeholders (decision authority)
- delivery teams (execution planning)
- assurance/verif teams (evidence completeness feedback)
Validation Checklist¶
docker compose run --rm app sh -c "pytest baseline_mgmt/tests impact_assessment/tests ops_mgmt/tests -v"
./scripts/run_smoke_tests.sh
- release candidate trace set is complete
- impact findings are scoped to current candidate
- readiness dependencies are explicit and actionable
Common Failure Modes¶
| Symptom | Likely Cause | Fix |
|---|---|---|
| governance rejects release candidate | missing evidence/trace context | enrich release pack and rerun checks |
| readiness actions disconnected | impact outputs not mapped to ops structures | enforce mapping rules in handoff |
| milestone plan churn | unstable scope baseline | freeze baseline scope before readiness planning |
Implementation anchors
app/baseline_mgmt/views/main.pyapp/impact_assessment/views/main.pyapp/ops_mgmt/views/main.py
Critical discipline
Any material baseline scope change should trigger fresh impact assessment before final governance approval.