ADR-000: [Title]
Status
[Proposed | Accepted | Deprecated | Superseded by ADR-XXX]
Context
[Describe the issue that motivates this decision or change. What is the problem we're trying to solve? Include any relevant background information, constraints, or requirements that influence the decision.]
Key considerations:
- [Consideration 1]
- [Consideration 2]
- [Consideration 3]
Decision
[Describe the decision and the reasoning behind it. What are we going to do? Be specific about the technical approach.]
Implementation Details
[Include specific technical details, code examples, or architecture diagrams if helpful]
typescript
// Example code if relevantConsequences
Positive
- [Benefit 1]: [Explanation]
- [Benefit 2]: [Explanation]
- [Benefit 3]: [Explanation]
Negative
- [Drawback 1]: [Explanation]
- [Drawback 2]: [Explanation]
- [Drawback 3]: [Explanation]
Neutral
- [Trade-off 1]: [Explanation]
- [Trade-off 2]: [Explanation]
Alternatives Considered
[Alternative 1]: [Brief description]
- Rejected because [reason]
[Alternative 2]: [Brief description]
- Rejected because [reason]
[Alternative 3]: [Brief description]
- Rejected because [reason]
Implementation Guidelines
[Optional section with specific guidance for implementing this decision]
- [Guideline 1]
- [Guideline 2]
- [Guideline 3]
Related Decisions
- ADR-XXX: [How it relates]
- ADR-YYY: [How it relates]
References
- [Link to relevant documentation]
- [Link to relevant article or paper]
- [Link to relevant tool or library]
Notes
[Any additional notes, open questions, or areas for future consideration]