bmad-method 4.6.0 → 4.6.1

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.
@@ -107,6 +107,106 @@ dependencies:
107
107
  ```
108
108
  ==================== END: agents#game-developer ====================
109
109
 
110
+ ==================== START: tasks#execute-checklist ====================
111
+ # Checklist Validation Task
112
+
113
+ This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
114
+
115
+ ## Context
116
+
117
+ The BMAD Method uses various checklists to ensure quality and completeness of different artifacts. Each checklist contains embedded prompts and instructions to guide the LLM through thorough validation and advanced elicitation. The checklists automatically identify their required artifacts and guide the validation process.
118
+
119
+ ## Available Checklists
120
+
121
+ If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
122
+
123
+ ## Instructions
124
+
125
+ 1. **Initial Assessment**
126
+
127
+ - If user or the task being run provides a checklist name:
128
+ - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
129
+ - If multiple matches found, ask user to clarify
130
+ - Load the appropriate checklist from bmad-core/checklists/
131
+ - If no checklist specified:
132
+ - Ask the user which checklist they want to use
133
+ - Present the available options from the files in the checklists folder
134
+ - Confirm if they want to work through the checklist:
135
+ - Section by section (interactive mode - very time consuming)
136
+ - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
137
+
138
+ 2. **Document and Artifact Gathering**
139
+
140
+ - Each checklist will specify its required documents/artifacts at the beginning
141
+ - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
142
+
143
+ 3. **Checklist Processing**
144
+
145
+ If in interactive mode:
146
+
147
+ - Work through each section of the checklist one at a time
148
+ - For each section:
149
+ - Review all items in the section following instructions for that section embedded in the checklist
150
+ - Check each item against the relevant documentation or artifacts as appropriate
151
+ - Present summary of findings for that section, highlighting warnings, errors and non applicable items (rationale for non-applicability).
152
+ - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
153
+
154
+ If in YOLO mode:
155
+
156
+ - Process all sections at once
157
+ - Create a comprehensive report of all findings
158
+ - Present the complete analysis to the user
159
+
160
+ 4. **Validation Approach**
161
+
162
+ For each checklist item:
163
+
164
+ - Read and understand the requirement
165
+ - Look for evidence in the documentation that satisfies the requirement
166
+ - Consider both explicit mentions and implicit coverage
167
+ - Aside from this, follow all checklist llm instructions
168
+ - Mark items as:
169
+ - ✅ PASS: Requirement clearly met
170
+ - ❌ FAIL: Requirement not met or insufficient coverage
171
+ - ⚠️ PARTIAL: Some aspects covered but needs improvement
172
+ - N/A: Not applicable to this case
173
+
174
+ 5. **Section Analysis**
175
+
176
+ For each section:
177
+
178
+ - think step by step to calculate pass rate
179
+ - Identify common themes in failed items
180
+ - Provide specific recommendations for improvement
181
+ - In interactive mode, discuss findings with user
182
+ - Document any user decisions or explanations
183
+
184
+ 6. **Final Report**
185
+
186
+ Prepare a summary that includes:
187
+
188
+ - Overall checklist completion status
189
+ - Pass rates by section
190
+ - List of failed items with context
191
+ - Specific recommendations for improvement
192
+ - Any sections or items marked as N/A with justification
193
+
194
+ ## Checklist Execution Methodology
195
+
196
+ Each checklist now contains embedded LLM prompts and instructions that will:
197
+
198
+ 1. **Guide thorough thinking** - Prompts ensure deep analysis of each section
199
+ 2. **Request specific artifacts** - Clear instructions on what documents/access is needed
200
+ 3. **Provide contextual guidance** - Section-specific prompts for better validation
201
+ 4. **Generate comprehensive reports** - Final summary with detailed findings
202
+
203
+ The LLM will:
204
+
205
+ - Execute the complete checklist validation
206
+ - Present a final report with pass/fail rates and key findings
207
+ - Offer to provide detailed analysis of any section, especially those with warnings or failures
208
+ ==================== END: tasks#execute-checklist ====================
209
+
110
210
  ==================== START: templates#game-architecture-tmpl ====================
111
211
  # {{Game Title}} Game Architecture Document
112
212
 
@@ -289,6 +289,106 @@ Execute `checklists#game-story-dod-checklist` against completed story
289
289
  This task ensures game development stories are immediately actionable and enable efficient AI-driven development of game features.
290
290
  ==================== END: tasks#create-game-story ====================
291
291
 
292
+ ==================== START: tasks#execute-checklist ====================
293
+ # Checklist Validation Task
294
+
295
+ This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
296
+
297
+ ## Context
298
+
299
+ The BMAD Method uses various checklists to ensure quality and completeness of different artifacts. Each checklist contains embedded prompts and instructions to guide the LLM through thorough validation and advanced elicitation. The checklists automatically identify their required artifacts and guide the validation process.
300
+
301
+ ## Available Checklists
302
+
303
+ If the user asks or does not specify a specific checklist, list the checklists available to the agent persona. If the task is being run not with a specific agent, tell the user to check the bmad-core/checklists folder to select the appropriate one to run.
304
+
305
+ ## Instructions
306
+
307
+ 1. **Initial Assessment**
308
+
309
+ - If user or the task being run provides a checklist name:
310
+ - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
311
+ - If multiple matches found, ask user to clarify
312
+ - Load the appropriate checklist from bmad-core/checklists/
313
+ - If no checklist specified:
314
+ - Ask the user which checklist they want to use
315
+ - Present the available options from the files in the checklists folder
316
+ - Confirm if they want to work through the checklist:
317
+ - Section by section (interactive mode - very time consuming)
318
+ - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
319
+
320
+ 2. **Document and Artifact Gathering**
321
+
322
+ - Each checklist will specify its required documents/artifacts at the beginning
323
+ - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
324
+
325
+ 3. **Checklist Processing**
326
+
327
+ If in interactive mode:
328
+
329
+ - Work through each section of the checklist one at a time
330
+ - For each section:
331
+ - Review all items in the section following instructions for that section embedded in the checklist
332
+ - Check each item against the relevant documentation or artifacts as appropriate
333
+ - Present summary of findings for that section, highlighting warnings, errors and non applicable items (rationale for non-applicability).
334
+ - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
335
+
336
+ If in YOLO mode:
337
+
338
+ - Process all sections at once
339
+ - Create a comprehensive report of all findings
340
+ - Present the complete analysis to the user
341
+
342
+ 4. **Validation Approach**
343
+
344
+ For each checklist item:
345
+
346
+ - Read and understand the requirement
347
+ - Look for evidence in the documentation that satisfies the requirement
348
+ - Consider both explicit mentions and implicit coverage
349
+ - Aside from this, follow all checklist llm instructions
350
+ - Mark items as:
351
+ - ✅ PASS: Requirement clearly met
352
+ - ❌ FAIL: Requirement not met or insufficient coverage
353
+ - ⚠️ PARTIAL: Some aspects covered but needs improvement
354
+ - N/A: Not applicable to this case
355
+
356
+ 5. **Section Analysis**
357
+
358
+ For each section:
359
+
360
+ - think step by step to calculate pass rate
361
+ - Identify common themes in failed items
362
+ - Provide specific recommendations for improvement
363
+ - In interactive mode, discuss findings with user
364
+ - Document any user decisions or explanations
365
+
366
+ 6. **Final Report**
367
+
368
+ Prepare a summary that includes:
369
+
370
+ - Overall checklist completion status
371
+ - Pass rates by section
372
+ - List of failed items with context
373
+ - Specific recommendations for improvement
374
+ - Any sections or items marked as N/A with justification
375
+
376
+ ## Checklist Execution Methodology
377
+
378
+ Each checklist now contains embedded LLM prompts and instructions that will:
379
+
380
+ 1. **Guide thorough thinking** - Prompts ensure deep analysis of each section
381
+ 2. **Request specific artifacts** - Clear instructions on what documents/access is needed
382
+ 3. **Provide contextual guidance** - Section-specific prompts for better validation
383
+ 4. **Generate comprehensive reports** - Final summary with detailed findings
384
+
385
+ The LLM will:
386
+
387
+ - Execute the complete checklist validation
388
+ - Present a final report with pass/fail rates and key findings
389
+ - Offer to provide detailed analysis of any section, especially those with warnings or failures
390
+ ==================== END: tasks#execute-checklist ====================
391
+
292
392
  ==================== START: templates#game-story-tmpl ====================
293
393
  # Story: {{Story Title}}
294
394