ADR-XXX: [Title]¶
Status: [Proposed | Accepted | Deprecated | Superseded by ADR-YYY]
Date: YYYY-MM-DD
Authors: [Names]
Deciders: [Names of people making the decision]
Context¶
[Describe the context and problem statement. What is the issue we're addressing? What are the forces at play? What are the constraints?]
Decision¶
[Describe the decision we're making. Use clear, direct language. "We will..."]
Rationale¶
[Explain why this decision was made. What factors were most important? What requirements drove this choice?]
Consequences¶
Positive¶
- [Benefit 1]
- [Benefit 2]
- [Benefit 3]
Negative¶
- [Drawback 1]
- [Drawback 2]
- [Mitigation strategy if applicable]
Risks¶
- [Risk 1 and mitigation]
- [Risk 2 and mitigation]
Alternatives Considered¶
Alternative 1: [Name]¶
[Description]
Pros: - [Pro 1] - [Pro 2]
Cons: - [Con 1] - [Con 2]
Why not chosen: [Explanation]
Alternative 2: [Name]¶
[Description]
Pros: - [Pro 1]
Cons: - [Con 1]
Why not chosen: [Explanation]
Implementation Notes¶
[Any specific guidance for implementing this decision]
References¶
- [Link 1]
- [Link 2]
- [Related ADRs]
Revision History¶
| Date | Changes | Author |
|---|---|---|
| YYYY-MM-DD | Initial version | [Name] |