Status: [Proposed | Accepted | Accepted (Retrospective) | Superseded by ADR-XXX | Rejected]
Date: YYYY-MM-DD
Deciders: [Engineering team, Maintainers, Architecture Working Group, etc.]
Issue/PR: #XXX
Describe the context and problem statement. What architectural drivers or operational requirements led to this decision? What constraints, trade-offs, or alternative options were considered?
State the decision clearly and concisely in active voice.
- Choice: [What option was chosen]
- Key Rationale: [Primary reasons for choosing this option over alternatives]
- Scope: [Which system components, repositories, or layers are affected]
- Benefit 1
- Benefit 2
- Drawback 1
- Drawback 2
- Structural observation or side effect
- How to verify adherence to this decision (e.g. automated CI check, code review rule, contract test).
- Triggers for revisiting this decision in the future.