bmad-method 4.31.0 → 4.33.0

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 (92) hide show
  1. package/.vscode/settings.json +1 -7
  2. package/CHANGELOG.md +113 -173
  3. package/README.md +47 -0
  4. package/bmad-core/agents/analyst.md +1 -1
  5. package/bmad-core/agents/architect.md +2 -3
  6. package/bmad-core/agents/bmad-master.md +0 -1
  7. package/bmad-core/agents/bmad-orchestrator.md +9 -10
  8. package/bmad-core/agents/dev.md +1 -2
  9. package/bmad-core/agents/pm.md +3 -1
  10. package/bmad-core/agents/po.md +1 -1
  11. package/bmad-core/agents/qa.md +1 -1
  12. package/bmad-core/agents/sm.md +1 -1
  13. package/bmad-core/agents/ux-expert.md +1 -1
  14. package/bmad-core/bmad-core/user-guide.md +0 -0
  15. package/bmad-core/checklists/architect-checklist.md +0 -5
  16. package/bmad-core/checklists/pm-checklist.md +0 -5
  17. package/bmad-core/checklists/po-master-checklist.md +0 -9
  18. package/bmad-core/checklists/story-dod-checklist.md +0 -7
  19. package/bmad-core/checklists/story-draft-checklist.md +0 -3
  20. package/bmad-core/data/bmad-kb.md +5 -2
  21. package/bmad-core/data/elicitation-methods.md +20 -0
  22. package/bmad-core/enhanced-ide-development-workflow.md +43 -0
  23. package/bmad-core/tasks/create-brownfield-story.md +11 -3
  24. package/bmad-core/tasks/create-deep-research-prompt.md +0 -11
  25. package/bmad-core/tasks/document-project.md +15 -13
  26. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  27. package/bmad-core/tasks/index-docs.md +0 -6
  28. package/bmad-core/tasks/kb-mode-interaction.md +3 -3
  29. package/bmad-core/tasks/review-story.md +10 -1
  30. package/bmad-core/tasks/shard-doc.md +0 -2
  31. package/bmad-core/user-guide.md +7 -6
  32. package/bmad-core/working-in-the-brownfield.md +39 -36
  33. package/common/tasks/execute-checklist.md +0 -7
  34. package/dist/agents/analyst.txt +6 -6
  35. package/dist/agents/architect.txt +8 -3
  36. package/dist/agents/bmad-master.txt +2 -1
  37. package/dist/agents/pm.txt +9 -2
  38. package/dist/agents/po.txt +2 -318
  39. package/dist/agents/qa.txt +0 -1
  40. package/dist/agents/sm.txt +3 -3
  41. package/dist/agents/ux-expert.txt +2 -297
  42. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +6 -6
  43. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +4047 -0
  44. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +1520 -185
  45. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +214 -1229
  46. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +537 -373
  47. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +6917 -2140
  48. package/dist/teams/team-all.txt +30 -25
  49. package/dist/teams/team-fullstack.txt +27 -21
  50. package/dist/teams/team-ide-minimal.txt +5 -322
  51. package/dist/teams/team-no-ui.txt +25 -16
  52. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  53. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +0 -4
  54. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +3 -5
  55. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +0 -1
  56. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +0 -18
  57. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +1 -0
  58. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +80 -0
  59. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +21 -16
  60. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +25 -25
  61. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +15 -14
  62. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +391 -0
  63. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +203 -0
  64. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +1 -1
  65. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +103 -139
  66. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +1 -1
  67. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +586 -68
  68. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +0 -4
  69. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +0 -1
  70. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +141 -0
  71. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +165 -198
  72. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +0 -18
  73. package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +200 -0
  74. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +938 -453
  75. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +3 -3
  76. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +517 -155
  77. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +12 -12
  78. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +11 -11
  79. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  80. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +0 -3
  81. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +0 -1
  82. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +0 -1
  83. package/package.json +4 -1
  84. package/tools/bmad-npx-wrapper.js +5 -7
  85. package/tools/flattener/main.js +570 -0
  86. package/tools/installer/bin/bmad.js +14 -0
  87. package/tools/installer/lib/installer.js +29 -3
  88. package/tools/installer/package-lock.json +89 -89
  89. package/tools/installer/package.json +1 -1
  90. package/.husky/pre-commit +0 -2
  91. package/.prettierignore +0 -21
  92. package/.prettierrc +0 -23
@@ -73,15 +73,12 @@ persona:
73
73
  - You can craft effective prompts for AI UI generation tools like v0, or Lovable.
74
74
  commands:
75
75
  - help: Show numbered list of the following commands to allow selection
76
- - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
77
- - generate-ui-prompt: Create AI frontend generation prompt
78
- - research {topic}: Execute create-deep-research-prompt task to generate a prompt to init UX deep research
79
- - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
76
+ - create-front-end-spec: run task create-doc.md with template front-end-spec-tmpl.yaml
77
+ - generate-ui-prompt: Run task generate-ai-frontend-prompt.md
80
78
  - exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona
81
79
  dependencies:
82
80
  tasks:
83
81
  - generate-ai-frontend-prompt.md
84
- - create-deep-research-prompt.md
85
82
  - create-doc.md
86
83
  - execute-checklist.md
87
84
  templates:
@@ -145,298 +142,6 @@ You will now synthesize the inputs and the above principles into a final, compre
145
142
  - <important_note>Conclude by reminding the user that all AI-generated code will require careful human review, testing, and refinement to be considered production-ready.</important_note>
146
143
  ==================== END: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
147
144
 
148
- ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
149
- # Create Deep Research Prompt Task
150
-
151
- This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
152
-
153
- ## Purpose
154
-
155
- Generate well-structured research prompts that:
156
-
157
- - Define clear research objectives and scope
158
- - Specify appropriate research methodologies
159
- - Outline expected deliverables and formats
160
- - Guide systematic investigation of complex topics
161
- - Ensure actionable insights are captured
162
-
163
- ## Research Type Selection
164
-
165
- CRITICAL: First, help the user select the most appropriate research focus based on their needs and any input documents they've provided.
166
-
167
- ### 1. Research Focus Options
168
-
169
- Present these numbered options to the user:
170
-
171
- 1. **Product Validation Research**
172
-
173
- - Validate product hypotheses and market fit
174
- - Test assumptions about user needs and solutions
175
- - Assess technical and business feasibility
176
- - Identify risks and mitigation strategies
177
-
178
- 2. **Market Opportunity Research**
179
-
180
- - Analyze market size and growth potential
181
- - Identify market segments and dynamics
182
- - Assess market entry strategies
183
- - Evaluate timing and market readiness
184
-
185
- 3. **User & Customer Research**
186
-
187
- - Deep dive into user personas and behaviors
188
- - Understand jobs-to-be-done and pain points
189
- - Map customer journeys and touchpoints
190
- - Analyze willingness to pay and value perception
191
-
192
- 4. **Competitive Intelligence Research**
193
-
194
- - Detailed competitor analysis and positioning
195
- - Feature and capability comparisons
196
- - Business model and strategy analysis
197
- - Identify competitive advantages and gaps
198
-
199
- 5. **Technology & Innovation Research**
200
-
201
- - Assess technology trends and possibilities
202
- - Evaluate technical approaches and architectures
203
- - Identify emerging technologies and disruptions
204
- - Analyze build vs. buy vs. partner options
205
-
206
- 6. **Industry & Ecosystem Research**
207
-
208
- - Map industry value chains and dynamics
209
- - Identify key players and relationships
210
- - Analyze regulatory and compliance factors
211
- - Understand partnership opportunities
212
-
213
- 7. **Strategic Options Research**
214
-
215
- - Evaluate different strategic directions
216
- - Assess business model alternatives
217
- - Analyze go-to-market strategies
218
- - Consider expansion and scaling paths
219
-
220
- 8. **Risk & Feasibility Research**
221
-
222
- - Identify and assess various risk factors
223
- - Evaluate implementation challenges
224
- - Analyze resource requirements
225
- - Consider regulatory and legal implications
226
-
227
- 9. **Custom Research Focus**
228
-
229
- - User-defined research objectives
230
- - Specialized domain investigation
231
- - Cross-functional research needs
232
-
233
- ### 2. Input Processing
234
-
235
- **If Project Brief provided:**
236
-
237
- - Extract key product concepts and goals
238
- - Identify target users and use cases
239
- - Note technical constraints and preferences
240
- - Highlight uncertainties and assumptions
241
-
242
- **If Brainstorming Results provided:**
243
-
244
- - Synthesize main ideas and themes
245
- - Identify areas needing validation
246
- - Extract hypotheses to test
247
- - Note creative directions to explore
248
-
249
- **If Market Research provided:**
250
-
251
- - Build on identified opportunities
252
- - Deepen specific market insights
253
- - Validate initial findings
254
- - Explore adjacent possibilities
255
-
256
- **If Starting Fresh:**
257
-
258
- - Gather essential context through questions
259
- - Define the problem space
260
- - Clarify research objectives
261
- - Establish success criteria
262
-
263
- ## Process
264
-
265
- ### 3. Research Prompt Structure
266
-
267
- CRITICAL: collaboratively develop a comprehensive research prompt with these components.
268
-
269
- #### A. Research Objectives
270
-
271
- CRITICAL: collaborate with the user to articulate clear, specific objectives for the research.
272
-
273
- - Primary research goal and purpose
274
- - Key decisions the research will inform
275
- - Success criteria for the research
276
- - Constraints and boundaries
277
-
278
- #### B. Research Questions
279
-
280
- CRITICAL: collaborate with the user to develop specific, actionable research questions organized by theme.
281
-
282
- **Core Questions:**
283
-
284
- - Central questions that must be answered
285
- - Priority ranking of questions
286
- - Dependencies between questions
287
-
288
- **Supporting Questions:**
289
-
290
- - Additional context-building questions
291
- - Nice-to-have insights
292
- - Future-looking considerations
293
-
294
- #### C. Research Methodology
295
-
296
- **Data Collection Methods:**
297
-
298
- - Secondary research sources
299
- - Primary research approaches (if applicable)
300
- - Data quality requirements
301
- - Source credibility criteria
302
-
303
- **Analysis Frameworks:**
304
-
305
- - Specific frameworks to apply
306
- - Comparison criteria
307
- - Evaluation methodologies
308
- - Synthesis approaches
309
-
310
- #### D. Output Requirements
311
-
312
- **Format Specifications:**
313
-
314
- - Executive summary requirements
315
- - Detailed findings structure
316
- - Visual/tabular presentations
317
- - Supporting documentation
318
-
319
- **Key Deliverables:**
320
-
321
- - Must-have sections and insights
322
- - Decision-support elements
323
- - Action-oriented recommendations
324
- - Risk and uncertainty documentation
325
-
326
- ### 4. Prompt Generation
327
-
328
- **Research Prompt Template:**
329
-
330
- ```markdown
331
- ## Research Objective
332
-
333
- [Clear statement of what this research aims to achieve]
334
-
335
- ## Background Context
336
-
337
- [Relevant information from project brief, brainstorming, or other inputs]
338
-
339
- ## Research Questions
340
-
341
- ### Primary Questions (Must Answer)
342
-
343
- 1. [Specific, actionable question]
344
- 2. [Specific, actionable question]
345
- ...
346
-
347
- ### Secondary Questions (Nice to Have)
348
-
349
- 1. [Supporting question]
350
- 2. [Supporting question]
351
- ...
352
-
353
- ## Research Methodology
354
-
355
- ### Information Sources
356
-
357
- - [Specific source types and priorities]
358
-
359
- ### Analysis Frameworks
360
-
361
- - [Specific frameworks to apply]
362
-
363
- ### Data Requirements
364
-
365
- - [Quality, recency, credibility needs]
366
-
367
- ## Expected Deliverables
368
-
369
- ### Executive Summary
370
-
371
- - Key findings and insights
372
- - Critical implications
373
- - Recommended actions
374
-
375
- ### Detailed Analysis
376
-
377
- [Specific sections needed based on research type]
378
-
379
- ### Supporting Materials
380
-
381
- - Data tables
382
- - Comparison matrices
383
- - Source documentation
384
-
385
- ## Success Criteria
386
-
387
- [How to evaluate if research achieved its objectives]
388
-
389
- ## Timeline and Priority
390
-
391
- [If applicable, any time constraints or phasing]
392
- ```
393
-
394
- ### 5. Review and Refinement
395
-
396
- 1. **Present Complete Prompt**
397
-
398
- - Show the full research prompt
399
- - Explain key elements and rationale
400
- - Highlight any assumptions made
401
-
402
- 2. **Gather Feedback**
403
-
404
- - Are the objectives clear and correct?
405
- - Do the questions address all concerns?
406
- - Is the scope appropriate?
407
- - Are output requirements sufficient?
408
-
409
- 3. **Refine as Needed**
410
- - Incorporate user feedback
411
- - Adjust scope or focus
412
- - Add missing elements
413
- - Clarify ambiguities
414
-
415
- ### 6. Next Steps Guidance
416
-
417
- **Execution Options:**
418
-
419
- 1. **Use with AI Research Assistant**: Provide this prompt to an AI model with research capabilities
420
- 2. **Guide Human Research**: Use as a framework for manual research efforts
421
- 3. **Hybrid Approach**: Combine AI and human research using this structure
422
-
423
- **Integration Points:**
424
-
425
- - How findings will feed into next phases
426
- - Which team members should review results
427
- - How to validate findings
428
- - When to revisit or expand research
429
-
430
- ## Important Notes
431
-
432
- - The quality of the research prompt directly impacts the quality of insights gathered
433
- - Be specific rather than general in research questions
434
- - Consider both current state and future implications
435
- - Balance comprehensiveness with focus
436
- - Document assumptions and limitations clearly
437
- - Plan for iterative refinement based on initial findings
438
- ==================== END: .bmad-core/tasks/create-deep-research-prompt.md ====================
439
-
440
145
  ==================== START: .bmad-core/tasks/create-doc.md ====================
441
146
  # Create Document from Template (YAML Driven)
442
147
 
@@ -92,14 +92,14 @@ persona:
92
92
  - Numbered Options Protocol - Always use numbered lists for selections
93
93
  commands:
94
94
  - help: Show numbered list of the following commands to allow selection
95
- - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
95
+ - create-project-brief: use task create-doc with project-brief-tmpl.yaml
96
+ - perform-market-research: use task create-doc with market-research-tmpl.yaml
97
+ - create-competitor-analysis: use task create-doc with competitor-analysis-tmpl.yaml
96
98
  - yolo: Toggle Yolo Mode
97
- - doc-out: Output full document to current destination file
98
- - execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
99
- - research-prompt {topic}: execute task create-deep-research-prompt for architectural decisions
100
- - brainstorm {topic}: Facilitate structured brainstorming session
99
+ - doc-out: Output full document in progress to current destination file
100
+ - research-prompt {topic}: execute task create-deep-research-prompt.md
101
+ - brainstorm {topic}: Facilitate structured brainstorming session (run task facilitate-brainstorming-session.md with template brainstorming-output-tmpl.yaml)
101
102
  - elicit: run the task advanced-elicitation
102
- - document-project: Analyze and document existing project structure comprehensively
103
103
  - exit: Say goodbye as the Business Analyst, and then abandon inhabiting this persona
104
104
  dependencies:
105
105
  tasks: