ADR-NNNN: short decision title

• Status: Proposed | Accepted | Deprecated | Superseded by ADR-NNNN
• Date: YYYY-MM-DD

Context

What is the situation that forces a decision? State the problem, the constraints, the forces in tension, and the options considered. This section is descriptive and value-neutral — anyone reading it should understand why a decision was necessary without yet knowing what we chose. Link to the relevant plan docs and research notes.

Decision

The decision, stated in active voice: "We will …". Be specific and singular — one ADR, one decision. Note the chief alternatives that were rejected and, in a sentence each, why.

Consequences

What becomes easier and what becomes harder as a result — both positive and negative, and any follow-on work or new constraints the decision creates. Describe the resulting context after the decision is applied, so a future reader can judge whether the trade-off still holds.