Skip to content

NNNN. Title

Date: YYYY-MM-DD

Status

Proposed

Context

The issue motivating this decision, and any context that influences or constrains the decision. Capture the forces at play — what is awkward, broken, or impossible without acting; what alternatives exist; what trade-offs each entails.

Decision

The change that has been agreed to implement. State it as a present-tense fact (the project uses X, requires Y, prohibits Z), not as a proposal.

Consequences

What becomes easier or more difficult to do, and any risks introduced by the decision that will need to be mitigated. Cover both the positive and the negative honestly.