decision-doc

Document product decisions with rationale, alternatives, and tradeoffs.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/pisithrps/yapzee --skill decision-doc-pisithrps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-doc
Source: https://github.com/pisithrps/yapzee/tree/main/.claude/skills/decision-doc
Command: npx skills add https://github.com/pisithrps/yapzee --skill decision-doc-pisithrps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many product decisions lack a concise record of rationale, tradeoffs, and stakeholder agreement, which causes repeated debates, misalignment, and lost institutional memory. This Skill structures decisions so teams can make timely choices, communicate why they were made, and revisit outcomes later.

Core Features & Use Cases

  • Structured Decision Templates: Standard, DACI, One-Way Door, and Lightweight formats to fit different risk profiles and audiences.
  • Options & Tradeoffs Analysis: Side-by-side option breakdowns with pros, cons, costs, assumptions, success criteria, and mitigation plans.
  • Recommendation & Routing: Clear recommendation framing, confidence level, failure plan, and suggested stakeholder routing for approvals and notifications.
  • Use Case: A PM deciding build vs. buy can generate a full decision doc, stakeholder list, success metrics, and announcement copy for Slack and exec review.

Quick Start

Create a decision document recommending build versus partner for feature X with options, pros and cons, recommended choice, confidence level, key metrics, and next steps.

Frequently Asked Questions about decision-doc

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

FAQPage Schema
How do I document product decisions with rationale and tradeoffs for stakeholder alignment?

To document product decisions with rationale and tradeoffs, use a structured decision log that records options, pros, cons, and a clear recommendation. This ensures stakeholder alignment by providing a concise record of why choices were made.

What is the best way to structure a build vs buy decision document for a product team?

The best way to structure a build vs buy decision document is using a templated format that includes side-by-side option breakdowns, cost assumptions, success criteria, and mitigation plans. This produces a shareable record for executive review.

Can I use different decision framework templates for varying risk profiles like one-way door choices?

Yes, you can use different decision framework templates for varying risk profiles. Standard, DACI, One-Way Door, and Lightweight formats fit different audiences and risk levels, ensuring the decision log matches the context's required depth.

How do I route stakeholder approvals and notifications after finalizing a recommendation?

To route stakeholder approvals and notifications after finalizing a recommendation, generate suggested stakeholder routing guidance and announcement copy. This directs approvals and communicates the decision rationale to relevant teams.

When do I need a formal decision log for cross-functional tradeoffs and architectural choices?

You need a formal decision log for cross-functional tradeoffs and architectural choices when repeated debates occur or institutional memory is at risk. Documenting assumptions and success metrics prevents misalignment and lost context.