# ADR Template

## ADR-XXXX-YY-ZZ: [Short Title]

**Date:** YYYY-MM-DD  
**Status:** [PROPOSED | ACCEPTED | REJECTED | DEPRECATED | SUPERSEDED]  
**Deciders:** [List of decision makers]  
**Technical Story:** [Link to issue/PR if applicable]

## Context

[Describe the forces at play, including technological, political, social, and project local. These forces are probably in tension, and should be called out as such. The language in this section is value-neutral. It is simply describing facts.]

## Decision

[Describe our response to these forces. We will use the past tense ("We will...").]

## Consequences

### Positive
- [List positive consequences]

### Negative
- [List negative consequences or trade-offs]

### Neutral
- [List neutral consequences or notes]

## Alternatives Considered

- **Alternative 1:** [Description] - [Why rejected]
- **Alternative 2:** [Description] - [Why rejected]
- **Alternative 3:** [Description] - [Why rejected]

## Implementation Notes

[Any specific implementation details, migration steps, or technical considerations]

## References

- [Link to relevant documentation]
- [Link to related ADRs]
- [Link to external resources]

## Related Decisions

- [List related ADRs or decisions]

---

## Usage Guidelines

1. **Copy this template** for new ADRs
2. **Number sequentially** (ADR-001, ADR-002, etc.)
3. **Use descriptive titles** that clearly indicate the decision
4. **Include all stakeholders** in the deciders list
5. **Link to related issues** and documentation
6. **Update status** as decisions evolve
7. **Store in** `doc/architecture-decisions/` directory
description:
globs:
alwaysApply: false
---