decision-record

Create and update structured decision records with a context registry.

4|3|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/yohayetsion/product-org-os --skill decision-record
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decision-record
Source: https://github.com/yohayetsion/product-org-os/tree/main/product-org-plugin/skills/decision-record
Command: npx skills add https://github.com/yohayetsion/product-org-os --skill decision-record

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you formally document important decisions, ensuring clarity on context, options considered, rationale, and outcomes for future reference.

Core Features & Use Cases

  • Create New Decision Records: Generate a structured document for a new decision.
  • Update Existing Records: Modify and add context to previously created decision records.
  • Find Decision Records: Search for existing decision documents based on various criteria.
  • Use Case: When your team decides to "build vs. buy" for a new feature, use this skill to create a decision record detailing the options, pros/cons, rationale, and the final choice.

Quick Start

Use the decision-record skill to document the decision to launch the freemium tier.

Frequently Asked Questions about decision-record

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

FAQPage Schema
How do I document product strategy decisions and their rationale?▼

You can document product strategy decisions by creating structured decision records that capture context, options considered, rationale, and final outcomes. This approach ensures future reference and clarity on why specific strategic choices were made during planning.

What is a decision record and when do I need to create one?▼

A decision record is a structured document detailing choices made during strategic planning. You need to create one when your team makes important choices, such as a build vs. buy decision for a new feature, to formally document the options and rationale.

Can I update existing decision documentation after it has been created?▼

Yes, you can update existing decision documentation by modifying and adding context to previously created records. You can find the target record via a specific ID or file path across your specified directories to apply the modifications.

How do I find specific decision records across multiple project directories?▼

You can find specific decision records by searching across specified directories based on various criteria. The system locates existing decision documents using a persistent context registry designed for metadata storage and retrieval.

Does this decision documentation approach support persistent metadata storage?▼

Yes, this decision documentation approach supports persistent metadata storage. It integrates directly with a context registry to ensure the persistent storage and seamless retrieval of decision metadata across your strategic planning workflows.