- Status: {Proposed|Accepted|Superseded}
- Date: {YYYY-MM-DD}
- Context:
- What problem are we solving?
- What constraints or forces shape the decision?
- Decision:
- Summary of the choice made.
- Alternatives considered.
- Consequences:
- Positive outcomes.
- Risks or trade-offs.
- Follow-up:
- Implementation tasks.
- Review checkpoints.
- Motivation:
- Why this change is needed now.
- Design notes:
- Key implementation choices, trade-offs, and invariants.
- Test coverage summary:
- The unit, integration, E2E, or manual verification added or rerun for this work.
- Observability updates:
- Logging, tracing, metrics, health, or event-surface changes.
- Status-doc validation:
- Confirm whether
README.md, roadmap/status docs, and any operator guides touched by the change were re-checked and updated to match repo truth.
- Risk & rollback plan:
- Operational risks and the simplest rollback path if the change regresses.
- Dependency rationale:
- New dependencies added, why they were chosen, and alternatives considered.