Reference table
What goes in a decision record
Seven fields, written before anyone knows how it turned out

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
| Field | What it captures | Why you need it later |
|---|---|---|
| The decision and its owner | What was decided, by whom, when | Stops authorship being reassigned afterwards |
| The options considered | The two or three real alternatives | A decision with one option was not a decision |
| What was known | The evidence available, with links | Stops hindsight importing facts that arrived later |
| What was uncertain | The things nobody knew, stated plainly | Names the luck term in advance |
| The expected outcome | A probability or a range, not a hope | Makes the claim scoreable across many decisions |
| The switch point | What would have changed the call | Ties back to the value of more information |
| The review date | When this gets looked at again | Turns 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>




