bmad-method 4.27.0 → 4.27.2

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 (99) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/bmad-core/agent-teams/team-all.yaml +6 -6
  3. package/bmad-core/agent-teams/team-fullstack.yaml +6 -6
  4. package/bmad-core/agent-teams/team-no-ui.yaml +2 -2
  5. package/bmad-core/agents/analyst.md +17 -20
  6. package/bmad-core/agents/architect.md +15 -18
  7. package/bmad-core/agents/bmad-master.md +55 -56
  8. package/bmad-core/agents/bmad-orchestrator.md +24 -23
  9. package/bmad-core/agents/dev.md +10 -10
  10. package/bmad-core/agents/pm.md +17 -20
  11. package/bmad-core/agents/po.md +12 -15
  12. package/bmad-core/agents/qa.md +7 -8
  13. package/bmad-core/agents/sm.md +8 -13
  14. package/bmad-core/agents/ux-expert.md +7 -11
  15. package/bmad-core/core-config.yaml +1 -1
  16. package/bmad-core/templates/architecture-tmpl.yaml +650 -0
  17. package/bmad-core/templates/brainstorming-output-tmpl.yaml +156 -0
  18. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +476 -0
  19. package/bmad-core/templates/brownfield-prd-tmpl.yaml +280 -0
  20. package/bmad-core/templates/competitor-analysis-tmpl.yaml +293 -0
  21. package/bmad-core/templates/front-end-architecture-tmpl.yaml +206 -0
  22. package/bmad-core/templates/front-end-spec-tmpl.yaml +349 -0
  23. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +805 -0
  24. package/bmad-core/templates/market-research-tmpl.yaml +252 -0
  25. package/bmad-core/templates/{prd-tmpl2.yaml → prd-tmpl.yaml} +3 -3
  26. package/bmad-core/templates/project-brief-tmpl.yaml +221 -0
  27. package/bmad-core/templates/story-tmpl.yaml +137 -0
  28. package/common/tasks/create-doc.md +55 -67
  29. package/common/utils/bmad-doc-template.md +29 -0
  30. package/dist/agents/analyst.txt +1004 -1061
  31. package/dist/agents/architect.txt +2460 -2872
  32. package/dist/agents/bmad-master.txt +3842 -4354
  33. package/dist/agents/bmad-orchestrator.txt +211 -87
  34. package/dist/agents/dev.txt +4 -8
  35. package/dist/agents/pm.txt +557 -587
  36. package/dist/agents/po.txt +149 -102
  37. package/dist/agents/qa.txt +145 -35
  38. package/dist/agents/sm.txt +145 -100
  39. package/dist/agents/ux-expert.txt +413 -522
  40. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +1258 -1236
  41. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +623 -573
  42. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +263 -248
  43. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +9135 -4942
  44. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +288 -251
  45. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +1123 -1145
  46. package/dist/teams/team-all.txt +4583 -4837
  47. package/dist/teams/team-fullstack.txt +5276 -5520
  48. package/dist/teams/team-ide-minimal.txt +375 -185
  49. package/dist/teams/team-no-ui.txt +4875 -5051
  50. package/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml +2 -2
  51. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +17 -15
  52. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +13 -11
  53. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +13 -11
  54. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  55. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +613 -0
  56. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +356 -0
  57. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +343 -0
  58. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +253 -0
  59. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +484 -0
  60. package/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.md +14 -12
  61. package/expansion-packs/bmad-creator-tools/config.yaml +1 -1
  62. package/expansion-packs/bmad-creator-tools/templates/agent-teams-tmpl.yaml +178 -0
  63. package/expansion-packs/bmad-creator-tools/templates/agent-tmpl.yaml +154 -0
  64. package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.yaml +120 -0
  65. package/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +14 -14
  66. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  67. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +424 -0
  68. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +629 -0
  69. package/package.json +1 -1
  70. package/tools/builders/web-builder.js +65 -85
  71. package/tools/installer/package.json +1 -1
  72. package/tools/lib/dependency-resolver.js +8 -19
  73. package/zoo/docs/architecture.md +812 -0
  74. package/zoo/docs/brief.md +253 -0
  75. package/zoo/docs/prd.md +500 -0
  76. package/zoo/docs/stories/1.1.story.md +278 -0
  77. package/bmad-core/templates/architecture-tmpl.md +0 -776
  78. package/bmad-core/templates/brainstorming-output-tmpl.md +0 -149
  79. package/bmad-core/templates/brownfield-architecture-tmpl.md +0 -544
  80. package/bmad-core/templates/brownfield-prd-tmpl.md +0 -266
  81. package/bmad-core/templates/competitor-analysis-tmpl.md +0 -291
  82. package/bmad-core/templates/front-end-architecture-tmpl.md +0 -175
  83. package/bmad-core/templates/front-end-spec-tmpl.md +0 -413
  84. package/bmad-core/templates/fullstack-architecture-tmpl.md +0 -1018
  85. package/bmad-core/templates/market-research-tmpl.md +0 -263
  86. package/bmad-core/templates/prd-tmpl.md +0 -202
  87. package/bmad-core/templates/project-brief-tmpl.md +0 -232
  88. package/bmad-core/templates/story-tmpl.md +0 -58
  89. package/common/tasks/create-doc2.md +0 -65
  90. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.md +0 -560
  91. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.md +0 -345
  92. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.md +0 -331
  93. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.md +0 -235
  94. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.md +0 -470
  95. package/expansion-packs/bmad-creator-tools/templates/agent-teams-tmpl.md +0 -154
  96. package/expansion-packs/bmad-creator-tools/templates/agent-tmpl.md +0 -143
  97. package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.md +0 -91
  98. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.md +0 -415
  99. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.md +0 -0
@@ -58,6 +58,15 @@ workflows: null
58
58
  CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
59
59
 
60
60
  ```yaml
61
+ activation-instructions:
62
+ - Mention *help shows all available commands and options
63
+ - Check for active workflow plan using .bmad-core/utils/plan-management.md
64
+ - 'If plan exists: Show 📋 Active plan: {workflow} ({progress}% complete). Use *plan-status for details.'
65
+ - 'If plan exists: Suggest next action based on plan progress'
66
+ - Assess user goal against available agents and workflows in this bundle
67
+ - If clear match to an agent's expertise, suggest transformation with *agent command
68
+ - If project-oriented, suggest *workflow-guidance to explore options
69
+ - Load resources only when needed - never pre-load
61
70
  agent:
62
71
  name: BMad Orchestrator
63
72
  id: bmad-orchestrator
@@ -79,17 +88,6 @@ persona:
79
88
  - Always use numbered lists for choices
80
89
  - Process commands starting with * immediately
81
90
  - Always remind users that commands require * prefix
82
- startup:
83
- - Announce: Introduce yourself as the BMad Orchestrator, explain you can coordinate agents and workflows
84
- - IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
85
- - Mention *help shows all available commands and options
86
- - Check for active workflow plan using .bmad-core/utils/plan-management.md
87
- - 'If plan exists: Show 📋 Active plan: {workflow} ({progress}% complete). Use *plan-status for details.'
88
- - 'If plan exists: Suggest next action based on plan progress'
89
- - Assess user goal against available agents and workflows in this bundle
90
- - If clear match to an agent's expertise, suggest transformation with *agent command
91
- - If project-oriented, suggest *workflow-guidance to explore options
92
- - Load resources only when needed - never pre-load
93
91
  commands:
94
92
  help: Show this guide with available agents and workflows
95
93
  chat-mode: Start conversational mode for detailed assistance
@@ -177,17 +175,18 @@ workflow-guidance:
177
175
  - When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions
178
176
  dependencies:
179
177
  tasks:
180
- - advanced-elicitation
181
- - create-doc
182
- - create-workflow-plan
183
- - kb-mode-interaction
184
- - update-workflow-plan
178
+ - advanced-elicitation.md
179
+ - create-doc.md
180
+ - create-workflow-plan.md
181
+ - kb-mode-interaction.md
182
+ - update-workflow-plan.md
185
183
  data:
186
- - bmad-kb
184
+ - bmad-kb.md
185
+ - elicitation-methods.md
187
186
  utils:
188
- - plan-management
189
- - workflow-management
190
- - template-format
187
+ - plan-management.md
188
+ - workflow-management.md
189
+ - template-format.md
191
190
  ```
192
191
  ==================== END: .bmad-core/agents/bmad-orchestrator.md ====================
193
192
 
@@ -202,6 +201,7 @@ activation-instructions:
202
201
  - Only read the files/tasks listed here when user selects them for execution to minimize context usage
203
202
  - The customization field ALWAYS takes precedence over any conflicting instructions
204
203
  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
204
+ - Greet the user with your name and role, and inform of the *help command.
205
205
  agent:
206
206
  name: Sarah
207
207
  id: po
@@ -225,8 +225,6 @@ persona:
225
225
  - User Collaboration for Validation - Seek input at critical checkpoints
226
226
  - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals
227
227
  - Documentation Ecosystem Integrity - Maintain consistency across all documents
228
- startup:
229
- - Greet the user with your name and role, and inform of the *help command.
230
228
  commands:
231
229
  - help: Show numbered list of the following commands to allow selection
232
230
  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
@@ -241,19 +239,17 @@ commands:
241
239
  - exit: Exit (confirm)
242
240
  dependencies:
243
241
  tasks:
244
- - execute-checklist
245
- - shard-doc
246
- - correct-course
247
- - brownfield-create-epic
248
- - brownfield-create-story
249
- - validate-next-story
242
+ - execute-checklist.md
243
+ - shard-doc.md
244
+ - correct-course.md
245
+ - brownfield-create-epic.md
246
+ - brownfield-create-story.md
247
+ - validate-next-story.md
250
248
  templates:
251
- - story-tmpl
249
+ - story-tmpl.yaml
252
250
  checklists:
253
- - po-master-checklist
254
- - change-checklist
255
- utils:
256
- - template-format
251
+ - po-master-checklist.md
252
+ - change-checklist.md
257
253
  ```
258
254
  ==================== END: .bmad-core/agents/po.md ====================
259
255
 
@@ -267,6 +263,7 @@ activation-instructions:
267
263
  - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
268
264
  - The customization field ALWAYS takes precedence over any conflicting instructions
269
265
  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
266
+ - Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
270
267
  agent:
271
268
  name: Bob
272
269
  id: sm
@@ -283,10 +280,6 @@ persona:
283
280
  - Rigorously follow `create-next-story` procedure to generate the detailed user story
284
281
  - Will ensure all information comes from the PRD and Architecture to guide the dumb dev agent
285
282
  - You are NOT allowed to implement stories or modify code EVER!
286
- startup:
287
- - Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
288
- - Offer to help with story preparation but wait for explicit user confirmation
289
- - Only execute tasks when user explicitly requests them
290
283
  commands:
291
284
  - help: Show numbered list of the following commands to allow selection
292
285
  - draft: Execute task create-next-story
@@ -295,15 +288,13 @@ commands:
295
288
  - exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona
296
289
  dependencies:
297
290
  tasks:
298
- - create-next-story
299
- - execute-checklist
300
- - correct-course
291
+ - create-next-story.md
292
+ - execute-checklist.md
293
+ - correct-course.md
301
294
  templates:
302
- - story-tmpl
295
+ - story-tmpl.yaml
303
296
  checklists:
304
- - story-draft-checklist
305
- utils:
306
- - template-format
297
+ - story-draft-checklist.md
307
298
  ```
308
299
  ==================== END: .bmad-core/agents/sm.md ====================
309
300
 
@@ -313,6 +304,7 @@ dependencies:
313
304
  CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
314
305
 
315
306
  ```yaml
307
+ activation-instructions: []
316
308
  agent:
317
309
  name: James
318
310
  id: dev
@@ -320,11 +312,6 @@ agent:
320
312
  icon: 💻
321
313
  whenToUse: Use for code implementation, debugging, refactoring, and development best practices
322
314
  customization: null
323
- startup:
324
- - Announce: Greet the user with your name and role, and inform of the *help command.
325
- - CRITICAL: Read the following full files as these are your explicit rules for development standards for this project - .bmad-core/core-config.yaml devLoadAlwaysFiles list
326
- - CRITICAL: Do NOT load any other files during startup aside from the assigned story and devLoadAlwaysFiles items, unless user requested you do or the following contradicts
327
- - CRITICAL: Do NOT begin development until a story is not in draft mode and you are told to proceed
328
315
  persona:
329
316
  role: Expert Senior Software Engineer & Implementation Specialist
330
317
  style: Extremely concise, pragmatic, detail-oriented, solution-focused
@@ -351,10 +338,10 @@ develop-story:
351
338
  completion: 'All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON''T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: ''Ready for Review''→HALT'
352
339
  dependencies:
353
340
  tasks:
354
- - execute-checklist
355
- - validate-next-story
341
+ - execute-checklist.md
342
+ - validate-next-story.md
356
343
  checklists:
357
- - story-dod-checklist
344
+ - story-dod-checklist.md
358
345
  ```
359
346
  ==================== END: .bmad-core/agents/dev.md ====================
360
347
 
@@ -369,6 +356,7 @@ activation-instructions:
369
356
  - Only read the files/tasks listed here when user selects them for execution to minimize context usage
370
357
  - The customization field ALWAYS takes precedence over any conflicting instructions
371
358
  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
359
+ - Greet the user with your name and role, and inform of the *help command.
372
360
  agent:
373
361
  name: Quinn
374
362
  id: qa
@@ -392,8 +380,6 @@ persona:
392
380
  - Risk-Based Testing - Prioritize testing based on risk and critical areas
393
381
  - Continuous Improvement - Balance perfection with pragmatism
394
382
  - Architecture & Design Patterns - Ensure proper patterns and maintainable code structure
395
- startup:
396
- - Greet the user with your name and role, and inform of the *help command.
397
383
  story-file-permissions:
398
384
  - CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files
399
385
  - CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections
@@ -405,11 +391,11 @@ commands:
405
391
  - exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
406
392
  dependencies:
407
393
  tasks:
408
- - review-story
394
+ - review-story.md
409
395
  data:
410
- - technical-preferences
411
- utils:
412
- - template-format
396
+ - technical-preferences.md
397
+ templates:
398
+ - story-tmpl.yaml
413
399
  ```
414
400
  ==================== END: .bmad-core/agents/qa.md ====================
415
401
 
@@ -534,97 +520,85 @@ Choose a number (0-8) or 9 to proceed:
534
520
  ==================== END: .bmad-core/tasks/advanced-elicitation.md ====================
535
521
 
536
522
  ==================== START: .bmad-core/tasks/create-doc.md ====================
537
- # Create Document from Template Task
523
+ # Create Document from Template (YAML Driven)
538
524
 
539
- ## Purpose
540
-
541
- Generate documents from templates by EXECUTING (not just reading) embedded instructions from the perspective of the selected agent persona.
542
-
543
- ## CRITICAL RULES
544
-
545
- 1. **Templates are PROGRAMS** - Execute every [[LLM:]] instruction exactly as written
546
- 2. **NEVER show markup** - Hide all [[LLM:]], {{placeholders}}, @{examples}, and template syntax
547
- 3. **STOP and EXECUTE** - When you see "apply tasks#" or "execute tasks#", STOP and run that task immediately
548
- 4. **WAIT for user input** - At review points and after elicitation tasks
525
+ ## CRITICAL: Mandatory Elicitation Format
549
526
 
550
- ## Execution Flow
551
-
552
- ### 0. Check Workflow Plan (if configured)
527
+ **When `elicit: true`, ALWAYS use this exact format:**
553
528
 
554
- [[LLM: Check if plan tracking is enabled in core-config.yaml]]
529
+ 1. Present section content
530
+ 2. Provide detailed rationale (explain trade-offs, assumptions, decisions made)
531
+ 3. Present numbered options 1-9:
532
+ - **Option 1:** Always "Proceed to next section"
533
+ - **Options 2-9:** Select 8 methods from data/elicitation-methods
534
+ - End with: "Select 1-9 or just type your question/feedback:"
555
535
 
556
- - If `workflow.trackProgress: true`, check for active plan using .bmad-core/utils/plan-management.md
557
- - If plan exists and this document creation is part of the plan:
558
- - Verify this is the expected next step
559
- - If out of sequence and `enforceSequence: true`, warn user and halt without user override
560
- - If out of sequence and `enforceSequence: false`, ask for confirmation
561
- - Continue with normal execution after plan check
536
+ **NEVER ask yes/no questions or use any other format.**
562
537
 
563
- ### 1. Identify Template
538
+ ## Processing Flow
564
539
 
565
- - Load from `.bmad-core/templates/*.md` or `.bmad-core/templates directory`
566
- - Agent-specific templates are listed in agent's dependencies
567
- - If agent has `templates: [prd-tmpl, architecture-tmpl]` for example, then offer to create "PRD" and "Architecture" documents
540
+ 1. **Parse YAML template** - Load template metadata and sections
541
+ 2. **Set preferences** - Show current mode (Interactive), confirm output file
542
+ 3. **Process each section:**
543
+ - Skip if condition unmet
544
+ - Check agent permissions (owner/editors) - note if section is restricted to specific agents
545
+ - Draft content using section instruction
546
+ - Present content + detailed rationale
547
+ - **IF elicit: true** → MANDATORY 1-9 options format
548
+ - Save to file if possible
549
+ 4. **Continue until complete**
568
550
 
569
- ### 2. Ask Interaction Mode
551
+ ## Detailed Rationale Requirements
570
552
 
571
- > 1. **Incremental** - Section by section with reviews
572
- > 2. **YOLO Mode** - Complete draft then review (user can type `/yolo` anytime to switch)
553
+ When presenting section content, ALWAYS include rationale that explains:
573
554
 
574
- ### 3. Execute Template
555
+ - Trade-offs and choices made (what was chosen over alternatives and why)
556
+ - Key assumptions made during drafting
557
+ - Interesting or questionable decisions that need user attention
558
+ - Areas that might need validation
575
559
 
576
- - Replace {{placeholders}} with real content
577
- - Execute [[LLM:]] instructions as you encounter them
578
- - Process <<REPEAT>> loops and ^^CONDITIONS^^
579
- - Use @{examples} for guidance but never output them
560
+ ## Elicitation Results Flow
580
561
 
581
- ### 4. Key Execution Patterns
562
+ After user selects elicitation method (2-9):
582
563
 
583
- **When you see:** `[[LLM: Draft X and immediately execute .bmad-core/tasks/advanced-elicitation.md]]`
584
-
585
- - Draft the content
586
- - Present it to user
587
- - IMMEDIATELY execute the task
588
- - Wait for completion before continuing
564
+ 1. Execute method from data/elicitation-methods
565
+ 2. Present results with insights
566
+ 3. Offer options:
567
+ - **1. Apply changes and update section**
568
+ - **2. Return to elicitation menu**
569
+ - **3. Ask any questions or engage further with this elicitation**
589
570
 
590
- **When you see:** `[[LLM: After section completion, apply .bmad-core/tasks/Y.md]]`
571
+ ## Agent Permissions
591
572
 
592
- - Finish the section
593
- - STOP and execute the task
594
- - Wait for user input
573
+ When processing sections with agent permission fields:
595
574
 
596
- ### 5. Validation & Final Presentation
575
+ - **owner**: Note which agent role initially creates/populates the section
576
+ - **editors**: List agent roles allowed to modify the section
577
+ - **readonly**: Mark sections that cannot be modified after creation
597
578
 
598
- - Run any specified checklists
599
- - Present clean, formatted content only
600
- - No truncation or summarization
601
- - Begin directly with content (no preamble)
602
- - Include any handoff prompts from template
579
+ **For sections with restricted access:**
603
580
 
604
- ### 6. Update Workflow Plan (if applicable)
581
+ - Include a note in the generated document indicating the responsible agent
582
+ - Example: "_(This section is owned by dev-agent and can only be modified by dev-agent)_"
605
583
 
606
- [[LLM: After successful document creation]]
584
+ ## YOLO Mode
607
585
 
608
- - If plan tracking is enabled and document was part of plan:
609
- - Call update-workflow-plan task to mark step complete
610
- - Parameters: task: create-doc, step_id: {from plan}, status: complete
611
- - Show next recommended step from plan
586
+ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
612
587
 
613
- ## Common Mistakes to Avoid
588
+ ## CRITICAL REMINDERS
614
589
 
615
- Skipping elicitation tasks
616
- ❌ Showing template markup to users
617
- ❌ Continuing past STOP signals
618
- ❌ Combining multiple review points
590
+ **❌ NEVER:**
619
591
 
620
- Execute ALL instructions in sequence
621
- Present only clean, formatted content
622
- Stop at every elicitation point
623
- ✅ Wait for user confirmation when instructed
592
+ - Ask yes/no questions for elicitation
593
+ - Use any format other than 1-9 numbered options
594
+ - Create new elicitation methods
624
595
 
625
- ## Remember
596
+ **✅ ALWAYS:**
626
597
 
627
- Templates contain precise instructions for a reason. Follow them exactly to ensure document quality and completeness.
598
+ - Use exact 1-9 format when elicit: true
599
+ - Select options 2-9 from data/elicitation-methods only
600
+ - Provide detailed rationale explaining decisions
601
+ - End with "Select 1-9 or just type your question/feedback:"
628
602
  ==================== END: .bmad-core/tasks/create-doc.md ====================
629
603
 
630
604
  ==================== START: .bmad-core/tasks/create-workflow-plan.md ====================
@@ -2056,6 +2030,143 @@ Use the **expansion-creator** pack to build your own:
2056
2030
  - **Contributing**: See `CONTRIBUTING.md` for full guidelines
2057
2031
  ==================== END: .bmad-core/data/bmad-kb.md ====================
2058
2032
 
2033
+ ==================== START: .bmad-core/data/elicitation-methods.md ====================
2034
+ # Elicitation Methods Data
2035
+
2036
+ ## Core Reflective Methods
2037
+
2038
+ **Expand or Contract for Audience**
2039
+ - Ask whether to 'expand' (add detail, elaborate) or 'contract' (simplify, clarify)
2040
+ - Identify specific target audience if relevant
2041
+ - Tailor content complexity and depth accordingly
2042
+
2043
+ **Explain Reasoning (CoT Step-by-Step)**
2044
+ - Walk through the step-by-step thinking process
2045
+ - Reveal underlying assumptions and decision points
2046
+ - Show how conclusions were reached from current role's perspective
2047
+
2048
+ **Critique and Refine**
2049
+ - Review output for flaws, inconsistencies, or improvement areas
2050
+ - Identify specific weaknesses from role's expertise
2051
+ - Suggest refined version reflecting domain knowledge
2052
+
2053
+ ## Structural Analysis Methods
2054
+
2055
+ **Analyze Logical Flow and Dependencies**
2056
+ - Examine content structure for logical progression
2057
+ - Check internal consistency and coherence
2058
+ - Identify and validate dependencies between elements
2059
+ - Confirm effective ordering and sequencing
2060
+
2061
+ **Assess Alignment with Overall Goals**
2062
+ - Evaluate content contribution to stated objectives
2063
+ - Identify any misalignments or gaps
2064
+ - Interpret alignment from specific role's perspective
2065
+ - Suggest adjustments to better serve goals
2066
+
2067
+ ## Risk and Challenge Methods
2068
+
2069
+ **Identify Potential Risks and Unforeseen Issues**
2070
+ - Brainstorm potential risks from role's expertise
2071
+ - Identify overlooked edge cases or scenarios
2072
+ - Anticipate unintended consequences
2073
+ - Highlight implementation challenges
2074
+
2075
+ **Challenge from Critical Perspective**
2076
+ - Adopt critical stance on current content
2077
+ - Play devil's advocate from specified viewpoint
2078
+ - Argue against proposal highlighting weaknesses
2079
+ - Apply YAGNI principles when appropriate (scope trimming)
2080
+
2081
+ ## Creative Exploration Methods
2082
+
2083
+ **Tree of Thoughts Deep Dive**
2084
+ - Break problem into discrete "thoughts" or intermediate steps
2085
+ - Explore multiple reasoning paths simultaneously
2086
+ - Use self-evaluation to classify each path as "sure", "likely", or "impossible"
2087
+ - Apply search algorithms (BFS/DFS) to find optimal solution paths
2088
+
2089
+ **Hindsight is 20/20: The 'If Only...' Reflection**
2090
+ - Imagine retrospective scenario based on current content
2091
+ - Identify the one "if only we had known/done X..." insight
2092
+ - Describe imagined consequences humorously or dramatically
2093
+ - Extract actionable learnings for current context
2094
+
2095
+ ## Multi-Persona Collaboration Methods
2096
+
2097
+ **Agile Team Perspective Shift**
2098
+ - Rotate through different Scrum team member viewpoints
2099
+ - Product Owner: Focus on user value and business impact
2100
+ - Scrum Master: Examine process flow and team dynamics
2101
+ - Developer: Assess technical implementation and complexity
2102
+ - QA: Identify testing scenarios and quality concerns
2103
+
2104
+ **Stakeholder Round Table**
2105
+ - Convene virtual meeting with multiple personas
2106
+ - Each persona contributes unique perspective on content
2107
+ - Identify conflicts and synergies between viewpoints
2108
+ - Synthesize insights into actionable recommendations
2109
+
2110
+ **Meta-Prompting Analysis**
2111
+ - Step back to analyze the structure and logic of current approach
2112
+ - Question the format and methodology being used
2113
+ - Suggest alternative frameworks or mental models
2114
+ - Optimize the elicitation process itself
2115
+
2116
+ ## Advanced 2025 Techniques
2117
+
2118
+ **Self-Consistency Validation**
2119
+ - Generate multiple reasoning paths for same problem
2120
+ - Compare consistency across different approaches
2121
+ - Identify most reliable and robust solution
2122
+ - Highlight areas where approaches diverge and why
2123
+
2124
+ **ReWOO (Reasoning Without Observation)**
2125
+ - Separate parametric reasoning from tool-based actions
2126
+ - Create reasoning plan without external dependencies
2127
+ - Identify what can be solved through pure reasoning
2128
+ - Optimize for efficiency and reduced token usage
2129
+
2130
+ **Persona-Pattern Hybrid**
2131
+ - Combine specific role expertise with elicitation pattern
2132
+ - Architect + Risk Analysis: Deep technical risk assessment
2133
+ - UX Expert + User Journey: End-to-end experience critique
2134
+ - PM + Stakeholder Analysis: Multi-perspective impact review
2135
+
2136
+ **Emergent Collaboration Discovery**
2137
+ - Allow multiple perspectives to naturally emerge
2138
+ - Identify unexpected insights from persona interactions
2139
+ - Explore novel combinations of viewpoints
2140
+ - Capture serendipitous discoveries from multi-agent thinking
2141
+
2142
+ ## Game-Based Elicitation Methods
2143
+
2144
+ **Red Team vs Blue Team**
2145
+ - Red Team: Attack the proposal, find vulnerabilities
2146
+ - Blue Team: Defend and strengthen the approach
2147
+ - Competitive analysis reveals blind spots
2148
+ - Results in more robust, battle-tested solutions
2149
+
2150
+ **Innovation Tournament**
2151
+ - Pit multiple alternative approaches against each other
2152
+ - Score each approach across different criteria
2153
+ - Crowd-source evaluation from different personas
2154
+ - Identify winning combination of features
2155
+
2156
+ **Escape Room Challenge**
2157
+ - Present content as constraints to work within
2158
+ - Find creative solutions within tight limitations
2159
+ - Identify minimum viable approach
2160
+ - Discover innovative workarounds and optimizations
2161
+
2162
+ ## Process Control
2163
+
2164
+ **Proceed / No Further Actions**
2165
+ - Acknowledge choice to finalize current work
2166
+ - Accept output as-is or move to next step
2167
+ - Prepare to continue without additional elicitation
2168
+ ==================== END: .bmad-core/data/elicitation-methods.md ====================
2169
+
2059
2170
  ==================== START: .bmad-core/utils/plan-management.md ====================
2060
2171
  # Plan Management Utility
2061
2172
 
@@ -3195,66 +3306,145 @@ Provide a structured validation report including:
3195
3306
  - **Confidence Level**: High/Medium/Low for successful implementation
3196
3307
  ==================== END: .bmad-core/tasks/validate-next-story.md ====================
3197
3308
 
3198
- ==================== START: .bmad-core/templates/story-tmpl.md ====================
3199
- ---
3200
- defaultOutput: docs/stories/{{EpicNum}}.{{StoryNum}}.{{Short Title Copied from Epic File specific story}}.md
3201
- smAgent:
3202
- editableSections: Status, Story, Acceptance Criteria, Tasks / Subtasks, Dev Notes, Testing, Change Log
3203
- sectionSpecificInstructions:
3204
- "Dev Notes":
3205
- - Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story
3206
- - Do not invent information.
3207
- - If known add Relevant Source Tree info that relates to this story.
3208
- - If there were important notes from previous story that are relevant to this one, include them here.
3209
- - Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks.
3210
- Testing:
3211
- - List Relevant Testing Standards from Architecture the Developer needs to conform to (test file location, test standards, etc)
3212
- ---
3213
-
3214
- # Story {{EpicNum}}.{{StoryNum}}: {{Short Title Copied from Epic File specific story}}
3215
-
3216
- ## Status: {{ Draft | Approved | InProgress | Review | Done }}
3217
-
3218
- ## Story
3219
-
3220
- **As a** {{role}},\
3221
- **I want** {{action}},\
3222
- **so that** {{benefit}}
3223
-
3224
- ## Acceptance Criteria
3225
-
3226
- {{ Copy of Acceptance Criteria numbered list }}
3227
-
3228
- ## Tasks / Subtasks
3229
-
3230
- - [ ] Task 1 (AC: # if applicable)
3231
- - [ ] Subtask1.1...
3232
- - [ ] Task 2 (AC: # if applicable)
3233
- - [ ] Subtask 2.1...
3234
- - [ ] Task 3 (AC: # if applicable)
3235
- - [ ] Subtask 3.1...
3236
-
3237
- ## Dev Notes
3238
-
3239
- ### Testing
3240
-
3241
- ## Change Log
3242
-
3243
- | Date | Version | Description | Author |
3244
- | :--- | :------ | :---------- | :----- |
3245
-
3246
- ## Dev Agent Record
3247
-
3248
- ### Agent Model Used: {{Agent Model Name/Version}}
3249
-
3250
- ### Debug Log References
3251
-
3252
- ### Completion Notes List
3253
-
3254
- ### File List
3255
-
3256
- ## QA Results
3257
- ==================== END: .bmad-core/templates/story-tmpl.md ====================
3309
+ ==================== START: .bmad-core/templates/story-tmpl.yaml ====================
3310
+ template:
3311
+ id: story-template-v2
3312
+ name: Story Document
3313
+ version: 2.0
3314
+ output:
3315
+ format: markdown
3316
+ filename: docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md
3317
+ title: "Story {{epic_num}}.{{story_num}}: {{story_title_short}}"
3318
+
3319
+ workflow:
3320
+ mode: interactive
3321
+ elicitation: advanced-elicitation
3322
+
3323
+ agent_config:
3324
+ editable_sections:
3325
+ - Status
3326
+ - Story
3327
+ - Acceptance Criteria
3328
+ - Tasks / Subtasks
3329
+ - Dev Notes
3330
+ - Testing
3331
+ - Change Log
3332
+
3333
+ sections:
3334
+ - id: status
3335
+ title: Status
3336
+ type: choice
3337
+ choices: [Draft, Approved, InProgress, Review, Done]
3338
+ instruction: Select the current status of the story
3339
+ owner: scrum-master
3340
+ editors: [scrum-master, dev-agent]
3341
+
3342
+ - id: story
3343
+ title: Story
3344
+ type: template-text
3345
+ template: |
3346
+ **As a** {{role}},
3347
+ **I want** {{action}},
3348
+ **so that** {{benefit}}
3349
+ instruction: Define the user story using the standard format with role, action, and benefit
3350
+ elicit: true
3351
+ owner: scrum-master
3352
+ editors: [scrum-master]
3353
+
3354
+ - id: acceptance-criteria
3355
+ title: Acceptance Criteria
3356
+ type: numbered-list
3357
+ instruction: Copy the acceptance criteria numbered list from the epic file
3358
+ elicit: true
3359
+ owner: scrum-master
3360
+ editors: [scrum-master]
3361
+
3362
+ - id: tasks-subtasks
3363
+ title: Tasks / Subtasks
3364
+ type: bullet-list
3365
+ instruction: |
3366
+ Break down the story into specific tasks and subtasks needed for implementation.
3367
+ Reference applicable acceptance criteria numbers where relevant.
3368
+ template: |
3369
+ - [ ] Task 1 (AC: # if applicable)
3370
+ - [ ] Subtask1.1...
3371
+ - [ ] Task 2 (AC: # if applicable)
3372
+ - [ ] Subtask 2.1...
3373
+ - [ ] Task 3 (AC: # if applicable)
3374
+ - [ ] Subtask 3.1...
3375
+ elicit: true
3376
+ owner: scrum-master
3377
+ editors: [scrum-master, dev-agent]
3378
+
3379
+ - id: dev-notes
3380
+ title: Dev Notes
3381
+ instruction: |
3382
+ Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story:
3383
+ - Do not invent information
3384
+ - If known add Relevant Source Tree info that relates to this story
3385
+ - If there were important notes from previous story that are relevant to this one, include them here
3386
+ - Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks
3387
+ elicit: true
3388
+ owner: scrum-master
3389
+ editors: [scrum-master]
3390
+ sections:
3391
+ - id: testing-standards
3392
+ title: Testing
3393
+ instruction: |
3394
+ List Relevant Testing Standards from Architecture the Developer needs to conform to:
3395
+ - Test file location
3396
+ - Test standards
3397
+ - Testing frameworks and patterns to use
3398
+ - Any specific testing requirements for this story
3399
+ elicit: true
3400
+ owner: scrum-master
3401
+ editors: [scrum-master]
3402
+
3403
+ - id: change-log
3404
+ title: Change Log
3405
+ type: table
3406
+ columns: [Date, Version, Description, Author]
3407
+ instruction: Track changes made to this story document
3408
+ owner: scrum-master
3409
+ editors: [scrum-master, dev-agent, qa-agent]
3410
+
3411
+ - id: dev-agent-record
3412
+ title: Dev Agent Record
3413
+ instruction: This section is populated by the development agent during implementation
3414
+ owner: dev-agent
3415
+ editors: [dev-agent]
3416
+ sections:
3417
+ - id: agent-model
3418
+ title: Agent Model Used
3419
+ template: "{{agent_model_name_version}}"
3420
+ instruction: Record the specific AI agent model and version used for development
3421
+ owner: dev-agent
3422
+ editors: [dev-agent]
3423
+
3424
+ - id: debug-log-references
3425
+ title: Debug Log References
3426
+ instruction: Reference any debug logs or traces generated during development
3427
+ owner: dev-agent
3428
+ editors: [dev-agent]
3429
+
3430
+ - id: completion-notes
3431
+ title: Completion Notes List
3432
+ instruction: Notes about the completion of tasks and any issues encountered
3433
+ owner: dev-agent
3434
+ editors: [dev-agent]
3435
+
3436
+ - id: file-list
3437
+ title: File List
3438
+ instruction: List all files created, modified, or affected during story implementation
3439
+ owner: dev-agent
3440
+ editors: [dev-agent]
3441
+
3442
+ - id: qa-results
3443
+ title: QA Results
3444
+ instruction: Results from QA Agent QA review of the completed story implementation
3445
+ owner: qa-agent
3446
+ editors: [qa-agent]
3447
+ ==================== END: .bmad-core/templates/story-tmpl.yaml ====================
3258
3448
 
3259
3449
  ==================== START: .bmad-core/checklists/po-master-checklist.md ====================
3260
3450
  # Product Owner (PO) Master Validation Checklist