# ADR-NNNN: <short decision title>

- **Status:** proposed | accepted | superseded by ADR-XXXX
- **Date:** YYYY-MM-DD

## Context

What forces are at play? What problem does this decision answer? 2–5 sentences.

## Decision

What we chose, stated actively: "We will …". One paragraph.

## Consequences

What becomes easier, what becomes harder, what we accept. Include the alternatives rejected
and the one-line reason each lost.