decision-log-entry

Record team decisions with rationale, options, tradeoffs, and revisit conditions.

32|16|Updated May 6, 2026
One-click install
npx skills add https://github.com/aakashg/product-growth-team-os --skill decision-log-entry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-log-entry
Source: https://github.com/aakashg/product-growth-team-os/tree/main/.claude/skills/decision-log-entry
Command: npx skills add https://github.com/aakashg/product-growth-team-os --skill decision-log-entry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents the team’s past “why” from getting lost by turning meetings into durable decision records that answer both what was chosen and why.

Core Features & Use Cases

  • Full decision entries for debated choices: Capture options considered, the decision rationale, accepted tradeoffs, revisit conditions, and who participated.
  • Quick entries for fast decisions: Record a lightweight decision summary plus the context that drove it.
  • Decision indexing and file-safe organization: Save decisions to a consistent folder structure and update the “Recent Decisions” list without creating merge conflicts.

Quick Start

Ask the AI: “Create a full decision log entry for our pricing change from 2026-05-28, including the options we considered, the reasoning and tradeoff, the people in the room, and the related PRD link.”

Frequently Asked Questions about decision-log-entry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I log team decisions with rationale and tradeoffs in markdown?

To record meeting decisions with rationale, you capture the options considered, accepted tradeoffs, revisit conditions, and participants. This creates durable markdown decision records saved to a date+slug path under product-development/product/decisions.

What is the best way to preserve the reasoning behind fast-moving product decisions?

Preserving fast-moving product decisions is done by creating quick lightweight entries that record the decision summary alongside the driving context. This ensures the team's past why is captured without requiring a full debated options analysis.

Can decision logging handle superseded or reversed statuses and pending forward references?

Yes, decision logging handles superseded or reversed statuses by updating the entry file metadata. It also supports pending forward references, allowing teams to track when a previous decision is overturned by a newer meeting outcome.

Does decision logging support referencing related PRDs, RFCs, and call summaries?

Yes, decision logging supports referencing related PRDs, RFCs, and call summaries directly within the entry. This applies to both fully debated choices and quick fast-moving decisions to maintain complete decision context over time.

How do I organize meeting notes into a knowledge base without creating merge conflicts?

You organize meeting notes into a knowledge base by saving decisions to a consistent folder structure and updating the Recent Decisions list. This file-safe organization prevents merge conflicts when multiple team members log entries simultaneously.

Do I need YAML frontmatter to record product rationale in markdown meeting notes?

Yes, you need YAML frontmatter containing the name and description fields to record product rationale. This metadata is required to properly index the decision entry within the product development knowledge base structure.