Decision Log
When To Use
Decisions get reopened because nobody can find why they were made. Someone new asks about the dropped feature or the pricing call, and the team argues it from scratch. The log answers: what did we decide, when, who decided, what did we weigh, and is it still the current call?
When Not To Use
The log stores decisions; it does not make them. If the call is still open, write a Decision Memo first. For a single meeting's outcomes, use Meeting Notes and Decisions and feed the log from it.
Inputs
- The decision, its date and who decided it, from a Decision Memo, a Meeting Record or a thread
- The context at the time and the options considered
- Your existing log, if any, so new entries number on and link back
If you have none of this, I start from a one-line description of each decision and mark every entry proposed, as a first draft.
Approach
Architecture decision records, from Michael Nygard's 2011 post (https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions), widened to product calls: title, status, context, decision, consequences, plus options considered, decider, date and link. Two rules do the work. An accepted entry is never edited; a new entry supersedes it and links back. And each entry stays short, because nobody reads big documents. The failure it prevents: a call nobody can find, remade by whoever is loudest this month.
Workflow
- Ask at most three questions: who reads the log; which decisions to add now and where they came from; and who may approve reopening one. Skip what a pasted Doc Brief answers.
- Title each entry as a short noun phrase, numbered in sequence ("012 Export moves to paid plan").
- Write the context neutrally, as the forces at the time (customer evidence, cost, limits, dates), then the options considered, including the ones not chosen.
- Write the decision in active voice, "We will ...", one decision per entry, with the decider by name and role and the date from your records.
- Set the status: proposed, accepted, superseded or deprecated, with the date the status changed. If an entry replaces an older one, mark the older one "superseded by [#] on [date]" and change nothing else in it.
- Write the consequences, good and bad, and the link to the memo or notes. Keep the whole entry to a few lines.
- Keep the log as a Claude Docs (beta) table. Claude Docs has no version history yet, so every entry and every status change carries its own date; that is your audit trail. Without Claude Docs, I give the same table as plain chat output.
Output Format
# Decision Log
Reopening rule: [what new evidence allows a reopen]; reopens approved by [name, role]
## Index
| # | Title | Date | Status (and date set) | Decider | Link |
|---|---|---|---|---|---|
| [001] | [noun phrase] | [date] | [accepted, date] | [name, role] | [memo or notes] |
## [001] [Title]
- Date: [date] | Status: [proposed / accepted / superseded by # / deprecated], set [date]
- Decider: [name, role] | Source: [memo, Meeting Record or thread link]
- Context: [forces at the time, neutral]
- Options considered: [option A]; [option B]; [do nothing]
- Decision: We will [decision].
- Consequences: [easier] / [harder] / [follow-up work]
## Decision
[Named decider] confirms each proposed entry as accepted or not by [date]; [log owner] dates the change.
Done When
- Every entry has a number, title, date, status with its own date, decider and source link
- Every superseded entry points forward and is otherwise unchanged
- Options considered include at least one not chosen
- No entry runs longer than a few lines
Quality Bar
- Context describes forces; it does not argue for the winner
- Consequences include the costs; an entry with only upsides is incomplete
- Missing dates or deciders stay [placeholders] and the entry stays proposed
- Deciders are named for accountability only, with no comment on their calls
- Each entry names the decider and date from your records; Claude never logs a decision nobody made.
Next
Run doc-team-charter (Team Charter) to set who decides what.
About the makers
This pack is made by 90n (90n.ai): AI-native ways of working and tools for Product, Marketing and HR teams, built by ex-McKinsey founders. We map where time and money leak, redesign the work around AI and stay until your people run it themselves, and we run our own company on Claude. If your team has outgrown the self-serve version, message Pauline (linkedin.com/in/paulinebertry).
1---2name: doc-decision-log3description: Keeps a Decision Log as a dated table of short records with context, options considered, decision, decider, status, consequences and a link to the memo or notes, superseding old entries instead of editing them. Use for "run doc-decision-log", "log this decision", "decision log", "why did we decide this", "we already decided this", "decisions keep getting reopened", "decision history for the team", "supersede an old decision", part of the Claude Docs for Product Managers Pack by 90n.4metadata:5 source: https://skillmd.com/skills/polar-bear-org/doc-decision-log6---78# Decision Log910## When To Use11Decisions get reopened because nobody can find why they were made. Someone new asks about the dropped feature or the pricing call, and the team argues it from scratch. The log answers: what did we decide, when, who decided, what did we weigh, and is it still the current call?1213## When Not To Use14The log stores decisions; it does not make them. If the call is still open, write a Decision Memo first. For a single meeting's outcomes, use Meeting Notes and Decisions and feed the log from it.1516## Inputs17- The decision, its date and who decided it, from a Decision Memo, a Meeting Record or a thread18- The context at the time and the options considered19- Your existing log, if any, so new entries number on and link back20If you have none of this, I start from a one-line description of each decision and mark every entry proposed, as a first draft.2122## Approach23Architecture decision records, from Michael Nygard's 2011 post (https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions), widened to product calls: title, status, context, decision, consequences, plus options considered, decider, date and link. Two rules do the work. An accepted entry is never edited; a new entry supersedes it and links back. And each entry stays short, because nobody reads big documents. The failure it prevents: a call nobody can find, remade by whoever is loudest this month.2425## Workflow261. Ask at most three questions: who reads the log; which decisions to add now and where they came from; and who may approve reopening one. Skip what a pasted Doc Brief answers.272. Title each entry as a short noun phrase, numbered in sequence ("012 Export moves to paid plan").283. Write the context neutrally, as the forces at the time (customer evidence, cost, limits, dates), then the options considered, including the ones not chosen.294. Write the decision in active voice, "We will ...", one decision per entry, with the decider by name and role and the date from your records.305. Set the status: proposed, accepted, superseded or deprecated, with the date the status changed. If an entry replaces an older one, mark the older one "superseded by [#] on [date]" and change nothing else in it.316. Write the consequences, good and bad, and the link to the memo or notes. Keep the whole entry to a few lines.327. Keep the log as a Claude Docs (beta) table. Claude Docs has no version history yet, so every entry and every status change carries its own date; that is your audit trail. Without Claude Docs, I give the same table as plain chat output.3334## Output Format35```markdown36# Decision Log37Reopening rule: [what new evidence allows a reopen]; reopens approved by [name, role]38## Index39| # | Title | Date | Status (and date set) | Decider | Link |40|---|---|---|---|---|---|41| [001] | [noun phrase] | [date] | [accepted, date] | [name, role] | [memo or notes] |42## [001] [Title]43- Date: [date] | Status: [proposed / accepted / superseded by # / deprecated], set [date]44- Decider: [name, role] | Source: [memo, Meeting Record or thread link]45- Context: [forces at the time, neutral]46- Options considered: [option A]; [option B]; [do nothing]47- Decision: We will [decision].48- Consequences: [easier] / [harder] / [follow-up work]49## Decision50[Named decider] confirms each proposed entry as accepted or not by [date]; [log owner] dates the change.51```5253## Done When54- Every entry has a number, title, date, status with its own date, decider and source link55- Every superseded entry points forward and is otherwise unchanged56- Options considered include at least one not chosen57- No entry runs longer than a few lines5859## Quality Bar60- Context describes forces; it does not argue for the winner61- Consequences include the costs; an entry with only upsides is incomplete62- Missing dates or deciders stay [placeholders] and the entry stays proposed63- Deciders are named for accountability only, with no comment on their calls64- Each entry names the decider and date from your records; Claude never logs a decision nobody made.6566## Next67Run doc-team-charter (Team Charter) to set who decides what.6869## About the makers7071This pack is made by 90n ([90n.ai](https://90n.ai)): AI-native ways of working and tools for Product, Marketing and HR teams, built by ex-McKinsey founders. We map where time and money leak, redesign the work around AI and stay until your people run it themselves, and we run our own company on Claude. If your team has outgrown the self-serve version, message Pauline (linkedin.com/in/paulinebertry).