# ADR-XXX: [Title]
**Status**: [Proposed | Accepted | Deprecated | Superseded by ADR-YYY]
**Date**: YYYY-MM-DD
**Authors**: [Names]
**Deciders**: [Who made the decision]
## Context
[What is the issue we're facing? What constraints exist? What requirements drive this decision?]
[Describe the forces at play - technical, political, social, project-specific. These forces might be in tension and should be called out explicitly.]
## Decision
[What did we decide? Be specific and concrete. State the decision in full sentences with active voice: "We will..."]
## Consequences
### Positive
- ✅ Benefit 1: [Describe the benefit]
- ✅ Benefit 2: [Describe the benefit]
### Negative
- ❌ Trade-off 1: [Describe the cost or limitation]
- ❌ Trade-off 2: [Describe the cost or limitation]
### Neutral
- ⚪ Impact 1: [Describe neutral consequences]
## Alternatives Considered
### Alternative 1: [Name]
**Description**: [Brief description of the alternative]
**Pros**:
- [Advantage 1]
- [Advantage 2]
**Cons**:
- [Disadvantage 1]
- [Disadvantage 2]
**Why not chosen**: [Specific reason this wasn't selected]
### Alternative 2: [Name]
**Description**: [Brief description of the alternative]
**Pros**:
- [Advantage 1]
**Cons**:
- [Disadvantage 1]
**Why not chosen**: [Specific reason this wasn't selected]
## Implementation Notes
[Optional: Any specific guidance for implementing this decision]
## References
- [Link to relevant discussion]
- [Link to related code]
- [Link to external resources]
## Revision History
- YYYY-MM-DD: Initial version
- YYYY-MM-DD: Updated to reflect [change]