# ADR NNNN: <imperative short title>

<!--
  Template for Architecture Decision Records, per the `adr-author` skill.
  Copy this file to `<active-repo>/docs/adr/NNNN-<slug>.md` and fill in.
  Remove this HTML comment and any placeholder lines you don't use.

  NNNN = zero-padded 4 digits, one-past-max in the target docs/adr/ folder.
  <slug> = short kebab-case derived from the title.
-->

## Status

<!--
  One of: Proposed (YYYY-MM-DD) | Accepted (YYYY-MM-DD) | Superseded by ADR-XXXX (YYYY-MM-DD) | Rejected (YYYY-MM-DD)

  Note: ADR Status uses Nygard's classic 4-value vocabulary, distinct from
  `_ISSUES.md` / `_TODO.md` 3-value vocabulary (Open / InProgress / Closed).
  See `docs-check/references/TOPIC_CODES.md` "Status field conventions" for the latter.
-->

Proposed (YYYY-MM-DD)

## Context

<!--
  Objective description of the situation.
  What's the problem or opportunity? What's the timing constraint — why decide now?
  What's in scope / out of scope?
  No opinion or recommendation here — just the facts that frame the decision.
-->

## Decision

<!--
  What we decided, in one sentence or one short paragraph.
  Imperative tense: "Adopt X", "Use Y", "Migrate to Z".
  This is the headline — someone skimming the file should understand the decision
  without reading any other section.
-->

## Consequences

**Positive:**
- <what this enables / improves>
- <...>

**Negative:**
- <what this costs / breaks / constrains>
- <...>

**Follow-ups required:**
- <what needs to happen next to fully realize this decision — typically a `_TODO.md` entry or a subsequent ADR>
- <...>

## Alternatives considered

<!--
  Minimum 2 alternatives. If you only had 1 "option", it wasn't a decision —
  it was an implementation path. Consider whether this file is the right artifact.

  For "obviously bad" rejections, the one-line reason is enough. Only add
  the dimension sub-bullets (Reversibility / Cost / Future flexibility) when
  alternatives differ MATERIALLY on those dimensions — don't pad every
  rejection with all four dimensions.
-->

- **<alternative name>** (rejected): <one-sentence reason>
  - *Reversibility:* <only if cost-of-undo materially differs>
  - *Cost:* <only if implementation cost materially differs>
  - *Future flexibility:* <only if it closes doors on later options>
- **<alternative name>** (rejected): <one-sentence reason>

## Related

<!-- Remove lines that don't apply. -->

- Supersedes: <ADR-XXXX, if applicable>
- Superseded by: <ADR-YYYY, if this ADR was later overturned>
- Related ADRs: <ADR-ZZZZ, ...>
- Related TODOs/Issues: <e.g., `ACCORE-LOG-T-K7M2`, `ACCORE-BIN-I-3R9P`, ... — per `TOPIC_CODES.md` ID format rules and `REPO_PREFIXES.md` prefix scheme>
- External references: <URLs, RFCs, blog posts that informed this decision>
