NNNN. Short title in the imperative

• Status: Proposed
• Date: YYYY-MM-DD
• Deciders:

Context

What's the situation that forces a decision? The problem, the constraints, the forces in tension. Link to the relevant guide(s) and code. Keep it factual — no solution yet.

Decision

The decision, stated plainly in one or two sentences, then the detail. Write it in the active voice: "We store … / We run … / We require …".

Consequences

Positive

• What gets easier / safer / cheaper.

Negative / costs

• What gets harder, what we now have to maintain, what we're locked into.

Alternatives considered

• Option X — why we didn't pick it.
• Option Y — why we didn't pick it.

References

• Links to guides, code paths, related ADRs.