# ADR-XXXX: <Decision title>
Owners: <team or handle>
## Context
What problem are we solving? What constraints matter? What did we try?
Keep this short and concrete.
## Decision
One paragraph with the decision stated clearly and unambiguously.
Include “do / don’t” if needed.
## Consequences
- What this enables
- What this forbids
- What trade-offs we accept
## Alternatives considered
- Option A: why not
- Option B: why not
## Implementation notes
Practical guidance, sharp edges, rollout notes.
## Examples
Minimal code/config snippets that demonstrate the preferred approach.
## References
Links to docs, incidents, PRs, RFCs.