docs/adr/_template.md

# ADR-XXXX: <short imperative title>

**Status:** Proposed
**Date:** YYYY-MM-DD
**Serves:** PRD <FR-n / G-n / NFR-n>
**Evidence:** `docs/analysis/<dossier>.md`

## Context

What forces this decision? What is true about the system, the constraints, or the product that
makes this a real choice rather than an obvious one? State facts with citations
(`file.js:line`, URLs, measurements).

## Options considered

### A. <option>
What it is. **Pros.** **Cons.**

### B. <option>
...

## Decision

What we are doing, stated unambiguously in the present tense.

## Consequences

**Gains.** What this buys.
**Costs.** What it makes harder or more expensive — be honest.
**Follow-on work.** What this forces later.
**Revisit if.** The concrete signal that would make us reopen this.