Skip to content

NNNN. Short title of the decision

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

Context

What is the problem or force that motivates this decision? Describe the situation, the constraints, and any alternatives considered. State facts and pressures, not the solution.

Decision

The change we are making, stated in active voice: "We will ...". Be specific enough that a future reader can tell whether the codebase still follows it.

Consequences

What becomes easier or harder as a result. Include the trade-offs accepted, new obligations introduced, and any follow-up work. List both positive and negative consequences.