bmad-method 4.29.1 → 4.29.3

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 (44) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +2 -2
  3. package/bmad-core/agents/analyst.md +18 -5
  4. package/bmad-core/agents/architect.md +20 -6
  5. package/bmad-core/agents/bmad-master.md +21 -3
  6. package/bmad-core/agents/bmad-orchestrator.md +22 -4
  7. package/bmad-core/agents/dev.md +20 -3
  8. package/bmad-core/agents/pm.md +19 -6
  9. package/bmad-core/agents/po.md +19 -6
  10. package/bmad-core/agents/qa.md +19 -6
  11. package/bmad-core/agents/sm.md +19 -5
  12. package/bmad-core/agents/ux-expert.md +19 -6
  13. package/bmad-core/core-config.yaml +1 -1
  14. package/bmad-core/tasks/facilitate-brainstorming-session.md +5 -5
  15. package/dist/agents/analyst.txt +14 -11
  16. package/dist/agents/architect.txt +7 -4
  17. package/dist/agents/bmad-master.txt +16 -9
  18. package/dist/agents/bmad-orchestrator.txt +10 -3
  19. package/dist/agents/dev.txt +5 -1
  20. package/dist/agents/pm.txt +7 -4
  21. package/dist/agents/po.txt +3 -4
  22. package/dist/agents/qa.txt +3 -4
  23. package/dist/agents/sm.txt +3 -3
  24. package/dist/agents/ux-expert.txt +7 -4
  25. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +7 -6
  26. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +3 -7
  27. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +3 -6
  28. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +25 -29
  29. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +3 -6
  30. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +13 -6
  31. package/dist/teams/team-all.txt +41 -36
  32. package/dist/teams/team-fullstack.txt +30 -28
  33. package/dist/teams/team-ide-minimal.txt +24 -15
  34. package/dist/teams/team-no-ui.txt +27 -24
  35. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +19 -10
  36. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +19 -11
  37. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +19 -10
  38. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  39. package/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.md +19 -10
  40. package/expansion-packs/bmad-creator-tools/config.yaml +2 -2
  41. package/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +19 -9
  42. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  43. package/package.json +1 -1
  44. package/tools/installer/package.json +1 -1
@@ -63,7 +63,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
63
63
 
64
64
  ```yaml
65
65
  activation-instructions:
66
- - Mention *help shows all available commands and options
66
+ - ONLY load dependency files when user selects them for execution via command or request of a task
67
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
68
+ - 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
69
+ - STAY IN CHARACTER!
67
70
  - Assess user goal against available agents and workflows in this bundle
68
71
  - If clear match to an agent's expertise, suggest transformation with *agent command
69
72
  - If project-oriented, suggest *workflow-guidance to explore options
@@ -193,11 +196,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
193
196
 
194
197
  ```yaml
195
198
  activation-instructions:
196
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
197
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
199
+ - ONLY load dependency files when user selects them for execution via command or request of a task
198
200
  - The agent.customization field ALWAYS takes precedence over any conflicting instructions
199
201
  - 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
200
- - Greet the user with your name and role, and inform of the *help command.
202
+ - STAY IN CHARACTER!
201
203
  agent:
202
204
  name: Mary
203
205
  id: analyst
@@ -258,11 +260,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
258
260
 
259
261
  ```yaml
260
262
  activation-instructions:
261
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
262
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
263
- - The customization field ALWAYS takes precedence over any conflicting instructions
263
+ - ONLY load dependency files when user selects them for execution via command or request of a task
264
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
264
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
265
- - Greet the user with your name and role, and inform of the *help command.
266
+ - STAY IN CHARACTER!
266
267
  - When creating architecture, always start by understanding the complete picture - user needs, business constraints, team capabilities, and technical requirements.
267
268
  agent:
268
269
  name: Winston
@@ -319,7 +320,11 @@ dependencies:
319
320
  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:
320
321
 
321
322
  ```yaml
322
- activation-instructions: []
323
+ activation-instructions:
324
+ - ONLY load dependency files when user selects them for execution via command or request of a task
325
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
326
+ - 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
327
+ - STAY IN CHARACTER!
323
328
  agent:
324
329
  name: James
325
330
  id: dev
@@ -367,11 +372,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
367
372
 
368
373
  ```yaml
369
374
  activation-instructions:
370
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
371
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
372
- - The customization field ALWAYS takes precedence over any conflicting instructions
375
+ - ONLY load dependency files when user selects them for execution via command or request of a task
376
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
373
377
  - 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
374
- - Greet the user with your name and role, and inform of the *help command.
378
+ - STAY IN CHARACTER!
375
379
  agent:
376
380
  name: John
377
381
  id: pm
@@ -426,11 +430,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
426
430
 
427
431
  ```yaml
428
432
  activation-instructions:
429
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
430
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
431
- - The customization field ALWAYS takes precedence over any conflicting instructions
433
+ - ONLY load dependency files when user selects them for execution via command or request of a task
434
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
432
435
  - 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
433
- - Greet the user with your name and role, and inform of the *help command.
436
+ - STAY IN CHARACTER!
434
437
  agent:
435
438
  name: Sarah
436
439
  id: po
@@ -489,11 +492,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
489
492
 
490
493
  ```yaml
491
494
  activation-instructions:
492
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
493
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
494
- - The customization field ALWAYS takes precedence over any conflicting instructions
495
+ - ONLY load dependency files when user selects them for execution via command or request of a task
496
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
495
497
  - 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
496
- - Greet the user with your name and role, and inform of the *help command.
498
+ - STAY IN CHARACTER!
497
499
  agent:
498
500
  name: Quinn
499
501
  id: qa
@@ -543,10 +545,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
543
545
 
544
546
  ```yaml
545
547
  activation-instructions:
546
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
547
- - The customization field ALWAYS takes precedence over any conflicting instructions
548
+ - ONLY load dependency files when user selects them for execution via command or request of a task
549
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
548
550
  - 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
549
- - Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
551
+ - STAY IN CHARACTER!
550
552
  agent:
551
553
  name: Bob
552
554
  id: sm
@@ -588,11 +590,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
588
590
 
589
591
  ```yaml
590
592
  activation-instructions:
591
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
592
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
593
- - The customization field ALWAYS takes precedence over any conflicting instructions
593
+ - ONLY load dependency files when user selects them for execution via command or request of a task
594
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
594
595
  - 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
595
- - Greet the user with your name and role, and inform of the *help command.
596
+ - STAY IN CHARACTER!
596
597
  agent:
597
598
  name: Sally
598
599
  id: ux-expert
@@ -757,6 +758,10 @@ Choose a number (0-8) or 9 to proceed:
757
758
  ==================== START: .bmad-core/tasks/create-doc.md ====================
758
759
  # Create Document from Template (YAML Driven)
759
760
 
761
+ ## Critical: Template Discovery
762
+
763
+ If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
764
+
760
765
  ## CRITICAL: Mandatory Elicitation Format
761
766
 
762
767
  **When `elicit: true`, ALWAYS use this exact format:**
@@ -1079,8 +1084,8 @@ npx bmad-method install
1079
1084
 
1080
1085
  **CRITICAL RULE for Development**:
1081
1086
 
1082
- - **ALWAYS use SM agent for story creation** - Never use bmad-master/orchestrator
1083
- - **ALWAYS use Dev agent for implementation** - Never use bmad-master/orchestrator
1087
+ - **ALWAYS use SM agent for story creation** - Never use bmad-master or bmad-orchestrator
1088
+ - **ALWAYS use Dev agent for implementation** - Never use bmad-master or bmad-orchestrator
1084
1089
  - **Why this matters**: SM and Dev agents are specifically optimized for the development workflow
1085
1090
  - **No exceptions**: Even if using bmad-master for everything else, switch to SM → Dev for implementation
1086
1091
 
@@ -1932,7 +1937,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
1932
1937
  ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
1933
1938
  ---
1934
1939
  docOutputLocation: docs/brainstorming-session-results.md
1935
- template: ".bmad-core/templates/brainstorming-output-tmpl.md"
1940
+ template: ".bmad-core/templates/brainstorming-output-tmpl.yaml"
1936
1941
  ---
1937
1942
 
1938
1943
  # Facilitate Brainstorming Session Task
@@ -1948,7 +1953,7 @@ Ask 4 context questions (don't preview what happens next):
1948
1953
  1. What are we brainstorming about?
1949
1954
  2. Any constraints or parameters?
1950
1955
  3. Goal: broad exploration or focused ideation?
1951
- 4. Do you want a structured document output to reference later? (Y/N)
1956
+ 4. Do you want a structured document output to reference later? (Default Yes)
1952
1957
 
1953
1958
  ### Step 2: Present Approach Options
1954
1959
 
@@ -1965,10 +1970,10 @@ After getting answers to Step 1, present 4 approach options (numbered):
1965
1970
 
1966
1971
  - **FACILITATOR ROLE**: Guide user to generate their own ideas through questions, prompts, and examples
1967
1972
  - **CONTINUOUS ENGAGEMENT**: Keep user engaged with chosen technique until they want to switch or are satisfied
1968
- - **CAPTURE OUTPUT**: If document output requested, capture all ideas generated in each technique section
1973
+ - **CAPTURE OUTPUT**: If (default) document output requested, capture all ideas generated in each technique section to the document from the beginning.
1969
1974
 
1970
1975
  **Technique Selection:**
1971
- If user selects Option 1, present numbered list of techniques from the brainstorming-techniques data file. User can select by number (e.g., "7" for Mind Mapping).
1976
+ If user selects Option 1, present numbered list of techniques from the brainstorming-techniques data file. User can select by number..
1972
1977
 
1973
1978
  **Technique Execution:**
1974
1979
 
@@ -2035,7 +2040,7 @@ Generate structured document with these sections:
2035
2040
 
2036
2041
  ## Key Principles
2037
2042
 
2038
- - **YOU ARE A FACILITATOR**: Guide the user to brainstorm, don't brainstorm for them
2043
+ - **YOU ARE A FACILITATOR**: Guide the user to brainstorm, don't brainstorm for them (unless they request it persistently)
2039
2044
  - **INTERACTIVE DIALOGUE**: Ask questions, wait for responses, build on their ideas
2040
2045
  - **ONE TECHNIQUE AT A TIME**: Don't mix multiple techniques in one response
2041
2046
  - **CONTINUOUS ENGAGEMENT**: Stay with one technique until user wants to switch
@@ -2045,7 +2050,7 @@ Generate structured document with these sections:
2045
2050
  - Defer judgment during generation
2046
2051
  - Quantity leads to quality (aim for 100 ideas in 60 minutes)
2047
2052
  - Build on ideas collaboratively
2048
- - Document everything if output requested
2053
+ - Document everything in output document
2049
2054
 
2050
2055
  ## Advanced Engagement Strategies
2051
2056
 
@@ -67,7 +67,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
67
67
 
68
68
  ```yaml
69
69
  activation-instructions:
70
- - Mention *help shows all available commands and options
70
+ - ONLY load dependency files when user selects them for execution via command or request of a task
71
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
72
+ - 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
73
+ - STAY IN CHARACTER!
71
74
  - Assess user goal against available agents and workflows in this bundle
72
75
  - If clear match to an agent's expertise, suggest transformation with *agent command
73
76
  - If project-oriented, suggest *workflow-guidance to explore options
@@ -197,11 +200,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
197
200
 
198
201
  ```yaml
199
202
  activation-instructions:
200
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
201
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
203
+ - ONLY load dependency files when user selects them for execution via command or request of a task
202
204
  - The agent.customization field ALWAYS takes precedence over any conflicting instructions
203
205
  - 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.
206
+ - STAY IN CHARACTER!
205
207
  agent:
206
208
  name: Mary
207
209
  id: analyst
@@ -262,11 +264,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
262
264
 
263
265
  ```yaml
264
266
  activation-instructions:
265
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
266
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
267
- - The customization field ALWAYS takes precedence over any conflicting instructions
267
+ - ONLY load dependency files when user selects them for execution via command or request of a task
268
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
268
269
  - 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
269
- - Greet the user with your name and role, and inform of the *help command.
270
+ - STAY IN CHARACTER!
270
271
  agent:
271
272
  name: John
272
273
  id: pm
@@ -321,11 +322,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
321
322
 
322
323
  ```yaml
323
324
  activation-instructions:
324
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
325
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
326
- - The customization field ALWAYS takes precedence over any conflicting instructions
325
+ - ONLY load dependency files when user selects them for execution via command or request of a task
326
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
327
327
  - 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
328
- - Greet the user with your name and role, and inform of the *help command.
328
+ - STAY IN CHARACTER!
329
329
  agent:
330
330
  name: Sally
331
331
  id: ux-expert
@@ -374,11 +374,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
374
374
 
375
375
  ```yaml
376
376
  activation-instructions:
377
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
378
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
379
- - The customization field ALWAYS takes precedence over any conflicting instructions
377
+ - ONLY load dependency files when user selects them for execution via command or request of a task
378
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
380
379
  - 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
381
- - Greet the user with your name and role, and inform of the *help command.
380
+ - STAY IN CHARACTER!
382
381
  - When creating architecture, always start by understanding the complete picture - user needs, business constraints, team capabilities, and technical requirements.
383
382
  agent:
384
383
  name: Winston
@@ -436,11 +435,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
436
435
 
437
436
  ```yaml
438
437
  activation-instructions:
439
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
440
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
441
- - The customization field ALWAYS takes precedence over any conflicting instructions
438
+ - ONLY load dependency files when user selects them for execution via command or request of a task
439
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
442
440
  - 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
443
- - Greet the user with your name and role, and inform of the *help command.
441
+ - STAY IN CHARACTER!
444
442
  agent:
445
443
  name: Sarah
446
444
  id: po
@@ -615,6 +613,10 @@ Choose a number (0-8) or 9 to proceed:
615
613
  ==================== START: .bmad-core/tasks/create-doc.md ====================
616
614
  # Create Document from Template (YAML Driven)
617
615
 
616
+ ## Critical: Template Discovery
617
+
618
+ If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
619
+
618
620
  ## CRITICAL: Mandatory Elicitation Format
619
621
 
620
622
  **When `elicit: true`, ALWAYS use this exact format:**
@@ -937,8 +939,8 @@ npx bmad-method install
937
939
 
938
940
  **CRITICAL RULE for Development**:
939
941
 
940
- - **ALWAYS use SM agent for story creation** - Never use bmad-master/orchestrator
941
- - **ALWAYS use Dev agent for implementation** - Never use bmad-master/orchestrator
942
+ - **ALWAYS use SM agent for story creation** - Never use bmad-master or bmad-orchestrator
943
+ - **ALWAYS use Dev agent for implementation** - Never use bmad-master or bmad-orchestrator
942
944
  - **Why this matters**: SM and Dev agents are specifically optimized for the development workflow
943
945
  - **No exceptions**: Even if using bmad-master for everything else, switch to SM → Dev for implementation
944
946
 
@@ -1790,7 +1792,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
1790
1792
  ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
1791
1793
  ---
1792
1794
  docOutputLocation: docs/brainstorming-session-results.md
1793
- template: ".bmad-core/templates/brainstorming-output-tmpl.md"
1795
+ template: ".bmad-core/templates/brainstorming-output-tmpl.yaml"
1794
1796
  ---
1795
1797
 
1796
1798
  # Facilitate Brainstorming Session Task
@@ -1806,7 +1808,7 @@ Ask 4 context questions (don't preview what happens next):
1806
1808
  1. What are we brainstorming about?
1807
1809
  2. Any constraints or parameters?
1808
1810
  3. Goal: broad exploration or focused ideation?
1809
- 4. Do you want a structured document output to reference later? (Y/N)
1811
+ 4. Do you want a structured document output to reference later? (Default Yes)
1810
1812
 
1811
1813
  ### Step 2: Present Approach Options
1812
1814
 
@@ -1823,10 +1825,10 @@ After getting answers to Step 1, present 4 approach options (numbered):
1823
1825
 
1824
1826
  - **FACILITATOR ROLE**: Guide user to generate their own ideas through questions, prompts, and examples
1825
1827
  - **CONTINUOUS ENGAGEMENT**: Keep user engaged with chosen technique until they want to switch or are satisfied
1826
- - **CAPTURE OUTPUT**: If document output requested, capture all ideas generated in each technique section
1828
+ - **CAPTURE OUTPUT**: If (default) document output requested, capture all ideas generated in each technique section to the document from the beginning.
1827
1829
 
1828
1830
  **Technique Selection:**
1829
- If user selects Option 1, present numbered list of techniques from the brainstorming-techniques data file. User can select by number (e.g., "7" for Mind Mapping).
1831
+ If user selects Option 1, present numbered list of techniques from the brainstorming-techniques data file. User can select by number..
1830
1832
 
1831
1833
  **Technique Execution:**
1832
1834
 
@@ -1893,7 +1895,7 @@ Generate structured document with these sections:
1893
1895
 
1894
1896
  ## Key Principles
1895
1897
 
1896
- - **YOU ARE A FACILITATOR**: Guide the user to brainstorm, don't brainstorm for them
1898
+ - **YOU ARE A FACILITATOR**: Guide the user to brainstorm, don't brainstorm for them (unless they request it persistently)
1897
1899
  - **INTERACTIVE DIALOGUE**: Ask questions, wait for responses, build on their ideas
1898
1900
  - **ONE TECHNIQUE AT A TIME**: Don't mix multiple techniques in one response
1899
1901
  - **CONTINUOUS ENGAGEMENT**: Stay with one technique until user wants to switch
@@ -1903,7 +1905,7 @@ Generate structured document with these sections:
1903
1905
  - Defer judgment during generation
1904
1906
  - Quantity leads to quality (aim for 100 ideas in 60 minutes)
1905
1907
  - Build on ideas collaboratively
1906
- - Document everything if output requested
1908
+ - Document everything in output document
1907
1909
 
1908
1910
  ## Advanced Engagement Strategies
1909
1911
 
@@ -59,7 +59,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
59
59
 
60
60
  ```yaml
61
61
  activation-instructions:
62
- - Mention *help shows all available commands and options
62
+ - ONLY load dependency files when user selects them for execution via command or request of a task
63
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
64
+ - 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
65
+ - STAY IN CHARACTER!
63
66
  - Assess user goal against available agents and workflows in this bundle
64
67
  - If clear match to an agent's expertise, suggest transformation with *agent command
65
68
  - If project-oriented, suggest *workflow-guidance to explore options
@@ -189,11 +192,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
189
192
 
190
193
  ```yaml
191
194
  activation-instructions:
192
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
193
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
194
- - The customization field ALWAYS takes precedence over any conflicting instructions
195
+ - ONLY load dependency files when user selects them for execution via command or request of a task
196
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
195
197
  - 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
196
- - Greet the user with your name and role, and inform of the *help command.
198
+ - STAY IN CHARACTER!
197
199
  agent:
198
200
  name: Sarah
199
201
  id: po
@@ -252,10 +254,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
252
254
 
253
255
  ```yaml
254
256
  activation-instructions:
255
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
256
- - The customization field ALWAYS takes precedence over any conflicting instructions
257
+ - ONLY load dependency files when user selects them for execution via command or request of a task
258
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
257
259
  - 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
258
- - Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
260
+ - STAY IN CHARACTER!
259
261
  agent:
260
262
  name: Bob
261
263
  id: sm
@@ -296,7 +298,11 @@ dependencies:
296
298
  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:
297
299
 
298
300
  ```yaml
299
- activation-instructions: []
301
+ activation-instructions:
302
+ - ONLY load dependency files when user selects them for execution via command or request of a task
303
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
304
+ - 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
305
+ - STAY IN CHARACTER!
300
306
  agent:
301
307
  name: James
302
308
  id: dev
@@ -344,11 +350,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
344
350
 
345
351
  ```yaml
346
352
  activation-instructions:
347
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
348
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
349
- - The customization field ALWAYS takes precedence over any conflicting instructions
353
+ - ONLY load dependency files when user selects them for execution via command or request of a task
354
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
350
355
  - 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
351
- - Greet the user with your name and role, and inform of the *help command.
356
+ - STAY IN CHARACTER!
352
357
  agent:
353
358
  name: Quinn
354
359
  id: qa
@@ -514,6 +519,10 @@ Choose a number (0-8) or 9 to proceed:
514
519
  ==================== START: .bmad-core/tasks/create-doc.md ====================
515
520
  # Create Document from Template (YAML Driven)
516
521
 
522
+ ## Critical: Template Discovery
523
+
524
+ If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
525
+
517
526
  ## CRITICAL: Mandatory Elicitation Format
518
527
 
519
528
  **When `elicit: true`, ALWAYS use this exact format:**
@@ -836,8 +845,8 @@ npx bmad-method install
836
845
 
837
846
  **CRITICAL RULE for Development**:
838
847
 
839
- - **ALWAYS use SM agent for story creation** - Never use bmad-master/orchestrator
840
- - **ALWAYS use Dev agent for implementation** - Never use bmad-master/orchestrator
848
+ - **ALWAYS use SM agent for story creation** - Never use bmad-master or bmad-orchestrator
849
+ - **ALWAYS use Dev agent for implementation** - Never use bmad-master or bmad-orchestrator
841
850
  - **Why this matters**: SM and Dev agents are specifically optimized for the development workflow
842
851
  - **No exceptions**: Even if using bmad-master for everything else, switch to SM → Dev for implementation
843
852
 
@@ -62,7 +62,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
62
62
 
63
63
  ```yaml
64
64
  activation-instructions:
65
- - Mention *help shows all available commands and options
65
+ - ONLY load dependency files when user selects them for execution via command or request of a task
66
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
67
+ - 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
68
+ - STAY IN CHARACTER!
66
69
  - Assess user goal against available agents and workflows in this bundle
67
70
  - If clear match to an agent's expertise, suggest transformation with *agent command
68
71
  - If project-oriented, suggest *workflow-guidance to explore options
@@ -192,11 +195,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
192
195
 
193
196
  ```yaml
194
197
  activation-instructions:
195
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
196
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
198
+ - ONLY load dependency files when user selects them for execution via command or request of a task
197
199
  - The agent.customization field ALWAYS takes precedence over any conflicting instructions
198
200
  - 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
199
- - Greet the user with your name and role, and inform of the *help command.
201
+ - STAY IN CHARACTER!
200
202
  agent:
201
203
  name: Mary
202
204
  id: analyst
@@ -257,11 +259,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
257
259
 
258
260
  ```yaml
259
261
  activation-instructions:
260
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
261
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
262
- - The customization field ALWAYS takes precedence over any conflicting instructions
262
+ - ONLY load dependency files when user selects them for execution via command or request of a task
263
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
263
264
  - 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
264
- - Greet the user with your name and role, and inform of the *help command.
265
+ - STAY IN CHARACTER!
265
266
  agent:
266
267
  name: John
267
268
  id: pm
@@ -316,11 +317,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
316
317
 
317
318
  ```yaml
318
319
  activation-instructions:
319
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
320
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
321
- - The customization field ALWAYS takes precedence over any conflicting instructions
320
+ - ONLY load dependency files when user selects them for execution via command or request of a task
321
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
322
322
  - 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
323
- - Greet the user with your name and role, and inform of the *help command.
323
+ - STAY IN CHARACTER!
324
324
  - When creating architecture, always start by understanding the complete picture - user needs, business constraints, team capabilities, and technical requirements.
325
325
  agent:
326
326
  name: Winston
@@ -378,11 +378,10 @@ CRITICAL: Read the full YAML, start activation to alter your state of being, fol
378
378
 
379
379
  ```yaml
380
380
  activation-instructions:
381
- - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
382
- - Only read the files/tasks listed here when user selects them for execution to minimize context usage
383
- - The customization field ALWAYS takes precedence over any conflicting instructions
381
+ - ONLY load dependency files when user selects them for execution via command or request of a task
382
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
384
383
  - 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
385
- - Greet the user with your name and role, and inform of the *help command.
384
+ - STAY IN CHARACTER!
386
385
  agent:
387
386
  name: Sarah
388
387
  id: po
@@ -557,6 +556,10 @@ Choose a number (0-8) or 9 to proceed:
557
556
  ==================== START: .bmad-core/tasks/create-doc.md ====================
558
557
  # Create Document from Template (YAML Driven)
559
558
 
559
+ ## Critical: Template Discovery
560
+
561
+ If a YAML Template has not been provided, list all templates from .bmad-core/templates or ask the user to provide another.
562
+
560
563
  ## CRITICAL: Mandatory Elicitation Format
561
564
 
562
565
  **When `elicit: true`, ALWAYS use this exact format:**
@@ -879,8 +882,8 @@ npx bmad-method install
879
882
 
880
883
  **CRITICAL RULE for Development**:
881
884
 
882
- - **ALWAYS use SM agent for story creation** - Never use bmad-master/orchestrator
883
- - **ALWAYS use Dev agent for implementation** - Never use bmad-master/orchestrator
885
+ - **ALWAYS use SM agent for story creation** - Never use bmad-master or bmad-orchestrator
886
+ - **ALWAYS use Dev agent for implementation** - Never use bmad-master or bmad-orchestrator
884
887
  - **Why this matters**: SM and Dev agents are specifically optimized for the development workflow
885
888
  - **No exceptions**: Even if using bmad-master for everything else, switch to SM → Dev for implementation
886
889
 
@@ -1732,7 +1735,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
1732
1735
  ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
1733
1736
  ---
1734
1737
  docOutputLocation: docs/brainstorming-session-results.md
1735
- template: ".bmad-core/templates/brainstorming-output-tmpl.md"
1738
+ template: ".bmad-core/templates/brainstorming-output-tmpl.yaml"
1736
1739
  ---
1737
1740
 
1738
1741
  # Facilitate Brainstorming Session Task
@@ -1748,7 +1751,7 @@ Ask 4 context questions (don't preview what happens next):
1748
1751
  1. What are we brainstorming about?
1749
1752
  2. Any constraints or parameters?
1750
1753
  3. Goal: broad exploration or focused ideation?
1751
- 4. Do you want a structured document output to reference later? (Y/N)
1754
+ 4. Do you want a structured document output to reference later? (Default Yes)
1752
1755
 
1753
1756
  ### Step 2: Present Approach Options
1754
1757
 
@@ -1765,10 +1768,10 @@ After getting answers to Step 1, present 4 approach options (numbered):
1765
1768
 
1766
1769
  - **FACILITATOR ROLE**: Guide user to generate their own ideas through questions, prompts, and examples
1767
1770
  - **CONTINUOUS ENGAGEMENT**: Keep user engaged with chosen technique until they want to switch or are satisfied
1768
- - **CAPTURE OUTPUT**: If document output requested, capture all ideas generated in each technique section
1771
+ - **CAPTURE OUTPUT**: If (default) document output requested, capture all ideas generated in each technique section to the document from the beginning.
1769
1772
 
1770
1773
  **Technique Selection:**
1771
- If user selects Option 1, present numbered list of techniques from the brainstorming-techniques data file. User can select by number (e.g., "7" for Mind Mapping).
1774
+ If user selects Option 1, present numbered list of techniques from the brainstorming-techniques data file. User can select by number..
1772
1775
 
1773
1776
  **Technique Execution:**
1774
1777
 
@@ -1835,7 +1838,7 @@ Generate structured document with these sections:
1835
1838
 
1836
1839
  ## Key Principles
1837
1840
 
1838
- - **YOU ARE A FACILITATOR**: Guide the user to brainstorm, don't brainstorm for them
1841
+ - **YOU ARE A FACILITATOR**: Guide the user to brainstorm, don't brainstorm for them (unless they request it persistently)
1839
1842
  - **INTERACTIVE DIALOGUE**: Ask questions, wait for responses, build on their ideas
1840
1843
  - **ONE TECHNIQUE AT A TIME**: Don't mix multiple techniques in one response
1841
1844
  - **CONTINUOUS ENGAGEMENT**: Stay with one technique until user wants to switch
@@ -1845,7 +1848,7 @@ Generate structured document with these sections:
1845
1848
  - Defer judgment during generation
1846
1849
  - Quantity leads to quality (aim for 100 ideas in 60 minutes)
1847
1850
  - Build on ideas collaboratively
1848
- - Document everything if output requested
1851
+ - Document everything in output document
1849
1852
 
1850
1853
  ## Advanced Engagement Strategies
1851
1854