Flamekeeper glossary

Decision log

A decision log is a chronological record of important decisions, including their context, rationale, owner, date, and consequences.

Decision log definition

A decision log is a chronological record of important decisions, including their context, rationale, owner, date, alternatives, and consequences. It helps future participants understand what was decided and why without reconstructing the discussion from memory.

Recording the reasoning a future owner will need

Write the decision in direct language and explain the problem it addressed. Capture the evidence and assumptions available at the time, not a rewritten justification after the outcome is known. Name the accountable decision owner and link to approvals or detailed analysis held in authoritative systems.

Add review conditions where appropriate. A good decision may need reconsideration if cost, regulation, customer behavior, or technical constraints change. The log preserves context without turning every past choice into a permanent rule.

A product decision survives a team change

A product team postpones support for a requested integration because the vendor API lacks an essential security control. Six months later, the product manager leaves and customers ask again. The decision log shows the original constraint, alternatives considered, affected accounts, and a trigger to review after the vendor's next API release.

The new manager can reassess the decision with current evidence instead of repeating old research or assuming the feature was rejected for lack of demand.

Why decision logs become noisy or untrustworthy

Logs fail when they capture every minor choice, omit the rationale, duplicate sensitive evidence, or have no owner. They also lose credibility when people update old entries to make decisions look more certain than they were.

Keep entries concise, link rather than copy protected material, preserve meaningful changes, and connect follow-up actions to their normal tracking system. Review important open assumptions during a handover.

Organizational memory includes accumulated decisions and lessons. Tacit assumptions are beliefs that may need to be made explicit in the rationale. An internal knowledge base can make approved decisions discoverable, while a handover document should point successors to the decisions relevant to their work.

Frequently asked questions

What should a decision log include?

Include the decision, date, decision owner, context, objective, options considered, rationale, assumptions, affected work, consequences, follow-up actions, and links to authoritative evidence or approvals.

Which decisions belong in a decision log?

Record consequential, difficult-to-reverse, recurring, contested, or non-obvious decisions whose rationale would help future owners. Routine choices usually do not need individual entries.

What is the difference between a decision log and meeting minutes?

Meeting minutes summarize a meeting. A decision log isolates durable decisions and their reasoning across many meetings, messages, and workflows so they remain easy to find and review.