Skip to content

{short title of the problem and its chosen solution}

Context and Problem Statement

{2–4 sentences describing the context and the problem, or an illustrative question. State the forces in tension. Language is value-neutral.}

Decision Drivers

  • {driver 1 — a force that constrains or motivates the decision}
  • {driver 2}

Considered Options

  • {option 1}
  • {option 2}
  • {option 3}

Decision Outcome

Chosen option: "{option N}", because {justification — which driver(s) it best satisfies}.

Consequences

  • Good, because {positive consequence}
  • Bad, because {negative consequence — list these too, not only the positives}

Confirmation

{How compliance with this decision is verified — a test, a gate, a review step, a primary source the claim is grounded in. For protocol decisions, cite the RFC/spec clause.}

Pros and Cons of the Options

{option 1}

  • Good, because {}
  • Neutral, because {}
  • Bad, because {}

{option 2}

  • Good, because {}
  • Bad, because {}

More Information

{Links to the draft section, related ADRs, issues, or primary sources.}