bmad-method 6.1.1-next.40 → 6.1.1-next.41

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 (22) hide show
  1. package/package.json +1 -1
  2. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-02-vision.md +2 -5
  3. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-03-users.md +2 -5
  4. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-04-metrics.md +2 -5
  5. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-05-scope.md +2 -5
  6. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +0 -2
  7. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +2 -3
  8. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md +2 -4
  9. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-11-holistic-quality-validation.md +2 -3
  10. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +2 -4
  11. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +2 -3
  12. package/src/bmm/workflows/bmad-generate-project-context/steps/step-02-generate.md +4 -4
  13. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-01-mode-detection.md +3 -3
  14. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/workflow.md +0 -6
  15. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md +2 -2
  16. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-02-investigate.md +2 -2
  17. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-04-review.md +4 -4
  18. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/workflow.md +0 -3
  19. package/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md +2 -2
  20. package/src/core/skills/bmad-brainstorming/workflow.md +0 -2
  21. package/src/core/tasks/bmad-create-prd/steps-c/step-05-domain.md +1 -1
  22. package/tools/skill-validator.md +8 -0
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-method",
4
- "version": "6.1.1-next.40",
4
+ "version": "6.1.1-next.41",
5
5
  "description": "Breakthrough Method of Agile AI-driven Development",
6
6
  "keywords": [
7
7
  "agile",
package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-02-vision.md CHANGED
@@ -2,9 +2,6 @@
2
2
  # File References
3
3
  outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
4
 
5
- # Task References
6
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
7
- partyModeWorkflow: 'skill:bmad-party-mode'
8
5
  ---
9
6
 
10
7
  # Step 2: Product Vision Discovery
@@ -153,8 +150,8 @@ Prepare the following structure for document append:
153
150
 
154
151
  #### Menu Handling Logic:
155
152
 
156
- - IF A: Read fully and follow: {advancedElicitationTask} with current vision content to dive deeper and refine
157
- - IF P: Read fully and follow: {partyModeWorkflow} to bring different perspectives to positioning and differentiation
153
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current vision content to dive deeper and refine
154
+ - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to positioning and differentiation
158
155
  - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2], then read fully and follow: ./step-03-users.md
159
156
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
160
157
 
package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-03-users.md CHANGED
@@ -2,9 +2,6 @@
2
2
  # File References
3
3
  outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
4
 
5
- # Task References
6
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
7
- partyModeWorkflow: 'skill:bmad-party-mode'
8
5
  ---
9
6
 
10
7
  # Step 3: Target Users Discovery
@@ -156,8 +153,8 @@ Prepare the following structure for document append:
156
153
 
157
154
  #### Menu Handling Logic:
158
155
 
159
- - IF A: Read fully and follow: {advancedElicitationTask} with current user content to dive deeper into personas and journeys
160
- - IF P: Read fully and follow: {partyModeWorkflow} to bring different perspectives to validate user understanding
156
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current user content to dive deeper into personas and journeys
157
+ - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to validate user understanding
161
158
  - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2, 3], then read fully and follow: ./step-04-metrics.md
162
159
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-present-menu-options)
163
160
 
package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-04-metrics.md CHANGED
@@ -2,9 +2,6 @@
2
2
  # File References
3
3
  outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
4
 
5
- # Task References
6
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
7
- partyModeWorkflow: 'skill:bmad-party-mode'
8
5
  ---
9
6
 
10
7
  # Step 4: Success Metrics Definition
@@ -159,8 +156,8 @@ Prepare the following structure for document append:
159
156
 
160
157
  #### Menu Handling Logic:
161
158
 
162
- - IF A: Read fully and follow: {advancedElicitationTask} with current metrics content to dive deeper into success metric insights
163
- - IF P: Read fully and follow: {partyModeWorkflow} to bring different perspectives to validate comprehensive metrics
159
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current metrics content to dive deeper into success metric insights
160
+ - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to validate comprehensive metrics
164
161
  - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2, 3, 4], then read fully and follow: ./step-05-scope.md
165
162
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
166
163
 
package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-05-scope.md CHANGED
@@ -2,9 +2,6 @@
2
2
  # File References
3
3
  outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
4
 
5
- # Task References
6
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
7
- partyModeWorkflow: 'skill:bmad-party-mode'
8
5
  ---
9
6
 
10
7
  # Step 5: MVP Scope Definition
@@ -173,8 +170,8 @@ Prepare the following structure for document append:
173
170
 
174
171
  #### Menu Handling Logic:
175
172
 
176
- - IF A: Read fully and follow: {advancedElicitationTask} with current scope content to optimize scope definition
177
- - IF P: Read fully and follow: {partyModeWorkflow} to bring different perspectives to validate MVP scope
173
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current scope content to optimize scope definition
174
+ - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to validate MVP scope
178
175
  - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2, 3, 4, 5], then read fully and follow: ./step-06-complete.md
179
176
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
180
177
 
package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md CHANGED
@@ -5,8 +5,6 @@ description: 'Discovery & Understanding - Understand what user wants to edit and
5
5
  # File references (ONLY variables used in this step)
6
6
  altStepFile: './step-e-01b-legacy-conversion.md'
7
7
  prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
8
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
9
- partyModeWorkflow: 'skill:bmad-party-mode'
10
8
  ---
11
9
 
12
10
  # Step E-1: Discovery & Understanding
package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md CHANGED
@@ -7,7 +7,6 @@ nextStepFile: './step-e-03-edit.md'
7
7
  prdFile: '{prd_file_path}'
8
8
  validationReport: '{validation_report_path}' # If provided
9
9
  prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
10
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
11
10
  ---
12
11
 
13
12
  # Step E-2: Deep Review & Analysis
@@ -220,8 +219,8 @@ Read fully and follow: {nextStepFile} (step-e-03-edit.md)
220
219
 
221
220
  #### Menu Handling Logic:
222
221
 
223
- - IF A: Read fully and follow: {advancedElicitationTask}, then return to discussion
224
- - IF P: Read fully and follow: {partyModeWorkflow}, then return to discussion
222
+ - IF A: Invoke the `bmad-advanced-elicitation` skill, then return to discussion
223
+ - IF P: Invoke the `bmad-party-mode` skill, then return to discussion
225
224
  - IF C: Document approval, then load {nextStepFile}
226
225
  - IF Any other: discuss, then redisplay menu
227
226
 
package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md CHANGED
@@ -4,8 +4,6 @@ description: 'Document Discovery & Confirmation - Handle fresh context validatio
4
4
 
5
5
  # File references (ONLY variables used in this step)
6
6
  nextStepFile: './step-v-02-format-detection.md'
7
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
8
- partyModeWorkflow: 'skill:bmad-party-mode'
9
7
  prdPurpose: '../data/prd-purpose.md'
10
8
  ---
11
9
 
@@ -195,8 +193,8 @@ Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Conti
195
193
 
196
194
  #### Menu Handling Logic:
197
195
 
198
- - IF A: Read fully and follow: {advancedElicitationTask}, and when finished redisplay the menu
199
- - IF P: Read fully and follow: {partyModeWorkflow}, and when finished redisplay the menu
196
+ - IF A: Invoke the `bmad-advanced-elicitation` skill, and when finished redisplay the menu
197
+ - IF P: Invoke the `bmad-party-mode` skill, and when finished redisplay the menu
200
198
  - IF C: Read fully and follow: {nextStepFile} to begin format detection
201
199
  - IF user provides additional document: Load it, update report, redisplay summary
202
200
  - IF Any other: help user, then redisplay menu
package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-11-holistic-quality-validation.md CHANGED
@@ -6,7 +6,6 @@ description: 'Holistic Quality Assessment - Assess PRD as cohesive, compelling d
6
6
  nextStepFile: './step-v-12-completeness-validation.md'
7
7
  prdFile: '{prd_file_path}'
8
8
  validationReportPath: '{validation_report_path}'
9
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
10
9
  ---
11
10
 
12
11
  # Step 11: Holistic Quality Assessment
@@ -67,8 +66,8 @@ Assess the PRD as a cohesive, compelling document - evaluating document flow, du
67
66
 
68
67
  "Perform holistic quality assessment on this PRD using multi-perspective evaluation:
69
68
 
70
- **Read fully and follow the Advanced Elicitation workflow:**
71
- {advancedElicitationTask}
69
+ **Advanced Elicitation workflow:**
70
+ Invoke the `bmad-advanced-elicitation` skill
72
71
 
73
72
  **Evaluate the PRD from these perspectives:**
74
73
 
package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md CHANGED
@@ -4,8 +4,6 @@ description: 'Document Discovery & Confirmation - Handle fresh context validatio
4
4
 
5
5
  # File references (ONLY variables used in this step)
6
6
  nextStepFile: './step-v-02-format-detection.md'
7
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
8
- partyModeWorkflow: 'skill:bmad-party-mode'
9
7
  prdPurpose: '../data/prd-purpose.md'
10
8
  ---
11
9
 
@@ -195,8 +193,8 @@ Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Conti
195
193
 
196
194
  #### Menu Handling Logic:
197
195
 
198
- - IF A: Read fully and follow: {advancedElicitationTask}, and when finished redisplay the menu
199
- - IF P: Read fully and follow: {partyModeWorkflow}, and when finished redisplay the menu
196
+ - IF A: Invoke the `bmad-advanced-elicitation` skill, and when finished redisplay the menu
197
+ - IF P: Invoke the `bmad-party-mode` skill, and when finished redisplay the menu
200
198
  - IF C: Read fully and follow: {nextStepFile} to begin format detection
201
199
  - IF user provides additional document: Load it, update report, redisplay summary
202
200
  - IF Any other: help user, then redisplay menu
package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md CHANGED
@@ -6,7 +6,6 @@ description: 'Holistic Quality Assessment - Assess PRD as cohesive, compelling d
6
6
  nextStepFile: './step-v-12-completeness-validation.md'
7
7
  prdFile: '{prd_file_path}'
8
8
  validationReportPath: '{validation_report_path}'
9
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
10
9
  ---
11
10
 
12
11
  # Step 11: Holistic Quality Assessment
@@ -67,8 +66,8 @@ Assess the PRD as a cohesive, compelling document - evaluating document flow, du
67
66
 
68
67
  "Perform holistic quality assessment on this PRD using multi-perspective evaluation:
69
68
 
70
- **Read fully and follow the Advanced Elicitation workflow:**
71
- {advancedElicitationTask}
69
+ **Advanced Elicitation workflow:**
70
+ Invoke the `bmad-advanced-elicitation` skill
72
71
 
73
72
  **Evaluate the PRD from these perspectives:**
74
73
 
package/src/bmm/workflows/bmad-generate-project-context/steps/step-02-generate.md CHANGED
@@ -30,8 +30,8 @@ This step will generate content and present choices for each rule category:
30
30
 
31
31
  ## PROTOCOL INTEGRATION:
32
32
 
33
- - When 'A' selected: Execute skill:bmad-advanced-elicitation
34
- - When 'P' selected: Execute skill:bmad-party-mode
33
+ - When 'A' selected: Invoke the `bmad-advanced-elicitation` skill
34
+ - When 'P' selected: Invoke the `bmad-party-mode` skill
35
35
  - PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
36
36
  - User accepts/rejects protocol changes before proceeding
37
37
 
@@ -268,7 +268,7 @@ After each category, show the generated rules and present choices:
268
268
 
269
269
  #### If 'A' (Advanced Elicitation):
270
270
 
271
- - Execute skill:bmad-advanced-elicitation with current category rules
271
+ - Invoke the `bmad-advanced-elicitation` skill with current category rules
272
272
  - Process enhanced rules that come back
273
273
  - Ask user: "Accept these enhanced rules for {{category}}? (y/n)"
274
274
  - If yes: Update content, then return to A/P/C menu
@@ -276,7 +276,7 @@ After each category, show the generated rules and present choices:
276
276
 
277
277
  #### If 'P' (Party Mode):
278
278
 
279
- - Execute skill:bmad-party-mode with category rules context
279
+ - Invoke the `bmad-party-mode` skill with category rules context
280
280
  - Process collaborative insights on implementation patterns
281
281
  - Ask user: "Accept these changes to {{category}} rules? (y/n)"
282
282
  - If yes: Update content, then return to A/P/C menu
package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-01-mode-detection.md CHANGED
@@ -85,7 +85,7 @@ Display: "**Select:** [P] Plan first (tech-spec) [E] Execute directly"
85
85
 
86
86
  #### Menu Handling Logic:
87
87
 
88
- - IF P: Direct user to `{quick_spec_workflow}`. **EXIT Quick Dev.**
88
+ - IF P: Direct user to invoke the `bmad-quick-spec` skill. **EXIT Quick Dev.**
89
89
  - IF E: Ask for any additional guidance, then **NEXT:** Read fully and follow: `./step-02-context-gathering.md`
90
90
 
91
91
  #### EXECUTION RULES:
@@ -107,7 +107,7 @@ Display:
107
107
 
108
108
  #### Menu Handling Logic:
109
109
 
110
- - IF P: Direct to `{quick_spec_workflow}`. **EXIT Quick Dev.**
110
+ - IF P: Direct user to invoke the `bmad-quick-spec` skill. **EXIT Quick Dev.**
111
111
  - IF W: Direct user to run the PRD workflow instead. **EXIT Quick Dev.**
112
112
  - IF E: Ask for guidance, then **NEXT:** Read fully and follow: `./step-02-context-gathering.md`
113
113
 
@@ -130,7 +130,7 @@ Display:
130
130
 
131
131
  #### Menu Handling Logic:
132
132
 
133
- - IF P: Direct to `{quick_spec_workflow}`. **EXIT Quick Dev.**
133
+ - IF P: Direct user to invoke the `bmad-quick-spec` skill. **EXIT Quick Dev.**
134
134
  - IF W: Direct user to run the PRD workflow instead. **EXIT Quick Dev.**
135
135
  - IF E: Ask for guidance, then **NEXT:** Read fully and follow: `./step-02-context-gathering.md`
136
136
 
package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/workflow.md CHANGED
@@ -31,12 +31,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
31
31
 
32
32
  - `project_context` = `**/project-context.md` (load if exists)
33
33
 
34
- ### Related Workflows
35
-
36
- - `quick_spec_workflow` = `skill:bmad-quick-spec`
37
- - `party_mode_exec` = `skill:bmad-party-mode`
38
- - `advanced_elicitation` = `skill:bmad-advanced-elicitation`
39
-
40
34
  ---
41
35
 
42
36
  ## EXECUTION
package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md CHANGED
@@ -161,8 +161,8 @@ b) **HALT and wait for user selection.**
161
161
 
162
162
  #### Menu Handling Logic:
163
163
 
164
- - IF A: Read fully and follow: `{advanced_elicitation}` with current tech-spec content, process enhanced insights, ask user "Accept improvements? (y/n)", if yes update WIP file then redisplay menu, if no keep original then redisplay menu
165
- - IF P: Read fully and follow: `{party_mode_exec}` with current tech-spec content, process collaborative insights, ask user "Accept changes? (y/n)", if yes update WIP file then redisplay menu, if no keep original then redisplay menu
164
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current tech-spec content, process enhanced insights, ask user "Accept improvements? (y/n)", if yes update WIP file then redisplay menu, if no keep original then redisplay menu
165
+ - IF P: Invoke the `bmad-party-mode` skill with current tech-spec content, process collaborative insights, ask user "Accept changes? (y/n)", if yes update WIP file then redisplay menu, if no keep original then redisplay menu
166
166
  - IF C: Verify `{wipFile}` has `stepsCompleted: [1]`, then read fully and follow: `./step-02-investigate.md`
167
167
  - IF Any other comments or queries: respond helpfully then redisplay menu
168
168
 
package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-02-investigate.md CHANGED
@@ -116,8 +116,8 @@ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Ge
116
116
 
117
117
  #### Menu Handling Logic:
118
118
 
119
- - IF A: Read fully and follow: `{advanced_elicitation}` with current tech-spec content, process enhanced insights, ask user "Accept improvements? (y/n)", if yes update WIP file then redisplay menu, if no keep original then redisplay menu
120
- - IF P: Read fully and follow: `{party_mode_exec}` with current tech-spec content, process collaborative insights, ask user "Accept changes? (y/n)", if yes update WIP file then redisplay menu, if no keep original then redisplay menu
119
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current tech-spec content, process enhanced insights, ask user "Accept improvements? (y/n)", if yes update WIP file then redisplay menu, if no keep original then redisplay menu
120
+ - IF P: Invoke the `bmad-party-mode` skill with current tech-spec content, process collaborative insights, ask user "Accept changes? (y/n)", if yes update WIP file then redisplay menu, if no keep original then redisplay menu
121
121
  - IF C: Verify frontmatter updated with `stepsCompleted: [1, 2]`, then read fully and follow: `./step-03-generate.md`
122
122
  - IF Any other comments or queries: respond helpfully then redisplay menu
123
123
 
package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-04-review.md CHANGED
@@ -48,8 +48,8 @@ Display: "**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitati
48
48
  - IF C: Proceed to Section 3 (Finalize the Spec)
49
49
  - IF E: Proceed to Section 2 (Handle Review Feedback), then return here and redisplay menu
50
50
  - IF Q: Answer questions, then redisplay this menu
51
- - IF A: Read fully and follow: `{advanced_elicitation}` with current spec content, process enhanced insights, ask user "Accept improvements? (y/n)", if yes update spec then redisplay menu, if no keep original then redisplay menu
52
- - IF P: Read fully and follow: `{party_mode_exec}` with current spec content, process collaborative insights, ask user "Accept changes? (y/n)", if yes update spec then redisplay menu, if no keep original then redisplay menu
51
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current spec content, process enhanced insights, ask user "Accept improvements? (y/n)", if yes update spec then redisplay menu, if no keep original then redisplay menu
52
+ - IF P: Invoke the `bmad-party-mode` skill with current spec content, process collaborative insights, ask user "Accept changes? (y/n)", if yes update spec then redisplay menu, if no keep original then redisplay menu
53
53
  - IF Any other comments or queries: respond helpfully then redisplay menu
54
54
 
55
55
  #### EXECUTION RULES:
@@ -134,10 +134,10 @@ b) **HALT and wait for user selection.**
134
134
 
135
135
  #### Menu Handling Logic:
136
136
 
137
- - IF A: Read fully and follow: `{advanced_elicitation}` with current spec content, process enhanced insights, ask user "Accept improvements? (y/n)", if yes update spec then redisplay menu, if no keep original then redisplay menu
137
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current spec content, process enhanced insights, ask user "Accept improvements? (y/n)", if yes update spec then redisplay menu, if no keep original then redisplay menu
138
138
  - IF B: Invoke the `bmad-quick-dev` skill with `{finalFile}` in a fresh context if possible (warn: fresh context is better)
139
139
  - IF D: Exit workflow - display final confirmation and path to spec
140
- - IF P: Read fully and follow: `{party_mode_exec}` with current spec content, process collaborative insights, ask user "Accept changes? (y/n)", if yes update spec then redisplay menu, if no keep original then redisplay menu
140
+ - IF P: Invoke the `bmad-party-mode` skill with current spec content, process collaborative insights, ask user "Accept changes? (y/n)", if yes update spec then redisplay menu, if no keep original then redisplay menu
141
141
  - IF R: Execute Adversarial Review (see below)
142
142
  - IF Any other comments or queries: respond helpfully then redisplay menu
143
143
 
package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/workflow.md CHANGED
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  main_config: '{project-root}/_bmad/bmm/config.yaml'
3
3
 
4
- # Checkpoint handler references
5
- advanced_elicitation: 'skill:bmad-advanced-elicitation'
6
- party_mode_exec: 'skill:bmad-party-mode'
7
4
  ---
8
5
 
9
6
  # Quick-Spec Workflow
package/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # Step 3: Interactive Technique Execution and Facilitation
2
2
 
3
3
  ---
4
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
4
+
5
5
  ---
6
6
 
7
7
  ## MANDATORY EXECUTION RULES (READ FIRST):
@@ -303,7 +303,7 @@ After final technique element:
303
303
  #### If 'K', 'T', 'A', or 'B' (Continue Exploring):
304
304
 
305
305
  - **Stay in Step 3** and restart the facilitation loop for the chosen path (or pause if break requested).
306
- - For option A, invoke Advanced Elicitation: `{advancedElicitationTask}`
306
+ - For option A: Invoke the `bmad-advanced-elicitation` skill
307
307
 
308
308
  ### 9. Update Documentation
309
309
 
package/src/core/skills/bmad-brainstorming/workflow.md CHANGED
@@ -44,8 +44,6 @@ Load config from `{project-root}/_bmad/core/config.yaml` and resolve:
44
44
 
45
45
  All steps MUST reference `{brainstorming_session_output_file}` instead of the full path pattern.
46
46
  - `context_file` = Optional context file path from workflow invocation for project-specific guidance
47
- - `advancedElicitationTask` = `skill:bmad-advanced-elicitation`
48
-
49
47
  ---
50
48
 
51
49
  ## EXECUTION
package/src/core/tasks/bmad-create-prd/steps-c/step-05-domain.md CHANGED
@@ -142,7 +142,7 @@ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue - Sav
142
142
 
143
143
  #### Menu Handling Logic:
144
144
  - IF A: Invoke the `bmad-advanced-elicitation` skill, and when finished redisplay the menu
145
- - IF P: Read fully and follow: `skill:bmad-party-mode` and when finished redisplay the menu
145
+ - IF P: Invoke the `bmad-party-mode` skill, and when finished redisplay the menu
146
146
  - IF C: Save content to {outputFile}, update frontmatter, then read fully and follow: ./step-06-innovation.md
147
147
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#n-present-menu-options)
148
148
 
package/tools/skill-validator.md CHANGED
@@ -270,6 +270,14 @@ If no findings are generated, the skill passes validation.
270
270
  - **Detection:** For internal references, verify the target file exists in the skill directory. For external references using config variables, verify the path structure is plausible (you cannot resolve config variables, but you can check that the path after the variable looks reasonable — e.g., `{planning_artifacts}/*.md` is plausible, `{planning_artifacts}/../../etc/passwd` is not).
271
271
  - **Fix:** Correct the path or remove the dead reference.
272
272
 
273
+ ### REF-03 — Skill Invocation Must Use "Invoke" Language
274
+
275
+ - **Severity:** HIGH
276
+ - **Applies to:** all files
277
+ - **Rule:** When a skill references another skill via `skill:skill-name`, the surrounding instruction must use the word "invoke" (e.g., `Invoke skill:bmad-party-mode`). Phrases like "Read fully and follow", "Execute", "Run", "Load", "Open", or "Follow" are invalid — they imply file-level operations on a document, not skill invocation. A skill is a unit that is invoked, not a file that is read.
278
+ - **Detection:** Find all `skill:` references in body text and frontmatter. Check the surrounding instruction text (same sentence or directive) for file-oriented verbs: "read", "follow", "load", "execute", "run", "open". Flag any that do not use "invoke" (or a close synonym like "activate" or "launch").
279
+ - **Fix:** Replace the instruction with `Invoke skill:skill-name` or `Invoke the \`skill-name\` skill`. Remove any "read fully and follow" or similar file-oriented phrasing.
280
+
273
281
  ---
274
282
 
275
283
  ## Report Template