write-a-prd

Compile decision artifacts into a decision-traced PRD with DEC-NNN traceability.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/drshailesh88/build_playbook --skill write-a-prd-drshailesh88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-prd
Source: https://github.com/drshailesh88/build_playbook/tree/main/vendor/mattpocock-skills/write-a-prd
Command: npx skills add https://github.com/drshailesh88/build_playbook --skill write-a-prd-drshailesh88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns scattered decision artifacts (grill logs, decision indexes, and context files) into a single production-grade PRD that downstream builders can use without needing to re-interview or guess missing rationale.

Core Features & Use Cases

  • Decision-traced PRD compilation: Assembles a PRD where every claim traces back to a decision ID (DEC-NNN), and flags any untraced claims as assumptions.
  • Session-safe, self-contained output: Ensures the PRD can be read cold by a new agent in a fresh session, with no reliance on prior conversation or implicit context.
  • Buildability and scope discipline: Applies scope discipline rules (vertical slicing, anti-rationalization checks) and gates finalization on the prerequisite verification round.

Quick Start

Use write-a-prd after the grill decision artifacts have been created on disk, so the skill compiles them into a PRD that downstream tools like prd-to-gsd can consume.

Frequently Asked Questions about write-a-prd

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

FAQPage Schema
How do I compile a PRD from existing planning artifacts and decision records?

To compile a PRD from planning artifacts, the skill reads existing UX, data, and infra decision records on disk, enforcing DEC-NNN traceability for every claim and flagging untraced items as assumptions before output. It transforms scattered grill logs into a single build contract.

What is decision-tracing in product requirements documents?

Decision-tracing in product requirements documents ensures every claim within the PRD maps directly back to a specific decision ID (DEC-NNN). This mechanism flags untraced claims as assumptions, guaranteeing downstream builders have verifiable rationale without re-interviewing.

Can I generate a build-ready PRD without re-interviewing stakeholders?

You can generate a build-ready PRD without re-interviewing by reading existing decision artifacts from disk. The skill assembles a session-safe, self-contained document that a new agent can read cold, requiring no reliance on prior conversation or implicit context.

How do I enforce scope discipline when creating buildable stories?

To enforce scope discipline when creating buildable stories, the skill applies vertical slicing and anti-rationalization checks. It gates finalization on a prerequisite verification round, ensuring the compiled PRD maintains strict scope discipline for downstream builders.

What planning artifacts do I need before generating a PRD?

Before generating a PRD, you need existing decision artifacts on disk, including grill logs, decision indexes, and context files covering UX, data, UI, infra, and competitive research. These records provide the verifiable foundation required for compilation.