All frameworks and cheat sheets

Reference table

What goes in a decision record

Seven fields, written before anyone knows how it turned out

Table of seven decision record fields, from the decision and its owner to the expected outcome, the switch point and the review date, with why each matters.
Write it before the outcome is known, or it records the reconstruction.

A decision record template with seven fields: the decision and its owner, the options considered, what was known, what was uncertain, the expected outcome, the switch point and the review date. Each row says what the field captures and why a later review needs it. Filled in before the result arrives, it gives a review something to judge other than luck. With Koji, the research behind what was known stays a shareable link the record can point to.

Where this appears

What's in this reference table

FieldWhat it capturesWhy you need it later
The decision and its ownerWhat was decided, by whom, whenStops authorship being reassigned afterwards
The options consideredThe two or three real alternativesA decision with one option was not a decision
What was knownThe evidence available, with linksStops hindsight importing facts that arrived later
What was uncertainThe things nobody knew, stated plainlyNames the luck term in advance
The expected outcomeA probability or a range, not a hopeMakes the claim scoreable across many decisions
The switch pointWhat would have changed the callTies back to the value of more information
The review dateWhen this gets looked at againTurns a document into a loop

Use this image

Free to use in your docs, decks and posts under CC BY 4.0, as long as you credit Koji with a link to this page. To embed it, paste this into your page:

html
<a href="https://www.koji.so/visuals/decision-record-template-fields"><img src="https://www.koji.so/visuals/decision-record-template-fields/decision-record-template-fields.png" alt="Table of seven decision record fields, from the decision and its owner to the expected outcome, the switch point and the review date, with why each matters." width="1200" height="878" /></a>
<p>Source: <a href="https://www.koji.so/visuals/decision-record-template-fields">What goes in a decision record</a>, Koji</p>