# ADR {NUMBER}: {TITLE}

- **Status:** Proposed | Accepted | Superseded by ADR-XXXX
- **Date:** YYYY-MM-DD
- **Deciders:** @handle1, @handle2

## Context

What is the problem? What forces are at play (technical, business, social)?
Keep this short; link out to source files or tickets for depth.

## Decision

What did we decide to do? Use imperative voice. Be specific enough that a new
engineer can understand the scope by reading this section alone.

## Consequences

- Positive: …
- Negative / trade-offs: …
- Follow-up work: …

## Alternatives considered

- **Option A** — why it was rejected.
- **Option B** — why it was rejected.