ADR-NNN: Title¶
Status¶
- Proposed by: [name] on [date]
- Accepted on: [date] (when applicable)
- Supersedes: ADR-XXX (if applicable)
Context¶
[What is the issue that we're seeing that is motivating this decision?]
Alternatives Considered¶
Alternative 1: [Name]¶
- Description
- Pros
- Cons
Alternative 2: [Name]¶
...
Open Questions (Proposal Phase)¶
- [ ] Question 1
- [ ] Question 2
Next Steps (Proposal Phase)¶
- [ ] Step 1
- [ ] Step 2
Decision¶
[The decision that was made]
Design¶
[Technical design details, diagrams, code examples]
Rationale¶
[Why this decision was chosen over alternatives]
Trade-offs Accepted¶
- Trade-off 1: [what we gave up] in exchange for [what we gained]
- Trade-off 2: ...
Migration¶
[If this changes existing behavior, how do we migrate? Write "N/A" for new features.]
Consequences¶
- Positive: ...
- Negative: ...
- Neutral: ...