Field Guide / Questions

How Do You Run a Decision Log?

Short answer

Write down each meaningful decision when you make it: what you chose, the options you rejected, why, and what result would tell you it was wrong. Then set a date to review it. The review is what turns a log into a learning system.

Why keep a decision log

Memory rewrites history. A month after a decision, people remember the reasoning that matches the outcome, not the reasoning they actually used. A log captures the thinking before the result is known, so you can judge the decision on its merits instead of its luck.

It also solves a quieter problem: new team members can see why things are the way they are, instead of reopening settled questions.

A simple template

Keep each entry short enough to write in five minutes. If it takes longer, nobody will keep it up.

  1. Date and owner: who made the call and when.
  2. Decision: one sentence.
  3. Options considered: the two or three real alternatives.
  4. Reasoning: the main reason, plus what you knew and didn't know.
  5. Kill criteria: the result that would make you reverse it.
  6. Review date: when you'll check.

Which decisions to log

Not every choice. Log decisions that are expensive to reverse, that affect more than one team, or that people will ask about later. A good rule: if you'd have to explain it in a meeting six months from now, log it today.

Skip routine calls. A log full of trivia gets ignored, and then the important entries get ignored with it.

Making the review stick

Put the review date on a calendar the moment you write the entry. When it arrives, answer three questions: what happened, did the kill criteria trigger, and what would we do differently with the same information?

That last question matters. It separates a bad decision from a good decision with a bad outcome, which is the whole point of keeping the log.

Common questions

What tool should a decision log live in?

Wherever the team already works: a shared doc, a wiki page, or a single spreadsheet. The best tool is the one people will open without being reminded.

Can AI help maintain a decision log?

Yes, for drafting entries from meeting notes and reminding owners about review dates. The reasoning and the kill criteria should still come from the person accountable for the call.

Further reading: The Decision Log: The Simplest System Most Teams Skip (essay)