# NNNN. Title in present-tense imperative

- **Status:** Proposed | Accepted | Deprecated | Superseded by ADR-NNNN
- **Date:** YYYY-MM-DD
- **Deciders:** GitHub handles of people who agreed to the decision
- **Related:** issue/PR/ADR links that this decision depends on or supersedes

## Context

What forces are at play? What makes this decision non-obvious? Two or
three short paragraphs. Avoid restating background that is already in
the linked docs — link instead.

## Decision

What are we doing? Stated affirmatively, in the present tense. Keep
this section short; the reasoning lives in Context, the trade-offs in
Consequences.

## Consequences

- **Easier:** what this decision unlocks.
- **Harder:** what this decision constrains.
- **Given up:** capabilities or flexibility we explicitly walk away from.
- **Migration:** if applicable, what existing code/config has to change
  and on what timeline.

## Alternatives considered

- **Option A:** one-line description. Rejected because …
- **Option B:** one-line description. Rejected because …

(Do not list options you did not actually consider. An ADR is a record,
not a literature survey.)