fix: update masonry grid sizing logic and notebook list padding

This commit is contained in:
Sepehr Ramezani
2026-02-14 14:20:32 +01:00
parent a0ffc9043b
commit 8f9031f076
580 changed files with 9789 additions and 42619 deletions

View File

@@ -9,5 +9,7 @@ scientific,"research,algorithm,simulation,modeling,computational,analysis,data s
legaltech,"legal,law,contract,compliance,litigation,patent,attorney,court",high,"Legal ethics;Bar regulations;Data retention;Attorney-client privilege;Court system integration","Legal practice rules;Ethics requirements;Court filing systems;Document standards;Confidentiality","domain-research","legal technology ethics {date};law practice management software requirements;court filing system standards;attorney client privilege technology","ethics_compliance;data_retention;confidentiality_measures;court_integration"
insuretech,"insurance,claims,underwriting,actuarial,policy,risk,premium",high,"Insurance regulations;Actuarial standards;Data privacy;Fraud detection;State compliance","Insurance regulations by state;Actuarial methods;Risk modeling;Claims processing;Regulatory reporting","domain-research","insurance software regulations {date};actuarial standards software;insurance fraud detection;state insurance compliance","regulatory_requirements;risk_modeling;fraud_detection;reporting_compliance"
energy,"energy,utility,grid,solar,wind,power,electricity,oil,gas",high,"Grid compliance;NERC standards;Environmental regulations;Safety requirements;Real-time operations","Energy regulations;Grid standards;Environmental compliance;Safety protocols;SCADA systems","domain-research","energy sector software compliance {date};NERC CIP standards;smart grid requirements;renewable energy software standards","grid_compliance;safety_protocols;environmental_compliance;operational_requirements"
process_control,"industrial automation,process control,PLC,SCADA,DCS,HMI,operational technology,OT,control system,cyberphysical,MES,historian,instrumentation,I&C,P&ID",high,"Functional safety;OT cybersecurity;Real-time control requirements;Legacy system integration;Process safety and hazard analysis;Environmental compliance and permitting;Engineering authority and PE requirements","Functional safety standards;OT security frameworks;Industrial protocols;Process control architecture;Plant reliability and maintainability","domain-research + technical-model","IEC 62443 OT cybersecurity requirements {date};functional safety software requirements {date};industrial process control architecture;ISA-95 manufacturing integration","functional_safety;ot_security;process_requirements;engineering_authority"
building_automation,"building automation,BAS,BMS,HVAC,smart building,lighting control,fire alarm,fire protection,fire suppression,life safety,elevator,access control,DDC,energy management,sequence of operations,commissioning",high,"Life safety codes;Building energy standards;Multi-trade coordination and interoperability;Commissioning and ongoing operational performance;Indoor environmental quality and occupant comfort;Engineering authority and PE requirements","Building automation protocols;HVAC and mechanical controls;Fire alarm, fire protection, and life safety design;Commissioning process and sequence of operations;Building codes and energy standards","domain-research","smart building software architecture {date};BACnet integration best practices;building automation cybersecurity {date};ASHRAE building standards","life_safety;energy_compliance;commissioning_requirements;engineering_authority"
gaming,"game,player,gameplay,level,character,multiplayer,quest",redirect,"REDIRECT TO GAME WORKFLOWS","Game design","game-brief","NA","NA"
general,"",low,"Standard requirements;Basic security;User experience;Performance","General software practices","continue","software development best practices {date}","standard_requirements"
1 domain signals complexity key_concerns required_knowledge suggested_workflow web_searches special_sections
9 legaltech legal,law,contract,compliance,litigation,patent,attorney,court high Legal ethics;Bar regulations;Data retention;Attorney-client privilege;Court system integration Legal practice rules;Ethics requirements;Court filing systems;Document standards;Confidentiality domain-research legal technology ethics {date};law practice management software requirements;court filing system standards;attorney client privilege technology ethics_compliance;data_retention;confidentiality_measures;court_integration
10 insuretech insurance,claims,underwriting,actuarial,policy,risk,premium high Insurance regulations;Actuarial standards;Data privacy;Fraud detection;State compliance Insurance regulations by state;Actuarial methods;Risk modeling;Claims processing;Regulatory reporting domain-research insurance software regulations {date};actuarial standards software;insurance fraud detection;state insurance compliance regulatory_requirements;risk_modeling;fraud_detection;reporting_compliance
11 energy energy,utility,grid,solar,wind,power,electricity,oil,gas high Grid compliance;NERC standards;Environmental regulations;Safety requirements;Real-time operations Energy regulations;Grid standards;Environmental compliance;Safety protocols;SCADA systems domain-research energy sector software compliance {date};NERC CIP standards;smart grid requirements;renewable energy software standards grid_compliance;safety_protocols;environmental_compliance;operational_requirements
12 process_control industrial automation,process control,PLC,SCADA,DCS,HMI,operational technology,OT,control system,cyberphysical,MES,historian,instrumentation,I&C,P&ID high Functional safety;OT cybersecurity;Real-time control requirements;Legacy system integration;Process safety and hazard analysis;Environmental compliance and permitting;Engineering authority and PE requirements Functional safety standards;OT security frameworks;Industrial protocols;Process control architecture;Plant reliability and maintainability domain-research + technical-model IEC 62443 OT cybersecurity requirements {date};functional safety software requirements {date};industrial process control architecture;ISA-95 manufacturing integration functional_safety;ot_security;process_requirements;engineering_authority
13 building_automation building automation,BAS,BMS,HVAC,smart building,lighting control,fire alarm,fire protection,fire suppression,life safety,elevator,access control,DDC,energy management,sequence of operations,commissioning high Life safety codes;Building energy standards;Multi-trade coordination and interoperability;Commissioning and ongoing operational performance;Indoor environmental quality and occupant comfort;Engineering authority and PE requirements Building automation protocols;HVAC and mechanical controls;Fire alarm, fire protection, and life safety design;Commissioning process and sequence of operations;Building codes and energy standards domain-research smart building software architecture {date};BACnet integration best practices;building automation cybersecurity {date};ASHRAE building standards life_safety;energy_compliance;commissioning_requirements;engineering_authority
14 gaming game,player,gameplay,level,character,multiplayer,quest redirect REDIRECT TO GAME WORKFLOWS Game design game-brief NA NA
15 general low Standard requirements;Basic security;User experience;Performance General software practices continue software development best practices {date} standard_requirements

View File

@@ -151,7 +151,7 @@ Display menu after setup report:
#### Menu Handling Logic:
- IF C: Update output file frontmatter, adding this step name to the end of the list of stepsCompleted, then load, read entire {nextStepFile}, then execute {nextStepFile}
- IF C: Update output file frontmatter, adding this step name to the end of the list of stepsCompleted, then read fully and follow: {nextStepFile}
- IF user provides additional files: Load them, update inputDocuments and documentCounts, redisplay report
- IF user asks questions: Answer and redisplay menu
@@ -162,7 +162,7 @@ Display menu after setup report:
## CRITICAL STEP COMPLETION NOTE
ONLY WHEN [C continue option] is selected and [frontmatter properly updated with this step added to stepsCompleted and documentCounts], will you then load and read fully `{nextStepFile}` to execute and begin project discovery.
ONLY WHEN [C continue option] is selected and [frontmatter properly updated with this step added to stepsCompleted and documentCounts], will you then read fully and follow: `{nextStepFile}` to begin project discovery.
---

View File

@@ -120,7 +120,7 @@ Display: "**Select an Option:** [C] Continue to {next step name}"
#### Menu Handling Logic:
- IF C: Load, read entire file, then execute the {nextStepFile} determined in step 3
- IF C: Read fully and follow the {nextStepFile} determined in step 3
- IF Any other comments or queries: respond and redisplay menu
#### EXECUTION RULES:
@@ -130,7 +130,7 @@ Display: "**Select an Option:** [C] Continue to {next step name}"
## CRITICAL STEP COMPLETION NOTE
ONLY WHEN [C continue option] is selected and [current state confirmed], will you then load and read fully the {nextStepFile} to resume the workflow.
ONLY WHEN [C continue option] is selected and [current state confirmed], will you then read fully and follow: {nextStepFile} to resume the workflow.
---

View File

@@ -185,9 +185,9 @@ Present the project classification for review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Product Vision (Step 2b of 13)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the current classification, process the enhanced insights that come back, ask user if they accept the improvements, if yes update classification then redisplay menu, if no keep original classification then redisplay menu
- IF P: Execute {partyModeWorkflow} with the current classification, process the collaborative insights, ask user if they accept the changes, if yes update classification then redisplay menu, if no keep original classification then redisplay menu
- IF C: Save classification to {outputFile} frontmatter, add this step name to the end of stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the current classification, process the enhanced insights that come back, ask user if they accept the improvements, if yes update classification then redisplay menu, if no keep original classification then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the current classification, process the collaborative insights, ask user if they accept the changes, if yes update classification then redisplay menu, if no keep original classification then redisplay menu
- IF C: Save classification to {outputFile} frontmatter, add this step name to the end of stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:
@@ -197,7 +197,7 @@ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Pr
## CRITICAL STEP COMPLETION NOTE
ONLY WHEN [C continue option] is selected and [classification saved to frontmatter], will you then load and read fully `{nextStepFile}` to explore product vision.
ONLY WHEN [C continue option] is selected and [classification saved to frontmatter], will you then read fully and follow: `{nextStepFile}` to explore product vision.
---

View File

@@ -175,9 +175,9 @@ Present the success criteria content for user review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to User Journey Mapping (Step 4 of 11)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the current success criteria content, process the enhanced success metrics that come back, ask user "Accept these improvements to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF P: Execute {partyModeWorkflow} with the current success criteria, process the collaborative improvements to metrics and scope, ask user "Accept these changes to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the current success criteria content, process the enhanced success metrics that come back, ask user "Accept these improvements to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the current success criteria, process the collaborative improvements to metrics and scope, ask user "Accept these changes to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:

View File

@@ -155,9 +155,9 @@ Present the user journey content for review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Domain Requirements (Step 5 of 11)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the current journey content, process the enhanced journey insights that come back, ask user "Accept these improvements to the user journeys? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF P: Execute {partyModeWorkflow} with the current journeys, process the collaborative journey improvements and additions, ask user "Accept these changes to the user journeys? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the current journey content, process the enhanced journey insights that come back, ask user "Accept these improvements to the user journeys? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the current journeys, process the collaborative journey improvements and additions, ask user "Accept these changes to the user journeys? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:

View File

@@ -154,9 +154,9 @@ Acknowledge the domain and explore what makes it complex:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue - Save and Proceed to Innovation (Step 6 of 13)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask}, and when finished redisplay the menu
- IF P: Execute {partyModeWorkflow}, and when finished redisplay the menu
- IF C: Save content to {outputFile}, update frontmatter, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask}, and when finished redisplay the menu
- IF P: Read fully and follow: {partyModeWorkflow}, and when finished redisplay the menu
- IF C: Save content to {outputFile}, update frontmatter, then read fully and follow: {nextStepFile}
- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#n-present-menu-options)
#### EXECUTION RULES:
@@ -178,7 +178,7 @@ If step was skipped, append nothing and proceed.
## CRITICAL STEP COMPLETION NOTE
ONLY WHEN [C continue option] is selected and [content saved or skipped], will you then load and read fully `{nextStepFile}` to explore innovation.
ONLY WHEN [C continue option] is selected and [content saved or skipped], will you then read fully and follow: `{nextStepFile}` to explore innovation.
---

View File

@@ -155,9 +155,9 @@ Present the innovation content for review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Project Type Analysis (Step 7 of 11)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the current innovation content, process the enhanced innovation insights that come back, ask user "Accept these improvements to the innovation analysis? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF P: Execute {partyModeWorkflow} with the current innovation content, process the collaborative innovation exploration and ideation, ask user "Accept these changes to the innovation analysis? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the current innovation content, process the enhanced innovation insights that come back, ask user "Accept these improvements to the innovation analysis? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the current innovation content, process the collaborative innovation exploration and ideation, ask user "Accept these changes to the innovation analysis? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:
@@ -176,7 +176,7 @@ Display: "**Select:** [A] Advanced Elicitation - Let's try to find innovative an
### Menu Handling Logic:
- IF A: Proceed with content generation anyway, then return to menu
- IF C: Skip this step, then load, read entire file, then execute {nextStepFile}
- IF C: Skip this step, then read fully and follow: {nextStepFile}
### EXECUTION RULES:
- ALWAYS halt and wait for user input after presenting menu

View File

@@ -172,9 +172,9 @@ Present the project-type content for review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Scoping (Step 8 of 11)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the current project-type content, process the enhanced technical insights that come back, ask user "Accept these improvements to the technical requirements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF P: Execute {partyModeWorkflow} with the current project-type requirements, process the collaborative technical expertise and validation, ask user "Accept these changes to the technical requirements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the current project-type content, process the enhanced technical insights that come back, ask user "Accept these improvements to the technical requirements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the current project-type requirements, process the collaborative technical expertise and validation, ask user "Accept these changes to the technical requirements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:

View File

@@ -183,9 +183,9 @@ Present the scoping decisions for review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Functional Requirements (Step 9 of 11)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the current scoping analysis, process the enhanced insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF P: Execute {partyModeWorkflow} with the scoping context, process the collaborative insights on MVP and roadmap decisions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the current scoping analysis, process the enhanced insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the scoping context, process the collaborative insights on MVP and roadmap decisions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:

View File

@@ -181,9 +181,9 @@ Present the functional requirements for review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Non-Functional Requirements (Step 10 of 11)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the current FR list, process the enhanced capability coverage that comes back, ask user if they accept the additions, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF P: Execute {partyModeWorkflow} with the current FR list, process the collaborative capability validation and additions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the current FR list, process the enhanced capability coverage that comes back, ask user if they accept the additions, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the current FR list, process the collaborative capability validation and additions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:

View File

@@ -168,9 +168,9 @@ Present the non-functional requirements for review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Polish Document (Step 11 of 12)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the current NFR content, process the enhanced quality attribute insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF P: Execute {partyModeWorkflow} with the current NFR list, process the collaborative technical validation and additions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the current NFR content, process the enhanced quality attribute insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the current NFR list, process the collaborative technical validation and additions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:

View File

@@ -5,7 +5,7 @@ description: 'Optimize and polish the complete PRD document for flow, coherence,
# File References
nextStepFile: './step-12-complete.md'
outputFile: '{planning_artifacts}/prd.md'
purposeFile: './data/prd-purpose.md'
purposeFile: '../data/prd-purpose.md'
# Task References
advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
@@ -169,9 +169,9 @@ Present the polished document for review, then display menu:
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Complete PRD (Step 12 of 12)"
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask} with the polished document, process the enhanced refinements that come back, ask user "Accept these polish improvements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original polish then redisplay menu
- IF P: Execute {partyModeWorkflow} with the polished document, process the collaborative refinements to flow and coherence, ask user "Accept these polish changes? (y/n)", if yes update content with improvements then redisplay menu, if no keep original polish then redisplay menu
- IF C: Save the polished document to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
- IF A: Read fully and follow: {advancedElicitationTask} with the polished document, process the enhanced refinements that come back, ask user "Accept these polish improvements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original polish then redisplay menu
- IF P: Read fully and follow: {partyModeWorkflow} with the polished document, process the collaborative refinements to flow and coherence, ask user "Accept these polish changes? (y/n)", if yes update content with improvements then redisplay menu, if no keep original polish then redisplay menu
- IF C: Save the polished document to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
- IF Any other: help user respond, then redisplay menu
#### EXECUTION RULES:

View File

@@ -87,39 +87,7 @@ Offer validation workflows to ensure PRD is ready for implementation:
### 4. Suggest Next Workflows
Provide guidance on logical next workflows - strongly suggesting any of these chosen are started in a fresh context with the appropriate agent:
**Typical Next Workflows:**
**Immediate Next Steps:**
1. **PRD Quality Validation First (Recommended):**
- execute the `{validationFlow}` workflow if selected or start a new chat with me and select the validate PRD menu item
- Ensures PRD is complete and ready
- Identifies any gaps or issues
- Validates before committing to architecture/design
2. **UX Design:** `workflow create-ux-design` with the UX-Designer Agent (if UI exists)
- User journey insights from step-04 inform interaction design
- Functional requirements from step-09 define design scope
- Polish-optimized document provides clear design requirements
3. **Technical Architecture:** `workflow create-architecture` with the Architect Agent
- Project-type requirements from step-07 guide technical decisions
- Non-functional requirements from step-10 inform architecture choices
- Functional requirements define system capabilities
4. **Epic Breakdown:** `workflow create-epics-and-stories` with me again - but really recommend first doing a UX if needed and an architecture!
- Functional requirements from step-09 become epics and stories
- Scope definition from step-03 guides sprint planning
- Richer when created after UX/architecture
**Strategic Considerations:**
- Validation adds confidence before architecture/design investment
- UX design and architecture can happen in parallel after validation
- Epics/stories are richer when created after UX/architecture
- Order depends on team preferences and project needs
PRD complete. Read fully and follow: `_bmad/core/tasks/help.md` with argument `Create PRD`.
### 5. Final Completion Confirmation
@@ -149,30 +117,6 @@ Provide guidance on logical next workflows - strongly suggesting any of these ch
**CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
**CRITICAL**: Making decisions without complete understanding of step requirements and protocols
## WORKFLOW COMPLETION CHECKLIST:
### Document Structure Complete:
- [ ] Executive Summary with vision and differentiator
- [ ] Success Criteria with measurable outcomes
- [ ] Product Scope (MVP, Growth, Vision)
- [ ] User Journeys (comprehensive coverage)
- [ ] Domain Requirements (if applicable)
- [ ] Innovation Analysis (if applicable)
- [ ] Project-Type Requirements
- [ ] Functional Requirements (capability contract)
- [ ] Non-Functional Requirements
- [ ] Document polished for flow and coherence
### Process Complete:
- [ ] All steps (including polish) completed with user confirmation
- [ ] All content saved and optimized
- [ ] Frontmatter properly updated
- [ ] Workflow status file updated (if exists)
- [ ] Validation options presented
- [ ] Next steps clearly communicated
## FINAL REMINDER to give the user:
The polished PRD serves as the foundation for all subsequent product development activities. All design, architecture, and development work should trace back to the requirements and vision documented in this PRD - update it also as needed as you continue planning.

View File

@@ -4,7 +4,7 @@ description: 'Discovery & Understanding - Understand what user wants to edit and
# File references (ONLY variables used in this step)
altStepFile: './step-e-01b-legacy-conversion.md'
prdPurpose: '{project-root}/src/modules/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md'
prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
---
@@ -189,7 +189,7 @@ Display: "**Edit Requirements Understood**
**Proceeding to deep review and analysis...**"
Load and execute next step (step-e-02-review.md)
Read fully and follow: next step (step-e-02-review.md)
**IF PRD is Legacy (Non-Standard) AND no validation report:**
@@ -216,7 +216,7 @@ Present MENU OPTIONS below for user selection
#### Menu Handling Logic:
- IF C (Convert): Load, read entire file, then execute {altStepFile} (step-e-01b-legacy-conversion.md)
- IF C (Convert): Read fully and follow: {altStepFile} (step-e-01b-legacy-conversion.md)
- IF E (Edit As-Is): Display "Proceeding with edits..." then load next step
- IF X (Exit): Display summary and exit
- IF Any other: help user, then redisplay menu

View File

@@ -5,7 +5,7 @@ description: 'Legacy PRD Conversion Assessment - Analyze legacy PRD and propose
# File references (ONLY variables used in this step)
nextStepFile: './step-e-02-review.md'
prdFile: '{prd_file_path}'
prdPurpose: '{project-root}/src/modules/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md'
prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
---
# Step E-1B: Legacy PRD Conversion Assessment
@@ -182,7 +182,7 @@ Edit goals: {summary}
**Proceeding to deep review...**"
Load and execute {nextStepFile} (step-e-02-review.md)
Read fully and follow: {nextStepFile} (step-e-02-review.md)
---

View File

@@ -6,7 +6,7 @@ description: 'Deep Review & Analysis - Thoroughly review existing PRD and prepar
nextStepFile: './step-e-03-edit.md'
prdFile: '{prd_file_path}'
validationReport: '{validation_report_path}' # If provided
prdPurpose: '{project-root}/src/modules/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md'
prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
---
@@ -204,7 +204,7 @@ Display: "**Change Plan Approved**
**Proceeding to edit step...**"
Load and execute {nextStepFile} (step-e-03-edit.md)
Read fully and follow: {nextStepFile} (step-e-03-edit.md)
### 7. Present MENU OPTIONS (If User Wants Discussion)
@@ -219,8 +219,8 @@ Load and execute {nextStepFile} (step-e-03-edit.md)
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask}, then return to discussion
- IF P: Execute {partyModeWorkflow}, then return to discussion
- IF A: Read fully and follow: {advancedElicitationTask}, then return to discussion
- IF P: Read fully and follow: {partyModeWorkflow}, then return to discussion
- IF C: Document approval, then load {nextStepFile}
- IF Any other: discuss, then redisplay menu

View File

@@ -5,7 +5,7 @@ description: 'Edit & Update - Apply changes to PRD following approved change pla
# File references (ONLY variables used in this step)
nextStepFile: './step-e-04-complete.md'
prdFile: '{prd_file_path}'
prdPurpose: '{project-root}/src/modules/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md'
prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
---
# Step E-3: Edit & Update
@@ -222,7 +222,7 @@ Display:
#### Menu Handling Logic:
- IF V (Validate): Display "Starting validation workflow..." then load and execute steps-v/step-v-01-discovery.md
- IF V (Validate): Display "Starting validation workflow..." then read fully and follow: steps-v/step-v-01-discovery.md
- IF S (Summary): Present edit summary and exit
- IF A (Adjust): Accept additional requirements, loop back to editing
- IF X (Exit): Display summary and exit

View File

@@ -4,7 +4,7 @@ description: 'Complete & Validate - Present options for next steps including ful
# File references (ONLY variables used in this step)
prdFile: '{prd_file_path}'
validationWorkflow: './steps-v/step-v-01-discovery.md'
validationWorkflow: '../steps-v/step-v-01-discovery.md'
---
# Step E-4: Complete & Validate
@@ -120,14 +120,14 @@ Display:
- Display: "This will run all 13 validation checks on the updated PRD."
- Display: "Preparing to validate: {prd_file_path}"
- Display: "**Proceeding to validation...**"
- Load, read entire file, then execute {validationWorkflow} (steps-v/step-v-01-discovery.md)
- Read fully and follow: {validationWorkflow} (steps-v/step-v-01-discovery.md)
- Note: This hands off to the validation workflow which will run its complete 13-step process
- **IF E (Edit More):**
- Display: "**Additional Edits**"
- Ask: "What additional edits would you like to make?"
- Accept input, then display: "**Returning to edit step...**"
- Load and execute step-e-03-edit.md again
- Read fully and follow: step-e-03-edit.md again
- **IF S (Summary):**
- Display detailed summary including:

View File

@@ -187,9 +187,9 @@ Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Conti
#### Menu Handling Logic:
- IF A: Execute {advancedElicitationTask}, and when finished redisplay the menu
- IF P: Execute {partyModeWorkflow}, and when finished redisplay the menu
- IF C: Load, read entire file, then execute {nextStepFile} to begin format detection
- IF A: Read fully and follow: {advancedElicitationTask}, and when finished redisplay the menu
- IF P: Read fully and follow: {partyModeWorkflow}, and when finished redisplay the menu
- IF C: Read fully and follow: {nextStepFile} to begin format detection
- IF user provides additional document: Load it, update report, redisplay summary
- IF Any other: help user, then redisplay menu

View File

@@ -136,7 +136,7 @@ Display: "**Format Detected:** {classification}
Proceeding to systematic validation checks..."
Immediately load and execute {nextStepFile} (step-v-03-density-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-03-density-validation.md)
**IF format is Non-Standard (< 3 core sections):**
@@ -161,8 +161,8 @@ Present MENU OPTIONS below for user selection
#### Menu Handling Logic:
- IF A (Parity Check): Load, read entire file, then execute {altStepFile} (step-v-02b-parity-check.md)
- IF B (Validate As-Is): Display "Proceeding with validation..." then load, read entire file, then execute {nextStepFile}
- IF A (Parity Check): Read fully and follow: {altStepFile} (step-v-02b-parity-check.md)
- IF B (Validate As-Is): Display "Proceeding with validation..." then read fully and follow: {nextStepFile}
- IF C (Exit): Display format findings summary and exit validation
- IF Any other: help user respond, then redisplay menu

View File

@@ -180,7 +180,7 @@ Your PRD is missing {count} of 6 core BMAD PRD sections. The overall effort to r
#### Menu Handling Logic:
- IF C (Continue): Display "Proceeding with validation..." then load, read entire file, then execute {nextStepFile}
- IF C (Continue): Display "Proceeding with validation..." then read fully and follow: {nextStepFile}
- IF E (Exit): Display parity summary and exit validation
- IF S (Save): Confirm saved, display summary, exit
- IF Any other: help user respond, then redisplay menu

View File

@@ -148,7 +148,7 @@ Severity: {Critical/Warning/Pass}
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile} (step-v-04-brief-coverage-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-04-brief-coverage-validation.md)
---

View File

@@ -76,7 +76,7 @@ Display: "**Product Brief Coverage: Skipped** (No Product Brief provided)
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile}
Without delay, read fully and follow: {nextStepFile}
**IF Product Brief exists:** Continue to step 2 below
@@ -186,7 +186,7 @@ Overall Coverage: {assessment}
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile} (step-v-05-measurability-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-05-measurability-validation.md)
---

View File

@@ -201,7 +201,7 @@ Total Violations: {count} ({severity})
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile} (step-v-06-traceability-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-06-traceability-validation.md)
---

View File

@@ -189,7 +189,7 @@ Total Issues: {count} ({severity})
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile} (step-v-07-implementation-leakage-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-07-implementation-leakage-validation.md)
---

View File

@@ -178,7 +178,7 @@ Total Violations: {count} ({severity})
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile} (step-v-08-domain-compliance-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-08-domain-compliance-validation.md)
---

View File

@@ -161,7 +161,7 @@ Domain: {domain} (low complexity)
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile}
Without delay, read fully and follow: {nextStepFile}
### 6. Report Compliance Findings (High-Complexity Domains)
@@ -213,7 +213,7 @@ Compliance Status: {status}
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile} (step-v-09-project-type-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-09-project-type-validation.md)
---

View File

@@ -234,7 +234,7 @@ Compliance: {score}%
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile} (step-v-10-smart-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-10-smart-validation.md)
---

View File

@@ -179,7 +179,7 @@ FR Quality: {percentage}% with acceptable scores ({severity})
**Proceeding to next validation check...**"
Immediately load and execute {nextStepFile} (step-v-11-holistic-quality-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-11-holistic-quality-validation.md)
---

View File

@@ -66,7 +66,7 @@ Assess the PRD as a cohesive, compelling document - evaluating document flow, du
"Perform holistic quality assessment on this PRD using multi-perspective evaluation:
**Load and execute Advanced Elicitation workflow:**
**Read fully and follow the Advanced Elicitation workflow:**
{advancedElicitationTask}
**Evaluate the PRD from these perspectives:**
@@ -232,7 +232,7 @@ Overall Rating: {rating}/5 - {label}
**Proceeding to final validation checks...**"
Immediately load and execute {nextStepFile} (step-v-12-completeness-validation.md)
Without delay, read fully and follow: {nextStepFile} (step-v-12-completeness-validation.md)
---

View File

@@ -212,7 +212,7 @@ Overall Completeness: {percentage}% ({severity})
**Proceeding to final step...**"
Immediately load and execute {nextStepFile} (step-v-13-report-complete.md)
Without delay, read fully and follow: {nextStepFile} (step-v-13-report-complete.md)
---

View File

@@ -163,7 +163,7 @@ Display:
**[R] Review Detailed Findings** - Walk through validation report section by section
**[E] Use Edit Workflow** - Use validation report with Edit workflow for systematic improvements
**[F] Fix Simpler Items** - Immediate fixes for simple issues (anti-patterns, leakage, missing headers)
**[X] Exit** - Exit and review validation report
**[X] Exit** - Exit and Suggest Next Steps.
#### EXECUTION RULES:
@@ -181,7 +181,7 @@ Display:
- **IF E (Use Edit Workflow):**
- Explain: "The Edit workflow (steps-e/) can use this validation report to systematically address issues. Edit mode will guide you through discovering what to edit, reviewing the PRD, and applying targeted improvements."
- Offer: "Would you like to launch Edit mode now? It will help you fix validation findings systematically."
- If yes: Load and execute steps-e/step-e-01-discovery.md
- If yes: Read fully and follow: steps-e/step-e-01-discovery.md
- If no: Return to menu
- **IF F (Fix Simpler Items):**
@@ -197,8 +197,7 @@ Display:
- **IF X (Exit):**
- Display: "**Validation Report Saved:** {validationReportPath}"
- Display: "**Summary:** {overall status} - {recommendation}"
- Display: "**Next Steps:** Review the validation report and address findings. For systematic improvements, consider using Edit workflow when available, or manually fix issues identified in this report."
- Exit validation
- PRD Validation complete. Read fully and follow: `_bmad/core/tasks/help.md` with argument `Validate PRD`.
- **IF Any other:** Help user, then redisplay menu

View File

@@ -0,0 +1,63 @@
---
name: create-prd
description: Create a comprehensive PRD (Product Requirements Document) through structured workflow facilitation
main_config: '{project-root}/_bmad/bmm/config.yaml'
nextStep: './steps-c/step-01-init.md'
---
# PRD Create Workflow
**Goal:** Create comprehensive PRDs through structured workflow facilitation.
**Your Role:** Product-focused PM facilitator collaborating with an expert peer.
You will continue to operate with your given name, identity, and communication_style, merged with the details of this role description.
## WORKFLOW ARCHITECTURE
This uses **step-file architecture** for disciplined execution:
### Core Principles
- **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
- **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
- **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
- **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document
- **Append-Only Building**: Build documents by appending content as directed to the output file
### Step Processing Rules
1. **READ COMPLETELY**: Always read the entire step file before taking any action
2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
6. **LOAD NEXT**: When directed, read fully and follow the next step file
### Critical Rules (NO EXCEPTIONS)
- 🛑 **NEVER** load multiple step files simultaneously
- 📖 **ALWAYS** read entire step file before execution
- 🚫 **NEVER** skip steps or optimize the sequence
- 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
- 🎯 **ALWAYS** follow the exact instructions in the step file
- ⏸️ **ALWAYS** halt at menus and wait for user input
- 📋 **NEVER** create mental todo lists from future steps
## INITIALIZATION SEQUENCE
### 1. Configuration Loading
Load and read full config from {main_config} and resolve:
- `project_name`, `output_folder`, `planning_artifacts`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
- `date` as system-generated current datetime
✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`.
### 2. Route to Create Workflow
"**Create Mode: Creating a new PRD from scratch.**"
Read fully and follow: `{nextStep}` (steps-c/step-01-init.md)

View File

@@ -0,0 +1,65 @@
---
name: edit-prd
description: Edit and improve an existing PRD - enhance clarity, completeness, and quality
main_config: '{project-root}/_bmad/bmm/config.yaml'
editWorkflow: './steps-e/step-e-01-discovery.md'
---
# PRD Edit Workflow
**Goal:** Edit and improve existing PRDs through structured enhancement workflow.
**Your Role:** PRD improvement specialist.
You will continue to operate with your given name, identity, and communication_style, merged with the details of this role description.
## WORKFLOW ARCHITECTURE
This uses **step-file architecture** for disciplined execution:
### Core Principles
- **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
- **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
- **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
- **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document
- **Append-Only Building**: Build documents by appending content as directed to the output file
### Step Processing Rules
1. **READ COMPLETELY**: Always read the entire step file before taking any action
2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
6. **LOAD NEXT**: When directed, read fully and follow the next step file
### Critical Rules (NO EXCEPTIONS)
- 🛑 **NEVER** load multiple step files simultaneously
- 📖 **ALWAYS** read entire step file before execution
- 🚫 **NEVER** skip steps or optimize the sequence
- 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
- 🎯 **ALWAYS** follow the exact instructions in the step file
- ⏸️ **ALWAYS** halt at menus and wait for user input
- 📋 **NEVER** create mental todo lists from future steps
## INITIALIZATION SEQUENCE
### 1. Configuration Loading
Load and read full config from {main_config} and resolve:
- `project_name`, `output_folder`, `planning_artifacts`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
- `date` as system-generated current datetime
✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`.
### 2. Route to Edit Workflow
"**Edit Mode: Improving an existing PRD.**"
Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file."
Then read fully and follow: `{editWorkflow}` (steps-e/step-e-01-discovery.md)

View File

@@ -0,0 +1,65 @@
---
name: validate-prd
description: Validate an existing PRD against BMAD standards - comprehensive review for completeness, clarity, and quality
main_config: '{project-root}/_bmad/bmm/config.yaml'
validateWorkflow: './steps-v/step-v-01-discovery.md'
---
# PRD Validate Workflow
**Goal:** Validate existing PRDs against BMAD standards through comprehensive review.
**Your Role:** Validation Architect and Quality Assurance Specialist.
You will continue to operate with your given name, identity, and communication_style, merged with the details of this role description.
## WORKFLOW ARCHITECTURE
This uses **step-file architecture** for disciplined execution:
### Core Principles
- **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
- **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
- **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
- **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document
- **Append-Only Building**: Build documents by appending content as directed to the output file
### Step Processing Rules
1. **READ COMPLETELY**: Always read the entire step file before taking any action
2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
6. **LOAD NEXT**: When directed, read fully and follow the next step file
### Critical Rules (NO EXCEPTIONS)
- 🛑 **NEVER** load multiple step files simultaneously
- 📖 **ALWAYS** read entire step file before execution
- 🚫 **NEVER** skip steps or optimize the sequence
- 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
- 🎯 **ALWAYS** follow the exact instructions in the step file
- ⏸️ **ALWAYS** halt at menus and wait for user input
- 📋 **NEVER** create mental todo lists from future steps
## INITIALIZATION SEQUENCE
### 1. Configuration Loading
Load and read full config from {main_config} and resolve:
- `project_name`, `output_folder`, `planning_artifacts`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
- `date` as system-generated current datetime
✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`.
### 2. Route to Validate Workflow
"**Validate Mode: Validating an existing PRD against BMAD standards.**"
Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file."
Then read fully and follow: `{validateWorkflow}` (steps-v/step-v-01-discovery.md)

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -159,7 +159,7 @@ Show the generated project understanding content and present choices:
## APPEND TO DOCUMENT:
When user selects 'C', append the content directly to the document. Only after the content is saved to document, load `./step-03-core-experience.md` and execute the instructions.
When user selects 'C', append the content directly to the document. Only after the content is saved to document, read fully and follow: `./step-03-core-experience.md`.
## SUCCESS METRICS:

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -161,7 +161,7 @@ Show the generated core experience content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current core experience content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current core experience content
- Process the enhanced experience insights that come back
- Ask user: "Accept these improvements to the core experience definition? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -169,7 +169,7 @@ Show the generated core experience content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current core experience definition
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current core experience definition
- Process the collaborative experience improvements that come back
- Ask user: "Accept these changes to the core experience definition? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -164,7 +164,7 @@ Show the generated emotional response content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current emotional response content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current emotional response content
- Process the enhanced emotional insights that come back
- Ask user: "Accept these improvements to the emotional response definition? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -172,7 +172,7 @@ Show the generated emotional response content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current emotional response definition
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current emotional response definition
- Process the collaborative emotional insights that come back
- Ask user: "Accept these changes to the emotional response definition? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -179,7 +179,7 @@ Show the generated inspiration analysis content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current inspiration analysis content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current inspiration analysis content
- Process the enhanced pattern insights that come back
- Ask user: "Accept these improvements to the inspiration analysis? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -187,7 +187,7 @@ Show the generated inspiration analysis content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current inspiration analysis
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current inspiration analysis
- Process the collaborative pattern insights that come back
- Ask user: "Accept these changes to the inspiration analysis? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -197,7 +197,7 @@ Show the generated inspiration analysis content and present choices:
- Append the final content to `{planning_artifacts}/ux-design-specification.md`
- Update frontmatter: append step to end of stepsCompleted array
- Load and execute`./step-06-design-system.md`
- Read fully and follow: `./step-06-design-system.md`
## APPEND TO DOCUMENT:

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -197,7 +197,7 @@ Show the generated design system content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current design system content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current design system content
- Process the enhanced design system insights that come back
- Ask user: "Accept these improvements to the design system decision? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -205,7 +205,7 @@ Show the generated design system content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current design system choice
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current design system choice
- Process the collaborative design system insights that come back
- Ask user: "Accept these changes to the design system decision? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -199,7 +199,7 @@ Show the generated defining experience content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current defining experience content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current defining experience content
- Process the enhanced experience insights that come back
- Ask user: "Accept these improvements to the defining experience? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -207,7 +207,7 @@ Show the generated defining experience content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current defining experience
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current defining experience
- Process the collaborative experience insights that come back
- Ask user: "Accept these changes to the defining experience? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -169,7 +169,7 @@ Show the generated visual foundation content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current visual foundation content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current visual foundation content
- Process the enhanced visual insights that come back
- Ask user: "Accept these improvements to the visual foundation? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -177,7 +177,7 @@ Show the generated visual foundation content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current visual foundation
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current visual foundation
- Process the collaborative visual insights that come back
- Ask user: "Accept these changes to the visual foundation? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -169,7 +169,7 @@ Show the generated design direction content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current design direction content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current design direction content
- Process the enhanced design insights that come back
- Ask user: "Accept these improvements to the design direction? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -177,7 +177,7 @@ Show the generated design direction content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current design direction
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current design direction
- Process the collaborative design insights that come back
- Ask user: "Accept these changes to the design direction? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -187,7 +187,7 @@ Show the generated user journey content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current user journey content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current user journey content
- Process the enhanced journey insights that come back
- Ask user: "Accept these improvements to the user journeys? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -195,7 +195,7 @@ Show the generated user journey content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current user journeys
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current user journeys
- Process the collaborative journey insights that come back
- Ask user: "Accept these changes to the user journeys? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -193,7 +193,7 @@ Show the generated component strategy content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current component strategy content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current component strategy content
- Process the enhanced component insights that come back
- Ask user: "Accept these improvements to the component strategy? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -201,7 +201,7 @@ Show the generated component strategy content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current component strategy
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current component strategy
- Process the collaborative component insights that come back
- Ask user: "Accept these changes to the component strategy? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -182,7 +182,7 @@ Show the generated UX patterns content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current UX patterns content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current UX patterns content
- Process the enhanced pattern insights that come back
- Ask user: "Accept these improvements to the UX patterns? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -190,7 +190,7 @@ Show the generated UX patterns content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current UX patterns
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current UX patterns
- Process the collaborative pattern insights that come back
- Ask user: "Accept these changes to the UX patterns? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -30,8 +30,8 @@ This step will generate content and present choices:
## PROTOCOL INTEGRATION:
- When 'A' selected: Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md
- When 'A' selected: Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml
- When 'P' selected: Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md
- PROTOCOLS always return to this step's A/P/C menu
- User accepts/rejects protocol changes before proceeding
@@ -209,7 +209,7 @@ Show the generated responsive and accessibility content and present choices:
#### If 'A' (Advanced Elicitation):
- Execute {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current responsive/accessibility content
- Read fully and follow: {project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml with the current responsive/accessibility content
- Process the enhanced insights that come back
- Ask user: "Accept these improvements to the responsive/accessibility strategy? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu
@@ -217,7 +217,7 @@ Show the generated responsive and accessibility content and present choices:
#### If 'P' (Party Mode):
- Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current responsive/accessibility strategy
- Read fully and follow: {project-root}/_bmad/core/workflows/party-mode/workflow.md with the current responsive/accessibility strategy
- Process the collaborative insights that come back
- Ask user: "Accept these changes to the responsive/accessibility strategy? (y/n)"
- If yes: Update content with improvements, then return to A/P/C menu

View File

@@ -82,70 +82,13 @@ Update the main workflow status file:
### 3. Suggest Next Steps
Provide guidance on logical next workflows:
**Typical Next Workflows:**
**Immediate Next Steps:**
1. **Wireframe Generation** - Create detailed wireframes based on UX specification
2. **Interactive Prototype** - Build clickable prototypes for user testing
3. **Solution Architecture** - Technical architecture design with UX context
4. **Figma Design** - High-fidelity visual design implementation
**Visual Design Workflows:**
- Wireframe Generation → Interactive Prototype → Figma Design
- Component Showcase → AI Frontend Prompt → Design System Implementation
**Development Workflows:**
- Solution Architecture → Epic Creation → Development Sprints
**What would be most valuable to tackle next?**
### 4. Document Quality Check
Perform final validation of the UX design:
**Completeness Check:**
- Does the specification clearly communicate the design vision?
- Are user journeys thoroughly documented?
- Are all critical components specified?
- Are responsive and accessibility requirements comprehensive?
- Is there clear guidance for implementation?
**Consistency Check:**
- Do all sections align with the emotional goals?
- Is design system integration clearly defined?
- Are patterns consistent across all user flows?
- Does visual direction match established foundation?
UX Design complete. Read fully and follow: `_bmad/core/tasks/help.md` with argument `Create UX`.
### 5. Final Completion Confirmation
Confirm completion with user:
"**Your UX Design Specification for {{project_name}} is now complete and ready for implementation!**
Congratulate the user on the completion you both completed together of the UX.
**The specification contains everything needed to:**
- Guide visual designers in creating the final interfaces
- Inform developers of all UX requirements and patterns
- Ensure consistency across all user interactions
- Maintain accessibility and responsive design standards
- Provide a foundation for user testing and iteration
**Ready to continue with:**
- Wireframe generation for detailed layouts?
- Interactive prototype for user testing?
- Solution architecture for technical planning?
- Visual design implementation?
**Or would you like to review the complete specification first?**
[UX Design Workflow Complete]"
## SUCCESS METRICS:

View File

@@ -1,7 +1,6 @@
---
name: create-ux-design
description: Work with a peer UX Design expert to plan your applications UX patterns, look and feel.
web_bundle: true
---
# Create UX Design Workflow
@@ -40,4 +39,4 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
## EXECUTION
- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
- Load and execute `steps/step-01-init.md` to begin the UX design workflow.
- Read fully and follow: `steps/step-01-init.md` to begin the UX design workflow.

View File

@@ -1,433 +0,0 @@
---
validationTarget: 'PRD Workflow Structure'
validationDate: '2026-01-08'
inputDocuments: []
validationStepsCompleted: ['discovery', 'frontmatter-validation', 'content-validation', 'documentation-validation', 'integration-validation', 'corrections-applied']
validationStatus: COMPLETE - PRODUCTION READY
---
# PRD Workflow Validation Report
**Workflow Being Validated:** /Users/brianmadison/dev/BMAD-METHOD/src/modules/bmm/workflows/2-plan-workflows/prd
**Validation Date:** 2026-01-08
**Validator:** BMAD Workflow Validation System
---
## Executive Summary
This validation report assesses the PRD workflow structure against BMAD workflow standards. The PRD workflow is a tri-modal workflow system with Create, Validate, and Edit phases.
---
## 1. File Structure & Size Analysis
### Folder Structure
```
prd/
├── workflow.md (main workflow file)
├── steps-c/ (Create steps - 12 files)
├── steps-v/ (Validation steps - 13 files)
├── steps-e/ (Edit steps - 5 files)
├── data/
│ └── prd-purpose.md
└── templates/
└── prd-template.md
```
**✅ Structure Status**: PASS - All required folders present
### File Size Analysis
#### Steps-C (Create Steps) - 12 files
| File | Lines | Status |
|------|-------|--------|
| step-01-init.md | 191 | ⚠️ Approaching limit |
| step-01b-continue.md | 153 | ✅ Good |
| step-02-discovery.md | 197 | ⚠️ Approaching limit |
| step-03-success.md | 226 | ⚠️ Approaching limit |
| step-04-journeys.md | 213 | ⚠️ Approaching limit |
| step-05-domain.md | 193 | ⚠️ Approaching limit |
| step-06-innovation.md | 226 | ⚠️ Approaching limit |
| step-07-project-type.md | 225 | ⚠️ Approaching limit |
| step-08-scoping.md | 228 | ⚠️ Approaching limit |
| step-09-functional.md | 231 | ⚠️ Approaching limit |
| step-10-nonfunctional.md | 242 | ⚠️ Approaching limit |
| step-11-polish.md | 217 | ⚠️ Approaching limit |
| step-12-complete.md | 185 | ✅ Good |
#### Steps-V (Validation Steps) - 13 files
| File | Lines | Status |
|------|-------|--------|
| step-v-01-discovery.md | 217 | ⚠️ Approaching limit |
| step-v-02-format-detection.md | 191 | ⚠️ Approaching limit |
| step-v-02b-parity-check.md | 209 | ⚠️ Approaching limit |
| step-v-03-density-validation.md | 174 | ✅ Good |
| step-v-04-brief-coverage-validation.md | 214 | ⚠️ Approaching limit |
| step-v-05-measurability-validation.md | 228 | ⚠️ Approaching limit |
| step-v-06-traceability-validation.md | 217 | ⚠️ Approaching limit |
| step-v-07-implementation-leakage-validation.md | 205 | ⚠️ Approaching limit |
| step-v-08-domain-compliance-validation.md | 243 | ⚠️ Approaching limit |
| step-v-09-project-type-validation.md | 263 | ❌ Exceeds limit |
| step-v-10-smart-validation.md | 209 | ⚠️ Approaching limit |
| step-v-11-holistic-quality-validation.md | 264 | ❌ Exceeds limit |
| step-v-12-completeness-validation.md | 242 | ⚠️ Approaching limit |
| step-v-13-report-complete.md | 231 | ⚠️ Approaching limit |
#### Steps-E (Edit Steps) - 5 files
| File | Lines | Status |
|------|-------|--------|
| step-e-01-discovery.md | 206 | ⚠️ Approaching limit |
| step-e-01b-legacy-conversion.md | 208 | ⚠️ Approaching limit |
| step-e-02-review.md | 249 | ⚠️ Approaching limit |
| step-e-03-edit.md | 253 | ❌ Exceeds limit |
| step-e-04-complete.md | 168 | ✅ Good |
#### Data & Templates
| File | Lines | Status |
|------|-------|--------|
| data/prd-purpose.md | 197 | ⚠️ Approaching limit |
| templates/prd-template.md | 10 | ✅ Good |
| workflow.md | 114 | ✅ Good |
### File Size Statistics
- **Total Files**: 32 markdown files
- **✅ Good (<200 lines)**: 6 files (18.8%)
- **⚠️ Approaching limit (200-250)**: 23 files (71.9%)
- **❌ Exceeds limit (>250)**: 3 files (9.4%)
- **Average lines per file**: 213.3 lines
### ⚠️ Recommendations
1. **Files Exceeding 250-line limit**:
- `step-v-09-project-type-validation.md` (263 lines) - Consider splitting into sub-steps
- `step-v-11-holistic-quality-validation.md` (264 lines) - Consider splitting into sub-steps
- `step-e-03-edit.md` (253 lines) - Consider splitting into sub-steps
2. **Files Approaching Limit**:
- Many files are in the 200-250 line range
- Monitor these files as further additions may push them over the limit
- Consider proactive refactoring where appropriate
---
## 2. Frontmatter Structure Validation
### Files Checked: 29 total files
**✅ Overall Status:** ALL VALID - One Issue Fixed
#### Main Workflow (workflow.md)
**Required Fields Present:**
-`name`: "prd"
-`description`: "PRD tri-modal workflow"
-`nextStep`: "./steps-c/step-01-init.md"
-`validateWorkflow`: "./steps-v/step-v-01-discovery.md"
-`editWorkflow`: "./steps-e/step-e-01-discovery.md" (FIXED - was assess-workflow.md)
#### Create Steps (steps-c)
- ✅ All 13 files have proper name, description, nextStepFile
- ✅ Proper sequencing from step-01 through step-12
- ✅ Consistent output file references
#### Validation Steps (steps-v)
- ✅ All 13 files have complete frontmatter
- ✅ Proper sequential chain maintained
- ✅ No broken internal references
#### Edit Steps (steps-e)
- ✅ All files have required fields
- ✅ Proper routing with altStepFile references
### ✅ All Issues Resolved
**1. Broken Edit Workflow Reference:**
```yaml
# Current (INCORRECT):
editWorkflow: './steps-e/step-e-01-assess-workflow.md'
# Should be:
editWorkflow: './steps-e/step-e-01-discovery.md'
```
**2. Step Numbering Gap:**
- Original `step-11-complete.md` was deleted
- Sequence now: step-10 → step-11-polish → step-12-complete
- Creates confusion in step numbering
### ✅ YAML Syntax
- No YAML syntax errors detected
- All frontmatter properly formatted
- Consistent structure across files
### Status
**ALL ISSUES RESOLVED** - Only cosmetic improvements remain:
1. **✅ FIXED**: Edit workflow path corrected in workflow.md
2. **⚠️ OPTIONAL**: Address step numbering gap for clarity
3. **⚠️ OPTIONAL**: Rename step-01b-continue.md to step-01a-continue.md for consistency
---
## 3. Step File Content Validation
### Content Quality Assessment: 4.5/5 - EXCELLENT
#### Files Reviewed: 10 representative files across all modes
#### ✅ Strengths
**1. Comprehensive Structure:**
- Clear step goal sections in all files
- Detailed mandatory execution rules
- Well-defined execution protocols
- Context boundaries clearly specified
- Mandatory sequence with numbered steps
- System success/failure metrics present
**2. BMAD Compliance:**
- ✅ JIT loading references consistently mentioned
- ✅ State tracking requirements documented
- ✅ Append-only building instructions present
- ✅ Critical rules properly emphasized with emojis
- ✅ Sequential enforcement clearly stated
**3. Instructional Quality:**
- Clear, unambiguous instructions
- Proper menu handling rules (where applicable)
- Excellent continuation checks
- Strong role definition for each mode
**4. Role Clarity:**
- Create Mode: "Product-focused PM facilitator"
- Validate Mode: "Validation Architect and Quality Assurance Specialist"
- Edit Mode: "PRD improvement specialist"
#### ⚠️ Minor Improvement Opportunities
**1. Header Formatting:**
- Some inconsistency in header level usage across files
- Recommend standardizing H2/H3 usage
**2. Edit Mode Completeness:**
- Edit mode has fewer steps (5 vs 12/13 for other modes)
- Documentation marks it as "Future" but implementation exists
#### Recommendations
1. **LOW PRIORITY**: Standardize header formatting across all step files
2. **LOW PRIORITY**: Complete remaining edit mode steps for parity
3. **MAINTAIN**: Current excellent quality standards
---
## 4. Documentation Validation
### Documentation Completeness: ✅ COMPREHENSIVE
#### Main Components Present
- ✅ Workflow Definition (workflow.md)
- ✅ Purpose Document (data/prd-purpose.md)
- ✅ Template (templates/prd-template.md)
- ✅ Three Mode Implementations (Create: 12, Validate: 13, Edit: 5 steps)
#### Clarity Assessment: ✅ EXCELLENT
**Strong Points:**
1. Clear mode determination (commands, flags, menu selection)
2. Detailed routing instructions for each mode
3. Comprehensive workflow architecture explanation
4. Well-defined critical rules with visual emphasis
5. Professional presentation with consistent formatting
#### ⚠️ Minor Issues Found
**1. Step Count Mismatch:**
- workflow.md mentions "11 steps" for Create mode
- Actually implements 12 steps
- Could confuse users
**2. Edit Mode Status:**
- workflow.md calls Edit mode "Future"
- Edit mode steps are actually implemented
- Should reflect current status
**3. Template Completeness:**
- PRD template is minimal (10 lines)
- Could benefit from section placeholders
**4. Missing README:**
- No onboarding documentation for new users
- Not critical but would be helpful
#### Recommendations
**HIGH PRIORITY:**
1. Fix step count reference to match implementation (12 steps)
2. Update edit mode documentation to "Implemented"
**MEDIUM PRIORITY:**
3. Enhance PRD template with section structure
4. Add quick-start README for new users
**LOW PRIORITY:**
5. Add troubleshooting section
6. Document external dependencies (domain-complexity.csv, project-types.csv)
---
## 5. Integration & Compatibility Validation
### Integration Status: 85% Ready
#### ✅ Successfully Integrated Components
**1. Agent Menu Registration:**
- ✅ Registered in PM agent menu
- ✅ Trigger: `PR` or fuzzy match on `prd`
- ✅ Command: `/bmad:bmm:workflows:create-prd`
- ✅ Proper workflow path configuration
**2. External Workflow References:**
- ✅ Party-mode workflow: Exists at `/src/core/workflows/party-mode/workflow.md`
- ✅ Advanced-elicitation task: Exists at `/src/core/workflows/advanced-elicitation/workflow.xml`
**3. Directory Structure:**
- ✅ Complete step architecture (all 3 modes)
- ✅ All referenced step files exist
- ✅ Data files available
#### ✅ Configuration & Installation - WORKING AS DESIGNED
**1. BMM Config Reference:**
- Path: `{project-root}/_bmad/bmm/config.yaml`
- **Status:** ✅ Correct installation-time placeholder
- Resolves to actual config during workflow installation
- **Note:** This is expected behavior, not an issue
**2. Planning Artifacts Folder:**
- Reference: `{planning_artifacts}/prd.md`
- **Status:** ✅ Correct installation-time placeholder
- Created/resolved during workflow installation
- **Note:** This is expected behavior, not an issue
**3. Edit Mode Implementation:**
- Current: 5 steps (Discovery, Legacy Conversion branch, Review, Edit, Complete)
- **Status:** ✅ Functionally complete
- Edit mode is inherently simpler than create mode (targeted improvements vs full creation)
- Uses subprocesses for complex operations
- Validation integration ensures quality
- **Note:** Edit workflow is complete and well-designed
#### Configuration Analysis
**Placeholder Usage:**
- `{project-root}`: ✅ Properly used
- `{planning_artifacts}`: ⚠️ Referenced but folder missing
- `{nextStep}`, `{validateWorkflow}`, etc: ✅ Properly resolved
#### Recommendations
**✅ ALL CRITICAL ISSUES RESOLVED:**
The only true critical issue (edit workflow path) has been fixed. All other items flagged as "critical" were actually working as designed (installation-time placeholders).
**LOW PRIORITY:**
3. Add CLI command registration for standalone execution (optional enhancement)
4. Consider adding workflow to additional agent menus (UX designer, architect)
5. Create standalone execution documentation (nice-to-have)
6. Address step numbering gap if desired (cosmetic)
---
## 6. Executive Summary & Overall Assessment
### Overall Validation Status: ✅ PRODUCTION-READY
#### Validation Scores by Category
| Category | Status | Score | Notes |
|----------|--------|-------|-------|
| **File Structure & Size** | ⚠️ WARNINGS | 7/10 | 3 files exceed 250-line limit, 23 approaching |
| **Frontmatter Validation** | ✅ PASS | 9/10 | One broken path reference |
| **Step Content Quality** | ✅ EXCELLENT | 9.5/10 | High-quality instructional design |
| **Documentation** | ✅ EXCELLENT | 9/10 | Comprehensive, minor inconsistencies |
| **Integration** | ✅ PASS | 9/10 | All paths correct (one issue fixed) |
| **BMAD Compliance** | ✅ EXCELLENT | 9.5/10 | Strong adherence to standards |
**Overall Score: 9.2/10 - EXCELLENT**
#### ✅ Critical Action Items - ALL RESOLVED
**ONLY ONE TRUE CRITICAL ISSUE EXISTED - NOW FIXED:**
1. **✅ FIXED: Edit Workflow Path**
- File: `workflow.md` ✓ RESOLVED
- Changed from: `./steps-e/step-e-01-assess-workflow.md`
- Changed to: `./steps-e/step-e-01-discovery.md`
**Items incorrectly flagged as critical (actually working as designed):**
- ✅ Configuration path references (installation-time placeholders)
- ✅ Planning artifacts folder (installation-time placeholder)
#### High Priority Improvements
2. **⚠️ Split Large Step Files** (>250 lines):
- `step-v-09-project-type-validation.md` (263 lines)
- `step-v-11-holistic-quality-validation.md` (264 lines)
- `step-e-03-edit.md` (253 lines)
3. **⚠️ Update Documentation Inconsistencies**:
- Fix step count reference (11 → 12 steps in create mode)
- Update edit mode status (Future → Implemented)
#### Medium Priority Enhancements
4. **Enhance PRD Template** (currently minimal at 10 lines)
5. **Add quick-start README** for new users
6. **Address step numbering gap** (cosmetic - missing step-11-complete.md)
#### Edit Mode Status - FUNCTIONALLY COMPLETE ✅
The edit workflow is **complete and well-designed** with 5 steps:
- Discovery → Legacy Conversion (branch) → Review → Edit → Complete
- Edit mode is inherently simpler than create mode (targeted improvements vs full creation)
- Uses subprocesses for complex operations
- Integrates with validation workflow
**No additional steps needed.**
### Key Strengths
**Excellent step file quality** - Clear, well-structured instructions
**Comprehensive validation system** - 13 dedicated validation steps
**Strong BMAD compliance** - JIT loading, state tracking, sequential enforcement
**Tri-modal architecture** - Create, Validate, Edit all implemented
**Professional documentation** - Clear, consistent, well-presented
**Proper agent integration** - Registered in PM agent menu
### Areas for Improvement (Optional)
⚠️ **File size management** - Many files approaching limits (maintainability consideration)
⚠️ **Documentation consistency** - Minor discrepancies in counts/status (cosmetic)
**Edit mode** - Functionally complete, no additional steps needed
### Conclusion
The PRD workflow is **well-designed and fully compliant** with BMAD standards. The step file architecture is exemplary, the content quality is excellent, and the documentation is comprehensive. The only critical issue (edit workflow path) has been **resolved**, and all other flagged items were actually working as designed (installation-time placeholders).
**Current Status: ✅ PRODUCTION-READY**
**Recommended Optional Enhancements:**
1. Split the 3 files exceeding 250-line limit (maintainability)
2. Update documentation inconsistencies (step counts, edit mode status)
3. Enhance PRD template and add quick-start README (user experience)
The PRD workflow is ready for production use and fully compliant with BMAD workflow standards.
---
**Validation Completed:** 2026-01-08
**Validation Method:** Systematic subprocess analysis with maximum context coverage
**Validator:** BMAD Workflow Validation System (Wendy - Workflow Building Master)

View File

@@ -1,150 +0,0 @@
---
name: prd
description: PRD tri-modal workflow - Create, Validate, or Edit comprehensive PRDs
main_config: '{project-root}/_bmad/bmm/config.yaml'
nextStep: './steps-c/step-01-init.md'
validateWorkflow: './steps-v/step-v-01-discovery.md'
editWorkflow: './steps-e/step-e-01-discovery.md'
web_bundle: true
---
# PRD Workflow (Tri-Modal)
**Goal:** Create, Validate, or Edit comprehensive PRDs through structured workflows.
**Your Role:**
- **Create Mode:** Product-focused PM facilitator collaborating with an expert peer
- **Validate Mode:** Validation Architect and Quality Assurance Specialist
- **Edit Mode:** PRD improvement specialist
You will continue to operate with your given name, identity, and communication_style, merged with the details of this role description.
---
## MODE DETERMINATION
### Detect Workflow Mode
Determine which mode to invoke based on:
1. **Command/Invocation:**
- "create prd" or "new prd" → Create mode
- "validate prd" or "check prd" → Validate mode
- "edit prd" or "improve prd" → Edit mode
2. **Context Detection:**
- If invoked with -c flag → Create mode
- If invoked with -v flag → Validate mode
- If invoked with -e flag → Edit mode
3. **Menu Selection (if unclear):**
If mode cannot be determined from invocation:
"**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.
### Route to Appropriate Workflow
**IF Create Mode:**
"**Create Mode: Creating a new PRD from scratch.**"
Load, read entire file, then execute: `{nextStep}` (steps-c/step-01-init.md)
**IF Validate Mode:**
"**Validate Mode: Validating an existing PRD against BMAD standards.**"
Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file."
Then load, read entire file, and execute: `{validateWorkflow}` (steps-v/step-v-01-discovery.md)
**IF Edit Mode:**
"**Edit Mode: Improving an existing PRD.**"
Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file."
Then load, read entire file, and execute: `{editWorkflow}` (steps-e/step-e-01-discovery.md)
---
## WORKFLOW ARCHITECTURE
This uses **step-file architecture** for disciplined execution:
### Core Principles
- **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
- **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
- **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
- **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document
- **Append-Only Building**: Build documents by appending content as directed to the output file
### Step Processing Rules
1. **READ COMPLETELY**: Always read the entire step file before taking any action
2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
6. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
### Critical Rules (NO EXCEPTIONS)
- 🛑 **NEVER** load multiple step files simultaneously
- 📖 **ALWAYS** read entire step file before execution
- 🚫 **NEVER** skip steps or optimize the sequence
- 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
- 🎯 **ALWAYS** follow the exact instructions in the step file
- ⏸️ **ALWAYS** halt at menus and wait for user input
- 📋 **NEVER** create mental todo lists from future steps
---
## INITIALIZATION SEQUENCE
### 1. Mode Determination
**Check if mode was specified in the command invocation:**
- If user invoked with "create prd" or "new prd" or "build prd" or "-c" or "--create" → Set mode to **create**
- If user invoked with "validate prd" or "review prd" or "check prd" or "-v" or "--validate" → Set mode to **validate**
- If user invoked with "edit prd" or "modify prd" or "improve prd" or "-e" or "--edit" → Set mode to **edit**
**If mode is still unclear, ask user:**
"**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.
### 2. Configuration Loading
Load and read full config from {main_config} and resolve:
- `project_name`, `output_folder`, `planning_artifacts`, `user_name`
- `communication_language`, `document_output_language`, `user_skill_level`
- `date` as system-generated current datetime
✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`.
### 3. Route to Appropriate Workflow
**IF mode == create:**
"**Create Mode: Creating a new PRD from scratch.**"
Load, read entire file, then execute `{nextStep}` (steps-c/step-01-init.md)
**IF mode == validate:**
"**Validate Mode: Validating an existing PRD against BMAD standards.**"
Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file."
Then load, read entire file, and execute `{validateWorkflow}` (steps-v/step-v-01-discovery.md)
**IF mode == edit:**
"**Edit Mode: Improving an existing PRD.**"
Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file."
Then load, read entire file, and execute `{editWorkflow}` (steps-e/step-e-01-discovery.md)