# ADR-NNNN: <title>

**Status:** proposed | accepted | superseded
**Date:** YYYY-MM-DD
**Supersedes:** ADR-NNNN | _none_

## Context
What pressure forced the decision. Quote real symptoms.

## Decision
Exactly what we chose, and the boundaries.

## Consequences
What gets easier; what gets harder; what we're explicitly accepting.

## Alternatives considered
Briefly: what we rejected and why.

## References
Code paths, commits, papers, prior art.
