ADR-XXX: [Short Title of Decision]
Status: [Proposed / Accepted / Deprecated / Superseded]
Date: [YYYY-MM-DD]
Deciders: [List of people involved in the decision]
Technical Story: [Description, ticket/issue URL]
Context and Problem Statement
[Describe the context and problem statement, e.g., in free form using two to three sentences. You may want to articulate the problem in form of a question.]
Key Constraints:
- [List any constraints that limit the solution space]
Key Requirements:
- [List must-have requirements]
Decision Drivers
[List the factors that influenced the decision, e.g.:]
- [driver 1, e.g., performance requirement]
- [driver 2, e.g., team expertise]
- [driver 3, e.g., cost constraints]
- [etc.]
Considered Options
Option 1: [Name]
Description: [Brief description of this option]
Pros:
- [good, because...]
- [good, because...]
Cons:
- [bad, because...]
- [bad, because...]
Effort: [Estimated effort]
Option 2: [Name]
Description: [Brief description of this option]
Pros:
- [good, because...]
- [good, because...]
Cons:
- [bad, because...]
- [bad, because...]
Effort: [Estimated effort]
Option 3: [Name]
[Repeat structure for each option considered]
Decision Outcome
Chosen option: "[Option X: Name]"
Rationale: [Explain why this option was chosen. What makes it the best choice given the context and decision drivers?]
Consequences
Positive Consequences
- [e.g., improvement of quality attribute satisfaction, follow-up decisions required, ...]
- [...]
Negative Consequences
- [e.g., compromising quality attribute, follow-up decisions required, ...]
- [...]
Technical Debt
[Any technical debt being incurred as a result of this decision? How will it be tracked?]
Implementation
Action Items:
- [Implementation task 1]
- [Implementation task 2]
- [etc.]
Timeline: [Expected implementation timeline]
Rollback Plan: [How to revert this decision if needed]
Validation
Success Metrics: [How will we measure if this decision was correct?]
Review Date: [When should we review this decision?]
References
- [Link to supporting documents]
- [Link to related ADRs]
- [Link to research/benchmarks]
Notes
[Any additional notes, context, or discussion points]