bmad-method 6.2.3-next.6 → 6.2.3-next.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/.claude-plugin/marketplace.json +0 -1
  2. package/package.json +1 -1
  3. package/src/bmm-skills/1-analysis/bmad-agent-analyst/SKILL.md +6 -4
  4. package/src/bmm-skills/1-analysis/bmad-agent-tech-writer/SKILL.md +6 -4
  5. package/src/bmm-skills/1-analysis/bmad-document-project/workflow.md +8 -10
  6. package/src/bmm-skills/1-analysis/bmad-prfaq/SKILL.md +12 -9
  7. package/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md +1 -6
  8. package/src/bmm-skills/1-analysis/research/bmad-domain-research/workflow.md +8 -6
  9. package/src/bmm-skills/1-analysis/research/bmad-market-research/workflow.md +8 -6
  10. package/src/bmm-skills/1-analysis/research/bmad-technical-research/workflow.md +8 -6
  11. package/src/bmm-skills/2-plan-workflows/bmad-agent-pm/SKILL.md +6 -4
  12. package/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/SKILL.md +6 -4
  13. package/src/bmm-skills/2-plan-workflows/bmad-create-prd/workflow.md +8 -9
  14. package/src/bmm-skills/2-plan-workflows/bmad-create-ux-design/workflow.md +8 -9
  15. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +1 -1
  16. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +1 -1
  17. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +1 -1
  18. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +1 -1
  19. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +1 -1
  20. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/workflow.md +8 -9
  21. package/src/bmm-skills/2-plan-workflows/bmad-validate-prd/workflow.md +8 -9
  22. package/src/bmm-skills/3-solutioning/bmad-agent-architect/SKILL.md +6 -4
  23. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/workflow.md +8 -10
  24. package/src/bmm-skills/3-solutioning/bmad-create-architecture/workflow.md +8 -14
  25. package/src/bmm-skills/3-solutioning/bmad-create-epics-and-stories/workflow.md +10 -12
  26. package/src/bmm-skills/3-solutioning/bmad-generate-project-context/workflow.md +8 -12
  27. package/src/bmm-skills/4-implementation/bmad-agent-dev/SKILL.md +6 -4
  28. package/src/bmm-skills/4-implementation/bmad-agent-qa/SKILL.md +6 -4
  29. package/src/bmm-skills/4-implementation/bmad-agent-quick-flow-solo-dev/SKILL.md +6 -4
  30. package/src/bmm-skills/4-implementation/bmad-agent-sm/SKILL.md +6 -4
  31. package/src/core-skills/bmad-advanced-elicitation/SKILL.md +1 -2
  32. package/src/core-skills/bmad-distillator/SKILL.md +0 -1
  33. package/src/core-skills/bmad-distillator/resources/distillate-format-reference.md +9 -9
  34. package/src/core-skills/bmad-party-mode/workflow.md +5 -12
  35. package/tools/installer/ide/platform-codes.yaml +0 -1
  36. package/src/bmm-skills/2-plan-workflows/create-prd/data/domain-complexity.csv +0 -15
  37. package/src/bmm-skills/2-plan-workflows/create-prd/data/prd-purpose.md +0 -197
  38. package/src/bmm-skills/2-plan-workflows/create-prd/data/project-types.csv +0 -11
  39. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +0 -224
  40. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md +0 -191
  41. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md +0 -209
  42. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md +0 -174
  43. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md +0 -214
  44. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md +0 -228
  45. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md +0 -217
  46. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md +0 -205
  47. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md +0 -243
  48. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md +0 -263
  49. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md +0 -209
  50. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +0 -264
  51. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md +0 -242
  52. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +0 -232
  53. package/src/bmm-skills/2-plan-workflows/create-prd/workflow-validate-prd.md +0 -65
  54. package/src/core-skills/bmad-init/SKILL.md +0 -100
  55. package/src/core-skills/bmad-init/resources/core-module.yaml +0 -25
  56. package/src/core-skills/bmad-init/scripts/bmad_init.py +0 -624
  57. package/src/core-skills/bmad-init/scripts/tests/test_bmad_init.py +0 -393
@@ -1,242 +0,0 @@
1
- ---
2
- name: 'step-v-12-completeness-validation'
3
- description: 'Completeness Check - Final comprehensive completeness check before report generation'
4
-
5
- # File references (ONLY variables used in this step)
6
- nextStepFile: './step-v-13-report-complete.md'
7
- prdFile: '{prd_file_path}'
8
- prdFrontmatter: '{prd_frontmatter}'
9
- validationReportPath: '{validation_report_path}'
10
- ---
11
-
12
- # Step 12: Completeness Validation
13
-
14
- ## STEP GOAL:
15
-
16
- Final comprehensive completeness check - validate no template variables remain, each section has required content, section-specific completeness, and frontmatter is properly populated.
17
-
18
- ## MANDATORY EXECUTION RULES (READ FIRST):
19
-
20
- ### Universal Rules:
21
-
22
- - 🛑 NEVER generate content without user input
23
- - 📖 CRITICAL: Read the complete step file before taking any action
24
- - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
25
- - 📋 YOU ARE A FACILITATOR, not a content generator
26
- - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
27
-
28
- ### Role Reinforcement:
29
-
30
- - ✅ You are a Validation Architect and Quality Assurance Specialist
31
- - ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
32
- - ✅ We engage in systematic validation, not collaborative dialogue
33
- - ✅ You bring attention to detail and completeness verification
34
- - ✅ This step runs autonomously - no user input needed
35
-
36
- ### Step-Specific Rules:
37
-
38
- - 🎯 Focus ONLY on completeness verification
39
- - 🚫 FORBIDDEN to validate quality (done in step 11) or other aspects
40
- - 💬 Approach: Systematic checklist-style verification
41
- - 🚪 This is a validation sequence step - auto-proceeds when complete
42
-
43
- ## EXECUTION PROTOCOLS:
44
-
45
- - 🎯 Check template completeness (no variables remaining)
46
- - 🎯 Validate content completeness (each section has required content)
47
- - 🎯 Validate section-specific completeness
48
- - 🎯 Validate frontmatter completeness
49
- - 💾 Append completeness matrix to validation report
50
- - 📖 Display "Proceeding to final step..." and load next step
51
- - 🚫 FORBIDDEN to pause or request user input
52
-
53
- ## CONTEXT BOUNDARIES:
54
-
55
- - Available context: Complete PRD file, frontmatter, validation report
56
- - Focus: Completeness verification only (final gate)
57
- - Limits: Don't assess quality, don't pause for user input
58
- - Dependencies: Steps 1-11 completed - all validation checks done
59
-
60
- ## MANDATORY SEQUENCE
61
-
62
- **CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
63
-
64
- ### 1. Attempt Sub-Process Validation
65
-
66
- **Try to use Task tool to spawn a subprocess:**
67
-
68
- "Perform completeness validation on this PRD - final gate check:
69
-
70
- **1. Template Completeness:**
71
- - Scan PRD for any remaining template variables
72
- - Look for: {variable}, {{variable}}, {placeholder}, [placeholder], etc.
73
- - List any found with line numbers
74
-
75
- **2. Content Completeness:**
76
- - Executive Summary: Has vision statement? ({key content})
77
- - Success Criteria: All criteria measurable? ({metrics present})
78
- - Product Scope: In-scope and out-of-scope defined? ({both present})
79
- - User Journeys: User types identified? ({users listed})
80
- - Functional Requirements: FRs listed with proper format? ({FRs present})
81
- - Non-Functional Requirements: NFRs with metrics? ({NFRs present})
82
-
83
- For each section: Is required content present? (Yes/No/Partial)
84
-
85
- **3. Section-Specific Completeness:**
86
- - Success Criteria: Each has specific measurement method?
87
- - User Journeys: Cover all user types?
88
- - Functional Requirements: Cover MVP scope?
89
- - Non-Functional Requirements: Each has specific criteria?
90
-
91
- **4. Frontmatter Completeness:**
92
- - stepsCompleted: Populated?
93
- - classification: Present (domain, projectType)?
94
- - inputDocuments: Tracked?
95
- - date: Present?
96
-
97
- Return completeness matrix with status for each check."
98
-
99
- **Graceful degradation (if no Task tool):**
100
- - Manually scan for template variables
101
- - Manually check each section for required content
102
- - Manually verify frontmatter fields
103
- - Build completeness matrix
104
-
105
- ### 2. Build Completeness Matrix
106
-
107
- **Template Completeness:**
108
- - Template variables found: count
109
- - List if any found
110
-
111
- **Content Completeness by Section:**
112
- - Executive Summary: Complete / Incomplete / Missing
113
- - Success Criteria: Complete / Incomplete / Missing
114
- - Product Scope: Complete / Incomplete / Missing
115
- - User Journeys: Complete / Incomplete / Missing
116
- - Functional Requirements: Complete / Incomplete / Missing
117
- - Non-Functional Requirements: Complete / Incomplete / Missing
118
- - Other sections: [List completeness]
119
-
120
- **Section-Specific Completeness:**
121
- - Success criteria measurable: All / Some / None
122
- - Journeys cover all users: Yes / Partial / No
123
- - FRs cover MVP scope: Yes / Partial / No
124
- - NFRs have specific criteria: All / Some / None
125
-
126
- **Frontmatter Completeness:**
127
- - stepsCompleted: Present / Missing
128
- - classification: Present / Missing
129
- - inputDocuments: Present / Missing
130
- - date: Present / Missing
131
-
132
- **Overall completeness:**
133
- - Sections complete: X/Y
134
- - Critical gaps: [list if any]
135
-
136
- ### 3. Report Completeness Findings to Validation Report
137
-
138
- Append to validation report:
139
-
140
- ```markdown
141
- ## Completeness Validation
142
-
143
- ### Template Completeness
144
-
145
- **Template Variables Found:** {count}
146
- {If count > 0, list variables with line numbers}
147
- {If count = 0, note: No template variables remaining ✓}
148
-
149
- ### Content Completeness by Section
150
-
151
- **Executive Summary:** [Complete/Incomplete/Missing]
152
- {If incomplete or missing, note specific gaps}
153
-
154
- **Success Criteria:** [Complete/Incomplete/Missing]
155
- {If incomplete or missing, note specific gaps}
156
-
157
- **Product Scope:** [Complete/Incomplete/Missing]
158
- {If incomplete or missing, note specific gaps}
159
-
160
- **User Journeys:** [Complete/Incomplete/Missing]
161
- {If incomplete or missing, note specific gaps}
162
-
163
- **Functional Requirements:** [Complete/Incomplete/Missing]
164
- {If incomplete or missing, note specific gaps}
165
-
166
- **Non-Functional Requirements:** [Complete/Incomplete/Missing]
167
- {If incomplete or missing, note specific gaps}
168
-
169
- ### Section-Specific Completeness
170
-
171
- **Success Criteria Measurability:** [All/Some/None] measurable
172
- {If Some or None, note which criteria lack metrics}
173
-
174
- **User Journeys Coverage:** [Yes/Partial/No] - covers all user types
175
- {If Partial or No, note missing user types}
176
-
177
- **FRs Cover MVP Scope:** [Yes/Partial/No]
178
- {If Partial or No, note scope gaps}
179
-
180
- **NFRs Have Specific Criteria:** [All/Some/None]
181
- {If Some or None, note which NFRs lack specificity}
182
-
183
- ### Frontmatter Completeness
184
-
185
- **stepsCompleted:** [Present/Missing]
186
- **classification:** [Present/Missing]
187
- **inputDocuments:** [Present/Missing]
188
- **date:** [Present/Missing]
189
-
190
- **Frontmatter Completeness:** {complete_fields}/4
191
-
192
- ### Completeness Summary
193
-
194
- **Overall Completeness:** {percentage}% ({complete_sections}/{total_sections})
195
-
196
- **Critical Gaps:** [count] [list if any]
197
- **Minor Gaps:** [count] [list if any]
198
-
199
- **Severity:** [Critical if template variables exist or critical sections missing, Warning if minor gaps, Pass if complete]
200
-
201
- **Recommendation:**
202
- [If Critical] "PRD has completeness gaps that must be addressed before use. Fix template variables and complete missing sections."
203
- [If Warning] "PRD has minor completeness gaps. Address minor gaps for complete documentation."
204
- [If Pass] "PRD is complete with all required sections and content present."
205
- ```
206
-
207
- ### 4. Display Progress and Auto-Proceed
208
-
209
- Display: "**Completeness Validation Complete**
210
-
211
- Overall Completeness: {percentage}% ({severity})
212
-
213
- **Proceeding to final step...**"
214
-
215
- Without delay, read fully and follow: {nextStepFile} (step-v-13-report-complete.md)
216
-
217
- ---
218
-
219
- ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
220
-
221
- ### ✅ SUCCESS:
222
-
223
- - Scanned for template variables systematically
224
- - Validated each section for required content
225
- - Validated section-specific completeness (measurability, coverage, scope)
226
- - Validated frontmatter completeness
227
- - Completeness matrix built with all checks
228
- - Severity assessed correctly
229
- - Findings reported to validation report
230
- - Auto-proceeds to final step
231
- - Subprocess attempted with graceful degradation
232
-
233
- ### ❌ SYSTEM FAILURE:
234
-
235
- - Not scanning for template variables
236
- - Missing section-specific completeness checks
237
- - Not validating frontmatter
238
- - Not building completeness matrix
239
- - Not reporting findings to validation report
240
- - Not auto-proceeding
241
-
242
- **Master Rule:** Final gate to ensure document is complete before presenting findings. Template variables or critical gaps must be fixed.
@@ -1,232 +0,0 @@
1
- ---
2
- name: 'step-v-13-report-complete'
3
- description: 'Validation Report Complete - Finalize report, summarize findings, present to user, offer next steps'
4
-
5
- # File references (ONLY variables used in this step)
6
- validationReportPath: '{validation_report_path}'
7
- prdFile: '{prd_file_path}'
8
- ---
9
-
10
- # Step 13: Validation Report Complete
11
-
12
- ## STEP GOAL:
13
-
14
- Finalize validation report, summarize all findings from steps 1-12, present summary to user conversationally, and offer actionable next steps.
15
-
16
- ## MANDATORY EXECUTION RULES (READ FIRST):
17
-
18
- ### Universal Rules:
19
-
20
- - 🛑 NEVER generate content without user input
21
- - 📖 CRITICAL: Read the complete step file before taking any action
22
- - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
23
- - 📋 YOU ARE A FACILITATOR, not a content generator
24
- - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
25
- - ✅ YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`
26
-
27
- ### Role Reinforcement:
28
-
29
- - ✅ You are a Validation Architect and Quality Assurance Specialist
30
- - ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
31
- - ✅ We engage in collaborative dialogue, not command-response
32
- - ✅ You bring synthesis and summary expertise
33
- - ✅ This is the FINAL step - requires user interaction
34
-
35
- ### Step-Specific Rules:
36
-
37
- - 🎯 Focus ONLY on summarizing findings and presenting options
38
- - 🚫 FORBIDDEN to perform additional validation
39
- - 💬 Approach: Conversational summary with clear next steps
40
- - 🚪 This is the final step - no next step after this
41
-
42
- ## EXECUTION PROTOCOLS:
43
-
44
- - 🎯 Load complete validation report
45
- - 🎯 Summarize all findings from steps 1-12
46
- - 🎯 Update report frontmatter with final status
47
- - 💬 Present summary to user conversationally
48
- - 💬 Offer menu options for next actions
49
- - 🚫 FORBIDDEN to proceed without user selection
50
-
51
- ## CONTEXT BOUNDARIES:
52
-
53
- - Available context: Complete validation report with findings from all validation steps
54
- - Focus: Summary and presentation only (no new validation)
55
- - Limits: Don't add new findings, just synthesize existing
56
- - Dependencies: Steps 1-12 completed - all validation checks done
57
-
58
- ## MANDATORY SEQUENCE
59
-
60
- **CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
61
-
62
- ### 1. Load Complete Validation Report
63
-
64
- Read the entire validation report from {validationReportPath}
65
-
66
- Extract all findings from:
67
- - Format Detection (Step 2)
68
- - Parity Analysis (Step 2B, if applicable)
69
- - Information Density (Step 3)
70
- - Product Brief Coverage (Step 4)
71
- - Measurability (Step 5)
72
- - Traceability (Step 6)
73
- - Implementation Leakage (Step 7)
74
- - Domain Compliance (Step 8)
75
- - Project-Type Compliance (Step 9)
76
- - SMART Requirements (Step 10)
77
- - Holistic Quality (Step 11)
78
- - Completeness (Step 12)
79
-
80
- ### 2. Update Report Frontmatter with Final Status
81
-
82
- Update validation report frontmatter:
83
-
84
- ```yaml
85
- ---
86
- validationTarget: '{prd_path}'
87
- validationDate: '{current_date}'
88
- inputDocuments: [list of documents]
89
- validationStepsCompleted: ['step-v-01-discovery', 'step-v-02-format-detection', 'step-v-03-density-validation', 'step-v-04-brief-coverage-validation', 'step-v-05-measurability-validation', 'step-v-06-traceability-validation', 'step-v-07-implementation-leakage-validation', 'step-v-08-domain-compliance-validation', 'step-v-09-project-type-validation', 'step-v-10-smart-validation', 'step-v-11-holistic-quality-validation', 'step-v-12-completeness-validation']
90
- validationStatus: COMPLETE
91
- holisticQualityRating: '{rating from step 11}'
92
- overallStatus: '{Pass/Warning/Critical based on all findings}'
93
- ---
94
- ```
95
-
96
- ### 3. Create Summary of Findings
97
-
98
- **Overall Status:**
99
- - Determine from all validation findings
100
- - **Pass:** All critical checks pass, minor warnings acceptable
101
- - **Warning:** Some issues found but PRD is usable
102
- - **Critical:** Major issues that prevent PRD from being fit for purpose
103
-
104
- **Quick Results Table:**
105
- - Format: [classification]
106
- - Information Density: [severity]
107
- - Measurability: [severity]
108
- - Traceability: [severity]
109
- - Implementation Leakage: [severity]
110
- - Domain Compliance: [status]
111
- - Project-Type Compliance: [compliance score]
112
- - SMART Quality: [percentage]
113
- - Holistic Quality: [rating/5]
114
- - Completeness: [percentage]
115
-
116
- **Critical Issues:** List from all validation steps
117
- **Warnings:** List from all validation steps
118
- **Strengths:** List positives from all validation steps
119
-
120
- **Holistic Quality Rating:** From step 11
121
- **Top 3 Improvements:** From step 11
122
-
123
- **Recommendation:** Based on overall status
124
-
125
- ### 4. Present Summary to User Conversationally
126
-
127
- Display:
128
-
129
- "**✓ PRD Validation Complete**
130
-
131
- **Overall Status:** {Pass/Warning/Critical}
132
-
133
- **Quick Results:**
134
- {Present quick results table with key findings}
135
-
136
- **Critical Issues:** {count or "None"}
137
- {If any, list briefly}
138
-
139
- **Warnings:** {count or "None"}
140
- {If any, list briefly}
141
-
142
- **Strengths:**
143
- {List key strengths}
144
-
145
- **Holistic Quality:** {rating}/5 - {label}
146
-
147
- **Top 3 Improvements:**
148
- 1. {Improvement 1}
149
- 2. {Improvement 2}
150
- 3. {Improvement 3}
151
-
152
- **Recommendation:**
153
- {Based on overall status:
154
- - Pass: "PRD is in good shape. Address minor improvements to make it great."
155
- - Warning: "PRD is usable but has issues that should be addressed. Review warnings and improve where needed."
156
- - Critical: "PRD has significant issues that should be fixed before use. Focus on critical issues above."}
157
-
158
- **What would you like to do next?**"
159
-
160
- ### 5. Present MENU OPTIONS
161
-
162
- Display:
163
-
164
- **[R] Review Detailed Findings** - Walk through validation report section by section
165
- **[E] Use Edit Workflow** - Use validation report with Edit workflow for systematic improvements
166
- **[F] Fix Simpler Items** - Immediate fixes for simple issues (anti-patterns, leakage, missing headers)
167
- **[X] Exit** - Exit and Suggest Next Steps.
168
-
169
- #### EXECUTION RULES:
170
-
171
- - ALWAYS halt and wait for user input after presenting menu
172
- - Only proceed based on user selection
173
-
174
- #### Menu Handling Logic:
175
-
176
- - **IF R (Review Detailed Findings):**
177
- - Walk through validation report section by section
178
- - Present findings from each validation step
179
- - Allow user to ask questions
180
- - After review, return to menu
181
-
182
- - **IF E (Use Edit Workflow):**
183
- - 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."
184
- - Offer: "Would you like to launch Edit mode now? It will help you fix validation findings systematically."
185
- - If yes: Read fully and follow: `./steps-e/step-e-01-discovery.md`
186
- - If no: Return to menu
187
-
188
- - **IF F (Fix Simpler Items):**
189
- - Offer immediate fixes for:
190
- - Template variables (fill in with appropriate content)
191
- - Conversational filler (remove wordy phrases)
192
- - Implementation leakage (remove technology names from FRs/NFRs)
193
- - Missing section headers (add ## headers)
194
- - Ask: "Which simple fixes would you like me to make?"
195
- - If user specifies fixes, make them and update validation report
196
- - Return to menu
197
-
198
- - **IF X (Exit):**
199
- - Display: "**Validation Report Saved:** {validationReportPath}"
200
- - Display: "**Summary:** {overall status} - {recommendation}"
201
- - PRD Validation complete. Invoke the `bmad-help` skill.
202
-
203
- - **IF Any other:** Help user, then redisplay menu
204
-
205
- ---
206
-
207
- ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
208
-
209
- ### ✅ SUCCESS:
210
-
211
- - Complete validation report loaded successfully
212
- - All findings from steps 1-12 summarized
213
- - Report frontmatter updated with final status
214
- - Overall status determined correctly (Pass/Warning/Critical)
215
- - Quick results table presented
216
- - Critical issues, warnings, and strengths listed
217
- - Holistic quality rating included
218
- - Top 3 improvements presented
219
- - Clear recommendation provided
220
- - Menu options presented with clear explanations
221
- - User can review findings, get help, or exit
222
-
223
- ### ❌ SYSTEM FAILURE:
224
-
225
- - Not loading complete validation report
226
- - Missing summary of findings
227
- - Not updating report frontmatter
228
- - Not determining overall status
229
- - Missing menu options
230
- - Unclear next steps
231
-
232
- **Master Rule:** User needs clear summary and actionable next steps. Edit workflow is best for complex issues; immediate fixes available for simpler ones.
@@ -1,65 +0,0 @@
1
- ---
2
- name: validate-prd
3
- description: 'Validate a PRD against standards. Use when the user says "validate this PRD" or "run PRD validation"'
4
- standalone: false
5
- main_config: '{project-root}/_bmad/bmm/config.yaml'
6
- validateWorkflow: './steps-v/step-v-01-discovery.md'
7
- ---
8
-
9
- # PRD Validate Workflow
10
-
11
- **Goal:** Validate existing PRDs against BMAD standards through comprehensive review.
12
-
13
- **Your Role:** Validation Architect and Quality Assurance Specialist.
14
-
15
- You will continue to operate with your given name, identity, and communication_style, merged with the details of this role description.
16
-
17
- ## WORKFLOW ARCHITECTURE
18
-
19
- This uses **step-file architecture** for disciplined execution:
20
-
21
- ### Core Principles
22
-
23
- - **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
24
- - **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
25
- - **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
26
- - **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document
27
- - **Append-Only Building**: Build documents by appending content as directed to the output file
28
-
29
- ### Step Processing Rules
30
-
31
- 1. **READ COMPLETELY**: Always read the entire step file before taking any action
32
- 2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
33
- 3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
34
- 4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
35
- 5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
36
- 6. **LOAD NEXT**: When directed, read fully and follow the next step file
37
-
38
- ### Critical Rules (NO EXCEPTIONS)
39
-
40
- - 🛑 **NEVER** load multiple step files simultaneously
41
- - 📖 **ALWAYS** read entire step file before execution
42
- - 🚫 **NEVER** skip steps or optimize the sequence
43
- - 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
44
- - 🎯 **ALWAYS** follow the exact instructions in the step file
45
- - ⏸️ **ALWAYS** halt at menus and wait for user input
46
- - 📋 **NEVER** create mental todo lists from future steps
47
-
48
- ## INITIALIZATION SEQUENCE
49
-
50
- ### 1. Configuration Loading
51
-
52
- Load and read full config from {main_config} and resolve:
53
-
54
- - `project_name`, `output_folder`, `planning_artifacts`, `user_name`
55
- - `communication_language`, `document_output_language`, `user_skill_level`
56
- - `date` as system-generated current datetime
57
-
58
- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`.
59
- ✅ YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`.
60
-
61
- ### 2. Route to Validate Workflow
62
-
63
- "**Validate Mode: Validating an existing PRD against BMAD standards.**"
64
-
65
- Then read fully and follow: `{validateWorkflow}` (steps-v/step-v-01-discovery.md)
@@ -1,100 +0,0 @@
1
- ---
2
- name: bmad-init
3
- description: "Initialize BMad project configuration and load config variables. Use when any skill needs module-specific configuration values, or when setting up a new BMad project."
4
- argument-hint: "[--module=module_code] [--vars=var1:default1,var2] [--skill-path=/path/to/calling/skill]"
5
- ---
6
-
7
- ## Overview
8
-
9
- This skill is the configuration entry point for all BMad skills. It has two modes:
10
-
11
- - **Fast path**: Config exists for the requested module — returns vars as JSON. Done.
12
- - **Init path**: Config is missing — walks the user through configuration, writes config files, then returns vars.
13
-
14
- Every BMad skill should call this on activation to get its config vars. The caller never needs to know whether init happened — they just get their config back.
15
-
16
- The script `bmad_init.py` is located in this skill's `scripts/` directory. Locate and run it using python for all commands below.
17
-
18
- ## On Activation — Fast Path
19
-
20
- Run the `bmad_init.py` script with the `load` subcommand. Pass `--project-root` set to the project root directory.
21
-
22
- - If a module code was provided by the calling skill, include `--module {module_code}`
23
- - To load all vars, include `--all`
24
- - To request specific variables with defaults, use `--vars var1:default1,var2`
25
- - If no module was specified, omit `--module` to get core vars only
26
-
27
- **If the script returns JSON vars** — store them as `{var-name}` and return to the calling skill. Done.
28
-
29
- **If the script returns an error or `init_required`** — proceed to the Init Path below.
30
-
31
- ## Init Path — First-Time Setup
32
-
33
- When the fast path fails (config missing for a module), run this init flow.
34
-
35
- ### Step 1: Check what needs setup
36
-
37
- Run `bmad_init.py` with the `check` subcommand, passing `--module {module_code}`, `--skill-path {calling_skill_path}`, and `--project-root`.
38
-
39
- The response tells you what's needed:
40
-
41
- - `"status": "ready"` — Config is fine. Re-run load.
42
- - `"status": "no_project"` — Can't find project root. Ask user to confirm the project path.
43
- - `"status": "core_missing"` — Core config doesn't exist. Must ask core questions first.
44
- - `"status": "module_missing"` — Core exists but module config doesn't. Ask module questions.
45
-
46
- The response includes:
47
- - `core_module` — Core module.yaml questions (when core setup needed)
48
- - `target_module` — Target module.yaml questions (when module setup needed, discovered from `--skill-path` or `_bmad/{module}/`)
49
- - `core_vars` — Existing core config values (when core exists but module doesn't)
50
-
51
- ### Step 2: Ask core questions (if `core_missing`)
52
-
53
- The check response includes `core_module` with header, subheader, and variable definitions.
54
-
55
- 1. Show the `header` and `subheader` to the user
56
- 2. For each variable, present the `prompt` and `default`
57
- 3. For variables with `single-select`, show the options as a numbered list
58
- 4. For variables with multi-line `prompt` (array), show all lines
59
- 5. Let the user accept defaults or provide values
60
-
61
- ### Step 3: Ask module questions (if module was requested)
62
-
63
- The check response includes `target_module` with the module's questions. Variables may reference core answers in their defaults (e.g., `{output_folder}`).
64
-
65
- 1. Resolve defaults by running `bmad_init.py` with the `resolve-defaults` subcommand, passing `--module {module_code}`, `--core-answers '{core_answers_json}'`, and `--project-root`
66
- 2. Show the module's `header` and `subheader`
67
- 3. For each variable, present the prompt with resolved default
68
- 4. For `single-select` variables, show options as a numbered list
69
-
70
- ### Step 4: Write config
71
-
72
- Collect all answers and run `bmad_init.py` with the `write` subcommand, passing `--answers '{all_answers_json}'` and `--project-root`.
73
-
74
- The `--answers` JSON format:
75
-
76
- ```json
77
- {
78
- "core": {
79
- "user_name": "BMad",
80
- "communication_language": "English",
81
- "document_output_language": "English",
82
- "output_folder": "_bmad-output"
83
- },
84
- "bmb": {
85
- "bmad_builder_output_folder": "_bmad-output/skills",
86
- "bmad_builder_reports": "_bmad-output/reports"
87
- }
88
- }
89
- ```
90
-
91
- Note: Pass the **raw user answers** (before result template expansion). The script applies result templates and `{project-root}` expansion when writing.
92
-
93
- The script:
94
- - Creates `_bmad/core/config.yaml` with core values (if core answers provided)
95
- - Creates `_bmad/{module}/config.yaml` with core values + module values (result-expanded)
96
- - Creates any directories listed in the module.yaml `directories` array
97
-
98
- ### Step 5: Return vars
99
-
100
- After writing, re-run `bmad_init.py` with the `load` subcommand (same as the fast path) to return resolved vars. Store returned vars as `{var-name}` and return them to the calling skill.
@@ -1,25 +0,0 @@
1
- code: core
2
- name: "BMad Core Module"
3
-
4
- header: "BMad Core Configuration"
5
- subheader: "Configure the core settings for your BMad installation.\nThese settings will be used across all installed bmad skills, workflows, and agents."
6
-
7
- user_name:
8
- prompt: "What should agents call you? (Use your name or a team name)"
9
- default: "BMad"
10
- result: "{value}"
11
-
12
- communication_language:
13
- prompt: "What language should agents use when chatting with you?"
14
- default: "English"
15
- result: "{value}"
16
-
17
- document_output_language:
18
- prompt: "Preferred document output language?"
19
- default: "English"
20
- result: "{value}"
21
-
22
- output_folder:
23
- prompt: "Where should output files be saved?"
24
- default: "_bmad-output"
25
- result: "{project-root}/{value}"