Craig Stanley
Home / Decisions / Decision records

The decision record schema

A short, fixed format for writing down a decision at the moment it's made, so it can be reviewed fairly later.

10 October 2026 · 2 min read · Craig Stanley
In short, explained

When you make a choice, write down what you chose, why, and how sure you were. Later you can look back and learn from it.

A decision record is a short note made when the decision is made, not afterwards. It lists the options, what you knew, what you chose and how confident you were. It's the only fair way to judge a decision later.

Capture the decision at the time it's made, using a fixed schema: context, options, information, choice, confidence, owner, review date. Store records where they can be queried, so you can measure calibration and decision quality across many decisions.

The fields

FieldWhat to write
DecisionOne line, framed as a choice
OptionsThe options you considered, including "do nothing"
GoalSave money, make money, or look after people, and the measure
What we knewThe key facts and their sources
ChoiceThe option picked
ConfidenceA percentage: how likely is this to achieve the goal?
Expected resultWhat you expect to see, by when
OwnerWho made the call
Model involvementWhether a model scored it, its suggestion, its score
Review dateWhen you'll look again

Keep it short

A record that takes twenty minutes won't get written. Most fields take a line. If you're using a model, its suggestion and score can be filled in automatically.

Where to keep records

Keep them somewhere they can be searched and counted. A SharePoint list or a Dataverse table works. Free-text notes scattered across email don't. Once you have a few hundred records, you can measure calibration, spot repeated patterns, and see whether model-assisted decisions do better than unassisted ones.

Review

On the review date, add three fields: what happened, whether the decision was reasonable given what was known, and what you'd do differently. Keep the outcome and the judgement of the decision separate. That's the defence against outcome bias.

Read next

A question to take awayWhich repeated decision would you trust a cheap model to score first, with a person checking the close calls?

About me

Craig Stanley

Microsoft AI consultant and technical architect, based in Whitley Bay. Over the last few years I've delivered Microsoft 365 Copilot, Copilot Studio agents, Azure AI Foundry work and governance for UK public sector and financial services organisations.

What interests me is the decision underneath the tool: what it costs, what it risks, and whether a small, transparent model can make it better. I write the methods up here and on Substack so anyone can use them.

Find me