Most teams don't have a decision log. They have meeting notes, Slack threads, and a shared understanding that dissolves within two weeks. When someone asks "why did we choose X?" the answer requires archaeology. The fix is not better memory — it's a four-field template that takes five minutes per decision and survives indefinitely.
Why decision logs fail before they start
The most common failure mode is trying to log everything. A decision log that captures every minor call becomes noise within a month. The second failure mode is logging discussions instead of decisions — capturing what was said rather than what was concluded. Both produce artifacts that nobody trusts or consults.
A useful decision log captures only decisions that matter: ones that would be costly to reverse, ones that affect multiple people or teams, and ones that someone might reasonably question in six months. Everything else stays in Slack where it belongs.
The four-field template
Every decision worth keeping fits this structure:
- Decision — one sentence, imperative. "We will use Postgres for the new service." Not "we discussed Postgres and MySQL." Not "we're leaning toward Postgres." A decision.
- Why — two or three reasons that actually tipped it. Not a comprehensive list of considerations. The factors that mattered. If you can't name them, the decision wasn't actually made.
- Rejected — what was considered and ruled out, with one-line reasoning. This is the field everyone skips and everyone needs in six months. Without it, teams relitigate the same options repeatedly because they've forgotten why they were rejected.
- Authority — who decided, and what level of authority would be needed to reverse it. A decision made by a tech lead alone is reversible by that tech lead. A decision made by the CTO is not reversible without re-engaging the CTO.
Five minutes per decision. That's the target. If it takes longer, the decision isn't clearly formed yet.
Where to store it
Anywhere with a stable URL and full-text search. A dedicated section in your wiki. An ADR folder in the repo. A governance tool. The format matters less than the property that the document is still findable in twelve months by someone who wasn't in the original conversation.
Avoid: Slack threads, ephemeral doc links shared in chat, presentation slides, personal notebooks. All of these will be unfindable. A decision record that can't be found when you need it doesn't exist.
Making it a habit
The hardest part is not the template — it's the habit. Three things that make it stick:
- One designated owner per meeting who is responsible for capturing decisions made. Not "everyone," because everyone means no one.
- A standard location that the team opens automatically after key discussions. Not "wherever makes sense" — one place.
- A lightweight review in the first retrospective after launch, post-mortem, or major pivot. Pull up the decision log and ask: which decisions held, which didn't, and what would we document differently.
Teams that review their decision logs in retrospectives improve them faster than teams that treat them as write-only archives.
Decision capture built into every shift
StandIn captures decisions as they're made — not reconstructed after the fact in a meeting notes doc. Each wrap includes a decision record that's searchable, auditable, and accessible to the next shift without a standup.
Request early accessWhat a good decision log entry looks like
Here's the four-field template applied to a real-type decision:
Decision: We will not build a mobile app in 2026. We will ship a responsive web app and revisit mobile in Q1 2027.
Why: Our buyer is a manager or CoS on desktop. Mobile usage in our trial cohort is under 8%. Building a native app would pull two engineers off core product for six months.
Rejected: React Native wrapper considered — rejected because maintenance overhead and performance on slow connections would create a substandard experience that could hurt conversion. Progressive web app considered — rejected because it doesn't address the core mobile-vs-desktop usage reality.
Authority: CEO. Reversible with CEO + CTO alignment and a changed usage signal in product analytics.
That entry takes four minutes to write. It survives a team turnover. It stops the mobile question from being relitigated every quarter.
The executive version
Leadership team decision logs differ from engineering ADRs in one important way: the audience includes people who didn't participate in the decision and may join the company years later. Write the "Why" field as if explaining to a smart new hire with no context. Avoid internal shorthand. Spell out the assumptions.
A leadership decision log entry from 2024 should be as useful in 2026 as it was the day it was written. If it requires the author to interpret it, it wasn't written well enough.
Frequently asked questions
How do you get leadership to actually use a decision log?
Start with one use case where the absence of a decision log caused a real problem — a relitigated decision, a confused new hire, a post-mortem where nobody could explain a past choice. Use that example as the forcing function. The log exists to prevent that specific pain from recurring. One genuine example is more convincing than any process argument.
Should every decision go in the log?
No. The threshold is: would it cost more than thirty minutes to reconstruct why this was decided if asked in six months? If yes, log it. If it's a normal day-to-day call that doesn't meet that bar, skip it. Logging everything creates noise that makes the log useless. Selective logging makes every entry meaningful.
What's the difference between a decision log and meeting minutes?
Meeting minutes capture what was discussed. A decision log captures what was concluded. The distinction matters: minutes require reading the whole document to find the conclusion; a decision log surfaces the conclusion immediately. For most purposes, the discussion is irrelevant six months later. The decision is not.
Get async handoff insights in your inbox
One email per week. No spam. Unsubscribe anytime.
Ready to eliminate your daily standup?
Distributed teams use StandIn to start every shift with full context — no standup required. Engineers post a 60-second wrap. The next shift wakes up knowing exactly what to work on.