Skip to content

NNNN.

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.