ADR Template
Status: Proposed | Accepted | Deprecated | Superseded by [ADR-XXXX] Date: YYYY-MM-DD Deciders: [Names or roles] Related Spec: [SPEC-XXXX if applicable]
Context
[What is the issue that we’re seeing that is motivating this decision or change? Describe the forces at play (technical, business, social). What is the current situation?]
Decision Drivers
- [Driver 1: e.g., “Team familiarity with technology”]
- [Driver 2: e.g., “Performance requirements”]
- [Driver 3: e.g., “Maintenance burden”]
- [Driver 4: e.g., “Cost considerations”]
Considered Options
Option 1: [Name]
[Brief description]
Pros:
- Pro 1
- Pro 2
Cons:
- Con 1
- Con 2
Option 2: [Name]
[Brief description]
Pros:
- Pro 1
- Pro 2
Cons:
- Con 1
- Con 2
Option 3: [Name]
[Brief description]
Pros:
- Pro 1
- Pro 2
Cons:
- Con 1
- Con 2
Decision Outcome
Chosen option: “[Option X]”
Rationale: [Why this option best addresses the decision drivers and context]
Consequences
Positive
- [Positive consequence 1]
- [Positive consequence 2]
Negative
- [Negative consequence 1]
- [Mitigation approach if any]
Neutral
- [Neutral consequence - things that change but aren’t clearly good or bad]
Implementation Notes
[Brief notes on how this will be implemented, timeline, or key steps]
References
- [Link to related documentation]
- [Link to discussions, issues, or PRs]
- [External resources that informed this decision]