Create Prd
npx machina-cli add skill PabloLION/bmad-plugin/create-prd --openclawPRD Workflow (Tri-Modal)
Goal: Create, Validate, or Edit comprehensive PRDs through structured workflows.
Agent: PM (John) Phase: 2 - Planning
Modes:
- Create (-c): Build new PRD from scratch through collaborative discovery
- Validate (-v): Quality check existing PRD against BMAD standards
- Edit (-e): Improve existing PRD based on validation feedback
MODE DETERMINATION
Detect Mode from Invocation
| Invocation | Mode |
|---|---|
/bmad:create-prd or -c | Create |
/bmad:validate-prd or -v | Validate |
/bmad:edit-prd or -e | Edit |
If Mode Unclear
Present selection menu:
**PRD Workflow - Select Mode:**
**[C] Create** - Create a new PRD from scratch
**[V] Validate** - Validate an existing PRD against BMAD standards
**[E] Edit** - Improve an existing PRD
Which mode would you like?
Wait for user selection before proceeding.
WORKFLOW ARCHITECTURE
Same step-file architecture as other BMAD workflows:
Core Principles
- Micro-file Design: Each step is a self-contained instruction file
- Just-In-Time Loading: Only load current step file
- Sequential Enforcement: Complete steps in order
- State Tracking: Track progress in frontmatter
stepsCompleted
Critical Rules
- NEVER load multiple step files simultaneously
- ALWAYS read entire step file before execution
- NEVER skip steps or optimize sequence
- ALWAYS halt at menus and wait for user input
MODE ROUTING
Create Mode
Entry Point: steps-c/step-01-init.md
Create mode guides through 12 steps:
- Initialization and discovery
- Input document loading
- Success criteria definition
- User journeys
- Domain model
- Innovation opportunities
- Project type specific requirements
- Scoping
- Functional requirements
- Non-functional requirements
- Polish and refinement
- Completion and validation
Validate Mode
Entry Point: steps-v/step-v-01-discovery.md
Validate mode performs 13 validation checks:
- Discovery and PRD loading
- Format detection
- Density validation
- Brief coverage validation
- Measurability validation
- Traceability validation
- Implementation leakage validation
- Domain compliance validation
- Project type validation
- SMART validation
- Holistic quality validation
- Completeness validation
- Report generation
Edit Mode
Entry Point: steps-e/step-e-01-discovery.md
Edit mode handles:
- Discovery and PRD loading
- Legacy conversion (if needed)
- Targeted improvements
INITIALIZATION SEQUENCE
1. Configuration Loading
Load project config from bmad/config.yaml:
project_name,planning_artifacts,user_namecommunication_language,document_output_language
2. Mode Detection
Check invocation for mode flags or keywords.
3. Route to Workflow
Based on mode, read and execute the appropriate entry step file:
Create: ${CLAUDE_PLUGIN_ROOT}/skills/prd/steps-c/step-01-init.md
Validate: ${CLAUDE_PLUGIN_ROOT}/skills/prd/steps-v/step-v-01-discovery.md
Edit: ${CLAUDE_PLUGIN_ROOT}/skills/prd/steps-e/step-e-01-discovery.md
OUTPUT
Create Mode Output: planning-artifacts/prd-{project_name}-{date}.md
Validate Mode Output: planning-artifacts/prd-validation-report-{date}.md
Edit Mode Output: Updates the specified PRD file in-place
Source
git clone https://github.com/PabloLION/bmad-plugin/blob/main/plugins/bmad/skills/create-prd/SKILL.mdView on GitHub Overview
PRD Workflow enables PMs to Create, Validate, or Edit product requirements documents through a structured, phase-driven process (Phase 2 - Planning). It uses mode routing, a defined step architecture, and in-place progress tracking to ensure PRDs meet BMAD standards and project needs.
How This Skill Works
On startup, the agent loads config.yaml (project_name, planning_artifacts, user_name, languages), detects the mode from the invocation, and routes to the appropriate entry step file. It enforces a single, sequential workflow with progress tracked in frontmatter (stepsCompleted) and halts for user input at menus. Outputs vary by mode: Create produces planning artifacts, Validate generates a PRD validation report, and Edit updates the PRD in place.
When to Use It
- Seed a new PRD from stakeholder input using Create mode
- Validate an existing PRD against BMAD standards
- Improve an existing PRD based on validation feedback
- Ensure PRD alignment with project type, domain, and SMART criteria
- Generate and deliver planning artifacts and validation reports
Quick Start
- Step 1: Configure bmad/config.yaml with project_name, planning_artifacts, and user_name
- Step 2: Invoke the desired mode via -c (Create), -v (Validate), or -e (Edit)
- Step 3: Follow on-screen menus and complete each step in order
Best Practices
- Define clear success criteria and load the input PRD early in the workflow
- Follow the 12-step Create path for new PRDs to ensure completeness
- Run all 13 validation checks and address issues before release
- Use the mode selection menu when invocation details are unclear
- Track progress with frontmatter stepsCompleted and never skip steps
Example Use Cases
- PM creates a new PRD from stakeholder discovery using Create mode
- A BMAD-compliant PRD is validated and a concise report is produced
- Edit mode refines a PRD after validation feedback
- Domain and project-type checks ensure regulatory and domain alignment
- Artifacts are saved as planning-artifacts/prd-{project_name}-{date}.md and a validation report as planning-artifacts/prd-validation-report-{date}.md