NNNN: Title that states the decision

Context and Problem Statement

The situation and the question we must answer, in two to five sentences. Link sources for facts.

Decision Drivers

• Optional: the forces and qualities that decide between the options.

Considered Options

• The chosen option (chosen)
• Another option: why we did not take it.

Decision Outcome

Chosen option: the chosen option, because it best meets the drivers. State it so it can be checked against the code; the details follow.

• What exactly we do, as checkable statements.

Consequences

• Good: what becomes easier.
• Bad: what becomes harder, and what we must now do.

Confirmation

How compliance is checked: a named test, lint rule, import-linter contract, CI job or review step. If it is checked only in review, say so.

More Information

Optional: related ADRs, research, open questions, when to revisit.