Decision log for PMs

Kevin Lee
By
Kevin Lee
Kevin Lee
Kevin Lee
Kevin is a Co-Founder of ProductHQ. He has worked as a VC at Pear Ventures where he invested in and partnered with…
More About Kevin →
×

A decision log is the lightweight record I use to preserve important product choices and the context behind them. I write down what we decided, who decided it, when it was decided, what evidence informed it, and what assumptions or consequences still matter. The goal is not to document every preference. The goal is to stop the team from repeatedly reopening a choice without remembering why it was made.

I use a decision log when a choice crosses team boundaries, changes scope, carries meaningful risk, or is likely to be questioned later. A short note can be enough for a reversible decision. A more consequential choice deserves the evidence, alternatives, constraints, and follow-up needed to interpret it responsibly.

Record the decision, not the whole meeting

I start with a clear statement of the choice. “We decided to use the existing import flow for the pilot and defer automated mapping” is more useful than “import discussion.” The entry should tell a reader what is now true and what is not included.

I include the decision owner, date, status, and affected product area. I distinguish a proposed decision from an accepted one, and I mark decisions that have been superseded rather than silently editing them out. This keeps the record useful as the product changes.

My basic entry includes:

  1. The decision statement.
  2. The owner or decision-maker.
  3. The date and status.
  4. The problem or question behind it.
  5. The evidence, constraints, and alternatives considered.
  6. The expected consequence and follow-up.

This structure is short enough to use after a review and specific enough to answer the question, “Why did we do it this way?”

Capture context and tradeoffs

I record the problem that made the decision necessary. I note the customer need, business objective, operational issue, technical constraint, or policy requirement without pretending the context is permanent. A decision can be reasonable for one audience or stage and wrong for another.

I summarize the evidence that actually influenced the choice. That may be a research finding, product behavior, an implementation constraint, a support pattern, or a risk review. I link to the source when a reader should inspect it. I label assumptions and gaps so a future reader does not mistake a working hypothesis for a confirmed fact.

I also record the meaningful alternatives and why we did not choose them. I do not need a transcript of every suggestion. I need the tradeoffs that would change how someone interprets the decision: speed versus flexibility, customer control versus operational cost, a smaller release versus broader coverage, or a known limitation versus a new dependency.

The product strategy frameworks page helps me frame those tradeoffs, but I keep the decision entry tied to the specific choice rather than turning it into a generic essay.

Make follow-up visible

A decision is not complete when the meeting ends if it creates work or a condition to check. I record the next action, owner, due point or trigger, and the signal that will tell us whether the decision remains sound. That follow-up might be a usability session, a technical spike, a support review, a launch guardrail, or a revisit after a pilot.

I state whether the decision is reversible, costly to reverse, or effectively permanent. Reversible decisions can move with less ceremony when new evidence appears. Hard-to-reverse decisions deserve a stronger evidence threshold and clearer review. The label helps the team match process to risk.

I connect entries to the working artifacts: a PRD for PMs, an experiment plan, a roadmap item, a design file, or an operational runbook. The log is the index to the reasoning; it is not the place where every detail must be duplicated.

Write for a future teammate

I assume the person reading the entry later was not in the room and does not share our abbreviations. I use plain language, explain internal terms, and include enough background to make the decision legible. I avoid describing disagreement as a character flaw. People can reach different conclusions from the same evidence, and the record should explain the choice without assigning blame.

I separate observation from interpretation. “Three pilot accounts could not complete the setup without assistance” is an observation. “The setup is too complex for the target audience” is an interpretation or hypothesis. Keeping the distinction visible makes it easier to update the decision when more evidence arrives.

I do not use the log to create false certainty. If the choice was made with incomplete information, I say what was unknown and why action was still reasonable. Honest context makes later learning more valuable than a polished story that claims the outcome was obvious.

Maintain the log without bureaucracy

I keep one searchable home for active and past decisions, with consistent titles, dates, owners, and status labels. I link to entries from the artifacts where the choice matters. I use tags or product areas only when they help retrieval; too many categories turn the log into a filing exercise.

I review the log when planning work, revisiting scope, onboarding a teammate, or responding to a recurring question. If a decision is superseded, I link the new entry to the old one and explain what changed. I do not delete the earlier reasoning unless it contains sensitive information that should not be retained.

I also watch for repeated reopenings. Sometimes repetition means the decision was not communicated. Sometimes the evidence changed. Sometimes no one had the authority to close the question. The log helps me distinguish those cases, but I still need a conversation and a decision owner when the product needs to move.

Use the log with other tools

A decision log works best with clear decision rights. A RACI for PMs can show who is responsible, accountable, consulted, and informed for a piece of work. A one-pager for PMs can frame an upcoming choice. The log preserves the result and the reasoning after the choice is made.

I do not put every backlog prioritization or routine implementation adjustment in the log. I record a choice when its context will help future work, when it creates a meaningful commitment, or when a teammate is likely to ask about the rationale. Good judgment keeps the record useful.

My bottom line

I use a decision log to preserve reasoning, not to defend decisions forever. I write the choice plainly, capture the context and tradeoffs, name uncertainty, record follow-up, and update the entry when evidence changes the path. A small, honest log helps a product team learn from its decisions instead of repeating the same debate or mistaking history for certainty.

Next step

For a structured foundation in product discovery, communication, and execution, I use the Product Manager Certification, a commercial Product HQ resource. The Product HQ newsletter shares practical product lessons and frameworks.

Kevin Lee
Kevin Lee
Kevin is a Co-Founder of ProductHQ. He has worked as a VC at Pear Ventures where he invested in and partnered with early-stage founders on product & growth to help them build the foundations of category-defining companies. He has worked as a Product Manager at AltSchool (backed by Andreessen Horowitz, Founders Fund, First Round Capital, Mark Zuckerberg, John Doerr and other exceptional investors). Previously, he was a Senior Product Manager at Kabam (acquired by NetMarble and Fox for a combined $1bn+), where he worked on products through all lifecycles in San Francisco, Vancouver, and Beijing and helped grow one of the company’s products to become the third largest revenue generating product in the company portfolio. In a former life, he worked in Technology Investment Banking at Merrill Lynch. He is also the author / co-author on 10+ gaming patents.