decision-doc

Generate structured decision documents with rationale, alternatives, and trade-offs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/TimothyNguyen04/pmos --skill decision-doc-timothynguyen04
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-doc
Source: https://github.com/TimothyNguyen04/pmos/tree/main/PM-OS/.claude/skills/decision-doc
Command: npx skills add https://github.com/TimothyNguyen04/pmos --skill decision-doc-timothynguyen04

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you create clear, comprehensive decision documents that ensure stakeholder alignment, prevent future debates, and build institutional memory for important product decisions.

Core Features & Use Cases

  • Structured Decision Framing: Guides you through defining the decision, its importance, and timeline.
  • Option Analysis: Helps present and compare multiple options with their pros, cons, costs, assumptions, and risks.
  • Recommendation Formulation: Assists in crafting a clear recommendation with strong rationale and confidence levels.
  • Document Generation: Creates formal decision logs in various formats (Standard, DACI, One-Way Door, Lightweight).
  • Use Case: When deciding whether to build a new feature in-house or integrate with a third-party vendor, use this Skill to document the rationale, compare the options, and record the final decision for future reference.

Quick Start

Use the decision-doc skill to start documenting a new product decision.

Frequently Asked Questions about decision-doc

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

FAQPage Schema
How do I document a product strategy decision to ensure stakeholder alignment?

Documenting a product strategy decision requires capturing the context, options, and rationale to ensure stakeholder alignment. This Skill generates structured decision documents that compare alternatives, outline trade-offs, and record recommendations to prevent future debates.

What is a one-way door analysis for irreversible product decisions?

A one-way door analysis is a documentation format for irreversible product decisions where reversing course is difficult. This Skill generates this specific framework to evaluate trade-offs, risks, and rationale before committing to a permanent strategic direction.

How do I write a decision document using the DACI framework?

Writing a DACI decision document involves assigning Driver, Approver, Contributor, and Informed roles to stakeholders. This Skill supports the DACI format, helping you frame the decision, analyze options, and formulate a clear recommendation with designated roles.

What is the best way to compare build vs. buy options for a new product feature?

Comparing build vs. buy options requires analyzing the pros, cons, costs, and risks of each alternative. This Skill helps you present multiple options side-by-side, document assumptions, and formulate a clear recommendation with a confidence level for your product strategy.

Can I track the implementation status of a documented product decision?

Yes, tracking implementation status is supported. Beyond generating the initial recommendation and rationale, this Skill facilitates stakeholder consultation and monitors the execution status of your documented product decisions to maintain institutional memory.

When do I need a formal decision log instead of a lightweight summary?

You need a formal decision log when a strategic choice requires comprehensive rationale, option analysis, and stakeholder alignment to prevent future debates. This Skill offers multiple formats, allowing you to choose a lightweight summary or a detailed DACI document based on the decision's impact.