Create and manage Product Requirements Documents (PRDs). Use when: (1) Creating structured task lists with user stories, (2) Specifying features with acceptance criteria, (3) Planning feature implementation for AI agents or human developers.
Create and manage Product Requirements Documents (PRDs) for feature planning.
A PRD (Product Requirements Document) is a structured specification that:
agents/prd.json in the projectpasses: false → true{
"project": "MyApp",
"branchName": "ralph/feature-name",
"description": "Short description of the feature",
"userStories": [
{
"id": "US-001",
"title": "Add priority field to database",
"description": "As a developer, I need to store task priority.",
"acceptanceCriteria": [
"Add priority column: 'high' | 'medium' | 'low'",
"Generate and run migration",
"Typecheck passes"
],
"priority": 1,
"passes": false,
"notes": ""
}
]
}
| Field | Description |
|---|---|
project | Project name for context |
branchName | Git branch for this feature (prefix with ralph/) |
description | One-line feature summary |
userStories | List of stories to complete |
userStories[].id | Unique identifier (US-001, US-002) |
userStories[].title | Short descriptive title |
userStories[].description | "As a [user], I want [feature] so that [benefit]" |
userStories[].acceptanceCriteria | Verifiable checklist items |
userStories[].priority | Execution order (1 = first) |
userStories[].passes | Completion status (false → true when done) |
userStories[].notes | Runtime notes added by agent |
Each story should be completable in one context window.
Stories execute in priority order. Earlier stories must NOT depend on later ones.
Correct order:
Must be verifiable, not vague.
status column to tasks table with default 'pending'"Always include: "Typecheck passes"
Update passes: true when a story is complete. Use notes field for runtime observations:
"notes": "Used IF NOT EXISTS for migrations"
| Action | Command |
|---|---|
| Create PRD | Save to agents/prd.json |
| Check status | `cat prd.json |
| View incomplete | `jq '.userStories[] |
See references/ for detailed documentation:
agent-usage.md - How AI agents execute PRDs (Claude Code, OpenCode, etc.)workflows.md - Sequential workflow patternsoutput-patterns.md - Templates and examples