# ADR template

```markdown
# <N>. <decision title>

- **Status**: proposed | accepted | superseded by ADR-<M>
- **Date**: YYYY-MM-DD
- **Deciders**: @user, @user

## Context
What forces us to make this decision? Include technical constraints,
organisational constraints, and the problem statement.

## Decision
State the decision in one sentence, then elaborate.

## Consequences
- Positive: …
- Negative: …
- Neutral: …

## Alternatives considered
Name each alternative and the reason it was not chosen.

## References
- Related ADRs
- Specifications, RFCs, external docs
```

Store ADRs under `docs/adr/NNNN-short-title.md`, numbered in the order
they were accepted. Immutable once accepted — supersede instead of edit.
