ADR-XXX: [Short Title]
Context
What is the issue we're facing and the context around it? What are we trying to achieve?
Decision
What is the change we're proposing/announcing?
Rationale
Why did we choose this approach? What alternatives did we consider?
Alternatives Considered
-
Alternative 1: Description
- Pros: ...
- Cons: ...
- Rejected because: ...
-
Alternative 2: Description
- Pros: ...
- Cons: ...
- Rejected because: ...
Consequences
Positive
- What becomes easier
- What capabilities do we gain
Negative
- What becomes harder
- What trade-offs are we making
Neutral
- What stays the same
- What new considerations emerge
Implementation Notes
Key technical details, gotchas, or migration steps.
// Example code if relevant
References
- [Link to related ADRs]
- [Link to external resources]
- [Link to requirements docs]
Revision History
- YYYY-MM-DD: Initial draft
- YYYY-MM-DD: Accepted after review