ADR-[number]: [Title]
ADR-[number]: [Title]
Section titled “ADR-[number]: [Title]”Status: [Proposed | Accepted | Deprecated | Superseded]
Date: YYYY-MM-DD
Decision Makers: [List of people involved in the decision]
Technical Story: [Optional: Link to related issue/story]
Context
Section titled “Context”[Describe the context and problem statement. What is the issue that we’re seeing that is motivating this decision or change?]
Decision Drivers
Section titled “Decision Drivers”- [Driver 1: e.g., performance requirements]
- [Driver 2: e.g., maintainability concerns]
- [Driver 3: e.g., team expertise]
- [Driver 4: e.g., cost considerations]
Considered Options
Section titled “Considered Options”- [Option 1]
- [Option 2]
- [Option 3]
Decision Outcome
Section titled “Decision Outcome”Chosen option: “[Option X]”
[Describe why this option was selected. What are the expected positive outcomes?]
Consequences
Section titled “Consequences”Positive
Section titled “Positive”- [Positive consequence 1]
- [Positive consequence 2]
Negative
Section titled “Negative”- [Negative consequence 1]
- [Negative consequence 2]
Neutral
Section titled “Neutral”- [Neutral consequence 1]
[Optional] Pros and Cons of the Options
Section titled “[Optional] Pros and Cons of the Options”[Option 1]
Section titled “[Option 1]”[Brief description of option 1]
Pros:
- [Advantage 1]
- [Advantage 2]
Cons:
- [Disadvantage 1]
- [Disadvantage 2]
[Option 2]
Section titled “[Option 2]”[Brief description of option 2]
Pros:
- [Advantage 1]
- [Advantage 2]
- [Advantage 2]
Cons:
- [Disadvantage 1]
- [Disadvantage 2]
[Option 3]
Section titled “[Option 3]”[Brief description of option 3]
Pros:
- [Advantage 1]
- [Advantage 2]
- [Advantage 2]
Cons:
- [Disadvantage 1]
- [Disadvantage 2]
Implementation
Section titled “Implementation”[Optional: Describe the implementation plan, timeline, and any specific technical details]
Related Decisions
Section titled “Related Decisions”- [Link to related ADR 1]
- [Link to related ADR 2]
References
Section titled “References”- [Link to resource 1]
- [Link to resource 2]
- [Link to resource 3]
[Any additional notes, follow-up items, or context that doesn’t fit elsewhere]