ADR NNN — Short title in Title Case

Replace NNN with the next number (zero-padded: 005, …). Keep titles stable once published.

Status: Draft | Proposed | Accepted | Superseded by ADR … (optional).

Context

What problem or constraint triggered this decision? What was the situation before?

Decision

What we do — concise, testable statements (bullets or short prose).

The Why

Rationale: why this over alternatives, trade-offs, and what we optimise for (correctness, DX, CI, scope, …).

Consequences

What changes in code, docs, or behaviour. Positive and negative. Optional follow-up work.

See also

• Links to roadmap, commands, other ADRs, or runbooks.