Skip to content

NNNN.

  • Status: Proposed | Accepted | Superseded by NNNN | Deprecated
  • Date: YYYY-MM-DD
  • Formalizes: D# (link to docs/context/07-decisions.md rows, if any)
  • Deciders:

Context

What forces are at play? The problem, the constraints, the requirements. State the facts neutrally — someone should be able to disagree with the decision but agree with the context.

Decision

The choice, stated in active voice: "We will …". Be specific enough that the consequences below follow from it.

Consequences

What becomes easier and what becomes harder as a result. Include the negative consequences and the trade-offs accepted, not just the upside.

Alternatives considered

  • — why it was rejected.

References

  • Links to modules, code, runbooks, or external docs that implement or depend on this.