---
status: Proposed         # Proposed | Accepted | Deprecated | Superseded — decision lifecycle
artifact-status: draft   # draft | approved — approval state of this generated file (gate reads this)
---
# ADR-{NNN}: {Title}

> **Date:** [Date]
> **Author:** [SE name]
> **Supersedes:** [ADR-NNN if any]
> **Related:** [ADR-NNN if any]

## Context
[Describe context leading to this decision. What problem needs solving?]

## Decision
[Describe the chosen architectural decision.]

## Rationale
[Why choose this approach? Technical and business reasons.]

## Alternatives Considered

### Alternative 1: [Name]
- **Pros:** [advantages]
- **Cons:** [disadvantages]
- **Why not chosen:** [explanation]

### Alternative 2: [Name]
- **Pros:** [advantages]
- **Cons:** [disadvantages]
- **Why not chosen:** [explanation]

## Consequences

### Positive
- [consequence 1]
- [consequence 2]

### Negative
- [consequence 1]
- [consequence 2]

### SAD Updates
*(List changes needed to update docs/sad.md - only add when ADR affects overall architecture)*
- [ ] [change 1]
- [ ] [change 2]

## Changelog
| Date | Changes | Author |
|------|---------|--------|