prd-writer

Creates feature-level PRDs with JTBD traceability, MoSCoW scope, and acceptance obligation ledgers.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/subvisual/the-a-team --skill prd-writer-subvisual
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prd-writer
Source: https://github.com/subvisual/the-a-team/tree/main/.claude/skills/prd-writer
Command: npx skills add https://github.com/subvisual/the-a-team --skill prd-writer-subvisual

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning discovery output (jobs, research plans, syntheses) into a delivery-ready feature definition is slow and error-prone: scope items lose traceability to user jobs, acceptance criteria end up vague, and obligations get dropped between PRD, spec, and tickets. This Skill produces a feature-level PRD where every scoped item traces to a JTBD id and every requirement carries testable acceptance criteria tracked in a canonical ledger. ## Core Features & Use Cases - JTBD-traced PRD drafting: Writes docs/features/<slug>/prd.md from a template, grouping user stories by job id and tracing every MoSCoW item and requirement to a [[NN]] job reference. - Acceptance obligation ledger: Owns acceptance.json with requirement IDs, obligation IDs, validation methods (automated, rendered-review, human-study, performance-benchmark), evidence provenance, and immutable revision history. - Pipeline integration: Consumes jobs-to-be-done output, ateam-plan.md, research-plan.md, and page briefs without rewriting them, then hands off requirement IDs to epics and ticket-writer. - Use Case: After discovery lands for an "assisted triage" feature, invoke this Skill to draft the PRD with ranked-queue requirements, requirement-level acceptance criteria, and a validated obligations ledger ready for the definition gate. ## Quick Start Ask the agent to write a PRD for your feature using the prd-writer skill, pointing it at your existing jobs-to-be-done files and research plan.

Frequently Asked Questions about prd-writer

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

FAQPage Schema
How do I write a PRD from discovery research and jobs-to-be-done?▼

Invoke the prd-writer skill after discovery lands. It reads your jtbd/ files, ateam-plan.md, research-plan.md, and research syntheses, then drafts docs/features/<slug>/prd.md with stories grouped by job and every scope item traced to a JTBD id.

What is the difference between a feature PRD and a ticket specification?▼

A feature PRD covers a capability spanning multiple tickets with business context, MoSCoW scope, and requirement-level acceptance criteria. Single tickets, bug fixes, or minor tweaks belong to ticket-writer, which refines PRD requirements into per-ticket Gherkin later.

How are acceptance criteria tracked across PRD, spec, and tickets?▼

The skill maintains an acceptance.json ledger where each requirement-level criterion becomes an obligation with a unique OBL id, validation method, owner, and evidence. Markdown artifacts embed acceptance-obligations snapshots, and a CLI validates coverage at each stage.

When should I not use a feature-level PRD?▼

Skip it for single tickets or small tweaks (use ticket-writer), when the idea is too vague to commit to scope (run discovery-plan first), or for repo-level implementation plans feeding issue decomposition, which the building plugin's write-a-prd owns.

What happens if required information is missing during PRD drafting?▼

The skill drafts with explicit TBD markers where facts are owed and lists blocking questions under Open questions rather than inventing answers. Unresolved items are mirrored to the research plan or context ledger so the definition gate can catch them.