NNNN. Title in the imperative

• Status: Proposed | Accepted | Superseded by NNNN

• Date: YYYY-MM-DD

• Deciders: who agreed

Context

What situation forced a decision, and what constraints applied. Facts, not opinions; link the issue or PR.

Options considered

1. Option, with its main advantage and its main cost.

2. Option, with its main advantage and its main cost.

Decision

What was chosen, in one paragraph, and the reason that tipped it.

Consequences

What becomes easier, what becomes harder, what has to be done to keep the decision true (a CI gate, a script, a documented convention).