# ADR-[NNNN]: [Short Title]

## Status

`Proposed` | `Accepted` | `Deprecated` | `Superseded by ADR-XXXX`

## Date

[YYYY-MM-DD]

## Context

[What is the issue or decision that needs to be made? Describe the forces at play - technical constraints, team capabilities, business requirements, timeline pressure. Be specific about what makes this decision non-obvious.]

## Decision

[The decision made. State it clearly in one or two sentences. Then elaborate on why this option was chosen over the alternatives.]

## Alternatives Considered

| Option | Why rejected |
|---|---|
| [Alternative A] | [Reason] |
| [Alternative B] | [Reason] |

## Consequences

**Positive**:
- [What becomes easier or better]

**Negative / trade-offs**:
- [What becomes harder, what is deferred, what new problems are introduced]

**Neutral**:
- [What changes without being clearly good or bad]

## AI Coding Guidance

<!-- This section is written for LLM coding assistants, not for humans. -->
<!-- It translates the decision into actionable constraints for Claude. -->

When generating code related to [topic covered by this ADR]:
- [Specific constraint 1 - use `X` instead of `Y`]
- [Specific constraint 2 - always/never pattern]
- See reference implementation in `[path/to/example]`

Do NOT:
- [Anti-pattern 1]
- [Anti-pattern 2]