prd-planner
Creates PRDs using persistent file-based planning. Use when user explicitly says "PRD", "product requirements document", or "产品需求文档". Combines PRD methodology with planning-with-files to avoid context switching.
By zhaono1 · 821 installs
npx skills add zhaono1/agent-playbook --skill prd-planner
Source repository · Upstream listing
PRD Planner
A PRD creation skill that uses persistent file based planning to maintain coherent thinking and avoid "left brain vs right brain" context switching issues.
When This Skill Activates
This skill activates when you:
Explicitly say "PRD", "prd", "create a PRD", or "产品需求文档"
Say "product requirements document" or "产品需求"
Mention "write a PRD for..."
Say "PRD planning" or "PRD 设计"
If user says "design solution" or "architecture design" without mentioning PRD, use architecting solutions instead.
The Core Philosophy
"PRD creation should be traceable, coherent, and persistent not scattered across context switches."
This skill combines:
PRD methodology (from architecting solutions)
File based persistence (from planning with files)
To create a single, coherent PRD creation workflow that doesn't lose context.
4 File Pattern for PRD Creation
For every PRD project, create FOUR files:
Pick a SCOPE (short, unique, kebab case slug) and use it as a prefix for all files.
File Purposes
File Purpose Audience Updated When
{scope} prd notes.md Raw research, requirements, architecture options (A/B/C) Self + reviewers New information gathered
{scope} prd task plan.md Track progress, phases, checkboxes, timestamps PM + dev lead Each phase completion
{scope} prd.md Product requirements (what & why), user flows PM + stakeholders + devs After requirements are clear
{scope} tech.md Technical design (API, data flow, implementation) Developers + architects After architecture is decided
Workflow
Step 1: Initialize
Create the four files with templates:
{scope} prd task plan.md
{scope} prd notes.md
{scope} prd.md
{scope} tech.md
Step 2: Gather Requirements
Ask clarifying questions and save responses to {scope} prd notes.md :
Core Questions to Ask
1. Problem : What problem are we solving?
2. Users : Who will use this?
3. Success : How do we know it's successful?
4. Constraints : Any technical/time/budget constraints?
Save each answer to {scope} prd notes.md under appropriate section.
Always update {scope} prd task plan.md after gathering info:
Step 2.5: Context Aware Edge Case Analysis
Before asking users about edge cases, scan the codebase first to infer existing patterns. This reduces redundant questions and ensures consistency with the project.
Detailed reference : See references/edge case analysis.md for full scanning commands and output formats.
Quick Process
1. Scan codebase for existing patterns (delete strategy, error handling, empty states, pagination)
2. Identify requirement type (CRUD, State Workflow, Async, Data Display, Form, File)
3. Generate smart assumptions patterns found in code don't need user confirmation
4. Ask only when needed no precedent, multiple patterns, or business decision required
When to Ask Users
Condition Action
Pattern exists in codebase Auto apply, no question needed
No precedent found Ask user with options
Multiple conflicting patterns Ask user to choose
Business rule required Ask user
Output to Notes File
Update {scope} prd notes.md with:
Update task plan:
Step 3: Research & Analysis
Research best practices and save to {scope} prd notes.md :
Save findings to {scope} prd notes.md → Research Findings section.
Step 4: Design Solution
Propose architecture with trade offs, save to {scope} prd notes.md :
Step 5: Write PRD
Read {scope} prd notes.md and synthesize into polished PRD:
Step 6: Write Technical Design
Step 7: Validate & Finalize
Review with user:
1. Present PRD summary
2. Ask for feedback
3. Incorporate changes
4. Mark Phase 7 complete
Important Rules
Rule Bad Good
Use Files Keep in memory Save to {scope} prd notes.md
Update Plan Move on without update Update task plan.md with checkbox
Read Before Decide Decide from memory Read notes first
Separate Docs Mix PRD + Tech PRD for "what", Tech for "how"
Include Options Jump to solution Document 2 3 options with pros/cons
Phase Transitions
Update {scope} prd task plan.md after each phase with checkbox ✓ and timestamp.
Completing a PRD
Mark all phases complete, set status to "✅ COMPLETE", log final deliverables.
File Cleanup (Optional)
After PRD is complete:
Keep {scope} prd notes.md for reference (shows decision process)
Archive {scope} prd task plan.md or delete
Final outputs are {scope} prd.md and {scope} tech.md
Quick Start Template
Why This Works
Problem Solution
Context switching All thinking in files, read anytime
Lost requirements Saved to {scope} prd notes.md immediately
Inconsistent PRDs Same process, same structure
"Left brain vs right brain" One coherent workflow
Re explaining context Files contain full context
Mixed concerns PRD (product) separate from Tech (implementation)
Hidden decisions Architecture options A/B/C documented
References
[planning with files](../planning with files/) File based planning methodology
[architecting solutions](../architecting solutions/) Non PRD solution and architecture design
Edge case scanning: references/edge case analysis.md
Auto Trigger (Follow up Metadata)
When this skill completes, record or run supported follow ups:
1. self improving agent (background) Propose reusable patterns
2. session logger (auto) Save session context when supported