bmad-method 4.24.4 → 4.24.5

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 (43) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/bmad-core/agents/analyst.md +1 -1
  3. package/bmad-core/agents/architect.md +1 -1
  4. package/bmad-core/agents/bmad-master.md +1 -1
  5. package/bmad-core/agents/bmad-orchestrator.md +1 -1
  6. package/bmad-core/agents/dev.md +1 -1
  7. package/bmad-core/agents/pm.md +1 -1
  8. package/bmad-core/agents/po.md +1 -1
  9. package/bmad-core/agents/qa.md +1 -1
  10. package/bmad-core/agents/sm.md +1 -1
  11. package/bmad-core/agents/ux-expert.md +1 -1
  12. package/dist/agents/analyst.txt +1 -1
  13. package/dist/agents/architect.txt +1 -1
  14. package/dist/agents/bmad-master.txt +1 -1
  15. package/dist/agents/bmad-orchestrator.txt +1 -1
  16. package/dist/agents/dev.txt +1 -1
  17. package/dist/agents/pm.txt +1 -1
  18. package/dist/agents/po.txt +1 -1
  19. package/dist/agents/qa.txt +1 -1
  20. package/dist/agents/sm.txt +1 -1
  21. package/dist/agents/ux-expert.txt +1 -1
  22. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +1 -1
  23. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +1 -1
  24. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +1 -1
  25. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +5 -5
  26. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +2 -2
  27. package/dist/teams/team-all.txt +9 -9
  28. package/dist/teams/team-fullstack.txt +6 -6
  29. package/dist/teams/team-ide-minimal.txt +5 -5
  30. package/dist/teams/team-no-ui.txt +5 -5
  31. package/docs/agentic-tools/roo-code-guide.md +2 -0
  32. package/docs/agentic-tools/windsurf-guide.md +2 -0
  33. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +1 -1
  34. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +1 -1
  35. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +1 -1
  36. package/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.md +1 -1
  37. package/expansion-packs/bmad-creator-tools/templates/agent-tmpl.md +1 -1
  38. package/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +1 -1
  39. package/package.json +1 -1
  40. package/tools/builders/web-builder.js +1 -1
  41. package/tools/installer/lib/ide-setup.js +5 -5
  42. package/tools/installer/lib/installer.js +62 -1
  43. package/tools/installer/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,3 +1,10 @@
1
+ ## [4.24.5](https://github.com/bmadcode/BMAD-METHOD/compare/v4.24.4...v4.24.5) (2025-07-04)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * yaml standardization in files and installer actions ([094f9f3](https://github.com/bmadcode/BMAD-METHOD/commit/094f9f3eabf563c9a89ecaf360fed63386b46ed4))
7
+
1
8
  ## [4.24.4](https://github.com/bmadcode/BMAD-METHOD/compare/v4.24.3...v4.24.4) (2025-07-04)
2
9
 
3
10
 
@@ -1,6 +1,6 @@
1
1
  # analyst
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # architect
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # bmad-master
2
2
 
3
- CRITICAL: Read the full YML to understand your operating params, start activation to alter your state of being, follow startup instructions, stay in this being until told to exit this mode:
3
+ CRITICAL: Read the full YAML to understand your operating params, start activation to alter your state of being, follow startup instructions, stay in this being until told to exit this mode:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # bmad
2
2
 
3
- CRITICAL: Read the full YML to understand your operating params, start activation to alter your state of being, follow startup instructions, stay in this being until told to exit this mode:
3
+ CRITICAL: Read the full YAML to understand your operating params, start activation to alter your state of being, follow startup instructions, stay in this being until told to exit this mode:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # dev
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # pm
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # po
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # qa
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # sm
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -1,6 +1,6 @@
1
1
  # ux-expert
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  root: .bmad-core
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#analyst ====================
42
42
  # analyst
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#architect ====================
42
42
  # architect
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#bmad-master ====================
42
42
  # bmad-master
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  agent:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#bmad-orchestrator ====================
42
42
  # bmad-orchestrator
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  agent:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#dev ====================
42
42
  # dev
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  agent:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#pm ====================
42
42
  # pm
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#po ====================
42
42
  # po
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#qa ====================
42
42
  # qa
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#sm ====================
42
42
  # sm
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#ux-expert ====================
42
42
  # ux-expert
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#game-designer ====================
42
42
  # game-designer
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#game-developer ====================
42
42
  # game-developer
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#game-sm ====================
42
42
  # game-sm
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -57,7 +57,7 @@ workflows:
57
57
  ==================== START: agents#analyst ====================
58
58
  # analyst
59
59
 
60
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
60
+ 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:
61
61
 
62
62
  ```yaml
63
63
  activation-instructions:
@@ -121,7 +121,7 @@ dependencies:
121
121
  ==================== START: agents#bmad-orchestrator ====================
122
122
  # bmad-orchestrator
123
123
 
124
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
124
+ 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:
125
125
 
126
126
  ```yaml
127
127
  agent:
@@ -260,7 +260,7 @@ dependencies:
260
260
  ==================== START: agents#game-designer ====================
261
261
  # game-designer
262
262
 
263
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
263
+ 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:
264
264
 
265
265
  ```yaml
266
266
  activation-instructions:
@@ -321,7 +321,7 @@ dependencies:
321
321
  ==================== START: agents#game-developer ====================
322
322
  # game-developer
323
323
 
324
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
324
+ 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:
325
325
 
326
326
  ```yaml
327
327
  activation-instructions:
@@ -390,7 +390,7 @@ dependencies:
390
390
  ==================== START: agents#game-sm ====================
391
391
  # game-sm
392
392
 
393
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
393
+ 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:
394
394
 
395
395
  ```yaml
396
396
  activation-instructions:
@@ -41,7 +41,7 @@ These references map directly to bundle sections:
41
41
  ==================== START: agents#bmad-the-creator ====================
42
42
  # bmad-the-creator
43
43
 
44
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
44
+ 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:
45
45
 
46
46
  ```yaml
47
47
  activation-instructions:
@@ -1730,7 +1730,7 @@ Present these numbered options to the user:
1730
1730
  4. Character personas should be consistent and domain-appropriate
1731
1731
  5. Follow the numbered options protocol for all user interactions]]
1732
1732
 
1733
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
1733
+ 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:
1734
1734
 
1735
1735
  ```yaml
1736
1736
  activation-instructions:
@@ -58,7 +58,7 @@ workflows:
58
58
  ==================== START: agents#bmad-orchestrator ====================
59
59
  # bmad-orchestrator
60
60
 
61
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
61
+ 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:
62
62
 
63
63
  ```yaml
64
64
  agent:
@@ -197,7 +197,7 @@ dependencies:
197
197
  ==================== START: agents#analyst ====================
198
198
  # analyst
199
199
 
200
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
200
+ 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:
201
201
 
202
202
  ```yaml
203
203
  activation-instructions:
@@ -261,7 +261,7 @@ dependencies:
261
261
  ==================== START: agents#architect ====================
262
262
  # architect
263
263
 
264
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
264
+ 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:
265
265
 
266
266
  ```yaml
267
267
  activation-instructions:
@@ -325,7 +325,7 @@ dependencies:
325
325
  ==================== START: agents#dev ====================
326
326
  # dev
327
327
 
328
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
328
+ 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:
329
329
 
330
330
  ```yaml
331
331
  agent:
@@ -384,7 +384,7 @@ dependencies:
384
384
  ==================== START: agents#pm ====================
385
385
  # pm
386
386
 
387
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
387
+ 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:
388
388
 
389
389
  ```yaml
390
390
  activation-instructions:
@@ -445,7 +445,7 @@ dependencies:
445
445
  ==================== START: agents#po ====================
446
446
  # po
447
447
 
448
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
448
+ 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:
449
449
 
450
450
  ```yaml
451
451
  activation-instructions:
@@ -508,7 +508,7 @@ dependencies:
508
508
  ==================== START: agents#qa ====================
509
509
  # qa
510
510
 
511
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
511
+ 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:
512
512
 
513
513
  ```yaml
514
514
  activation-instructions:
@@ -558,7 +558,7 @@ dependencies:
558
558
  ==================== START: agents#sm ====================
559
559
  # sm
560
560
 
561
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
561
+ 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:
562
562
 
563
563
  ```yaml
564
564
  activation-instructions:
@@ -609,7 +609,7 @@ dependencies:
609
609
  ==================== START: agents#ux-expert ====================
610
610
  # ux-expert
611
611
 
612
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
612
+ 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:
613
613
 
614
614
  ```yaml
615
615
  activation-instructions:
@@ -62,7 +62,7 @@ workflows:
62
62
  ==================== START: agents#bmad-orchestrator ====================
63
63
  # bmad-orchestrator
64
64
 
65
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
65
+ 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:
66
66
 
67
67
  ```yaml
68
68
  agent:
@@ -201,7 +201,7 @@ dependencies:
201
201
  ==================== START: agents#analyst ====================
202
202
  # analyst
203
203
 
204
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
204
+ 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:
205
205
 
206
206
  ```yaml
207
207
  activation-instructions:
@@ -265,7 +265,7 @@ dependencies:
265
265
  ==================== START: agents#pm ====================
266
266
  # pm
267
267
 
268
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
268
+ 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:
269
269
 
270
270
  ```yaml
271
271
  activation-instructions:
@@ -326,7 +326,7 @@ dependencies:
326
326
  ==================== START: agents#ux-expert ====================
327
327
  # ux-expert
328
328
 
329
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
329
+ 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:
330
330
 
331
331
  ```yaml
332
332
  activation-instructions:
@@ -389,7 +389,7 @@ dependencies:
389
389
  ==================== START: agents#architect ====================
390
390
  # architect
391
391
 
392
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
392
+ 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:
393
393
 
394
394
  ```yaml
395
395
  activation-instructions:
@@ -453,7 +453,7 @@ dependencies:
453
453
  ==================== START: agents#po ====================
454
454
  # po
455
455
 
456
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
456
+ 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:
457
457
 
458
458
  ```yaml
459
459
  activation-instructions:
@@ -54,7 +54,7 @@ workflows: null
54
54
  ==================== START: agents#bmad-orchestrator ====================
55
55
  # bmad-orchestrator
56
56
 
57
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
57
+ 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:
58
58
 
59
59
  ```yaml
60
60
  agent:
@@ -193,7 +193,7 @@ dependencies:
193
193
  ==================== START: agents#po ====================
194
194
  # po
195
195
 
196
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
196
+ 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:
197
197
 
198
198
  ```yaml
199
199
  activation-instructions:
@@ -256,7 +256,7 @@ dependencies:
256
256
  ==================== START: agents#sm ====================
257
257
  # sm
258
258
 
259
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
259
+ 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:
260
260
 
261
261
  ```yaml
262
262
  activation-instructions:
@@ -307,7 +307,7 @@ dependencies:
307
307
  ==================== START: agents#dev ====================
308
308
  # dev
309
309
 
310
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
310
+ 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:
311
311
 
312
312
  ```yaml
313
313
  agent:
@@ -366,7 +366,7 @@ dependencies:
366
366
  ==================== START: agents#qa ====================
367
367
  # qa
368
368
 
369
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
369
+ 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:
370
370
 
371
371
  ```yaml
372
372
  activation-instructions:
@@ -57,7 +57,7 @@ workflows:
57
57
  ==================== START: agents#bmad-orchestrator ====================
58
58
  # bmad-orchestrator
59
59
 
60
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
60
+ 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:
61
61
 
62
62
  ```yaml
63
63
  agent:
@@ -196,7 +196,7 @@ dependencies:
196
196
  ==================== START: agents#analyst ====================
197
197
  # analyst
198
198
 
199
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
199
+ 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:
200
200
 
201
201
  ```yaml
202
202
  activation-instructions:
@@ -260,7 +260,7 @@ dependencies:
260
260
  ==================== START: agents#pm ====================
261
261
  # pm
262
262
 
263
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
263
+ 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:
264
264
 
265
265
  ```yaml
266
266
  activation-instructions:
@@ -321,7 +321,7 @@ dependencies:
321
321
  ==================== START: agents#architect ====================
322
322
  # architect
323
323
 
324
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
324
+ 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:
325
325
 
326
326
  ```yaml
327
327
  activation-instructions:
@@ -385,7 +385,7 @@ dependencies:
385
385
  ==================== START: agents#po ====================
386
386
  # po
387
387
 
388
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
388
+ 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:
389
389
 
390
390
  ```yaml
391
391
  activation-instructions:
@@ -1,5 +1,7 @@
1
1
  # BMad Method Guide for Roo Code
2
2
 
3
+ For the complete workflow, see the [BMad Workflow Guide](../bmad-workflow-guide.md).
4
+
3
5
  ## Installation
4
6
 
5
7
  When running `npx bmad-method install`, select **Roo Code** as your IDE. This creates:
@@ -1,5 +1,7 @@
1
1
  # BMad Method Guide for Windsurf
2
2
 
3
+ For the complete workflow, see the [BMad Workflow Guide](../bmad-workflow-guide.md).
4
+
3
5
  ## Installation
4
6
 
5
7
  When running `npx bmad-method install`, select **Windsurf** as your IDE. This creates:
@@ -1,6 +1,6 @@
1
1
  # game-designer
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  activation-instructions:
@@ -1,6 +1,6 @@
1
1
  # game-developer
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  activation-instructions:
@@ -1,6 +1,6 @@
1
1
  # game-sm
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  activation-instructions:
@@ -1,6 +1,6 @@
1
1
  # bmad-the-creator
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  activation-instructions:
@@ -8,7 +8,7 @@
8
8
  4. Character personas should be consistent and domain-appropriate
9
9
  5. Follow the numbered options protocol for all user interactions]]
10
10
 
11
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
11
+ 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:
12
12
 
13
13
  ```yaml
14
14
  activation-instructions:
@@ -1,6 +1,6 @@
1
1
  # infra-devops-platform
2
2
 
3
- CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
3
+ 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:
4
4
 
5
5
  ```yaml
6
6
  activation-instructions:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.24.4",
3
+ "version": "4.24.5",
4
4
  "description": "Breakthrough Method of Agile AI-driven Development",
5
5
  "main": "tools/cli.js",
6
6
  "bin": {
@@ -150,7 +150,7 @@ class WebBuilder {
150
150
  const agentName = parsed.agent?.id || "agent";
151
151
 
152
152
  // Build the new content with just the agent header and YAML
153
- const newHeader = `# ${agentName}\n\nCRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n`;
153
+ const newHeader = `# ${agentName}\n\nCRITICAL: 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:\n\n`;
154
154
  const afterYaml = content.substring(yamlEndIndex);
155
155
 
156
156
  return newHeader + "```yaml\n" + cleanedYaml.trim() + "\n```" + afterYaml;
@@ -98,7 +98,7 @@ class IdeSetup {
98
98
  )} agent persona.\n\n`;
99
99
  mdcContent += "## Agent Activation\n\n";
100
100
  mdcContent +=
101
- "CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n";
101
+ "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:\n\n";
102
102
  mdcContent += "```yaml\n";
103
103
  // Extract just the YAML content from the agent file
104
104
  const yamlContent = extractYamlFromAgent(agentContent);
@@ -116,7 +116,7 @@ class IdeSetup {
116
116
  mdcContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
117
117
  agentId,
118
118
  installDir
119
- )} persona and follow all instructions defined in the YML configuration above.\n`;
119
+ )} persona and follow all instructions defined in the YAML configuration above.\n`;
120
120
 
121
121
  await fileManager.writeFile(mdcPath, mdcContent);
122
122
  console.log(chalk.green(`✓ Created rule: ${agentId}.mdc`));
@@ -180,7 +180,7 @@ class IdeSetup {
180
180
  )} agent persona.\n\n`;
181
181
  mdContent += "## Agent Activation\n\n";
182
182
  mdContent +=
183
- "CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n";
183
+ "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:\n\n";
184
184
  mdContent += "```yaml\n";
185
185
  // Extract just the YAML content from the agent file
186
186
  const yamlContent = extractYamlFromAgent(agentContent);
@@ -198,7 +198,7 @@ class IdeSetup {
198
198
  mdContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
199
199
  agentId,
200
200
  installDir
201
- )} persona and follow all instructions defined in the YML configuration above.\n`;
201
+ )} persona and follow all instructions defined in the YAML configuration above.\n`;
202
202
 
203
203
  await fileManager.writeFile(mdPath, mdContent);
204
204
  console.log(chalk.green(`✓ Created rule: ${agentId}.md`));
@@ -362,7 +362,7 @@ class IdeSetup {
362
362
  newModesContent += ` whenToUse: ${whenToUse}\n`;
363
363
  // Get relative path from installDir to agent file
364
364
  const relativePath = path.relative(installDir, agentPath).replace(/\\/g, '/');
365
- newModesContent += ` customInstructions: CRITICAL Read the full YML from ${relativePath} start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode\n`;
365
+ newModesContent += ` customInstructions: CRITICAL Read the full YAML from ${relativePath} start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode\n`;
366
366
  newModesContent += ` groups:\n`;
367
367
  newModesContent += ` - read\n`;
368
368
 
@@ -685,6 +685,10 @@ class Installer {
685
685
  };
686
686
 
687
687
  await this.performFreshInstall(config, installDir, spinner, { isUpdate: true });
688
+
689
+ // Clean up .yml files that now have .yaml counterparts
690
+ spinner.text = "Cleaning up legacy .yml files...";
691
+ await this.cleanupLegacyYmlFiles(installDir, spinner);
688
692
  } catch (error) {
689
693
  spinner.fail("Update failed");
690
694
  throw error;
@@ -737,12 +741,27 @@ class Installer {
737
741
  if (await fileManager.pathExists(sourcePath)) {
738
742
  await fileManager.copyFile(sourcePath, destPath);
739
743
  spinner.text = `Restored: ${file}`;
744
+
745
+ // If this is a .yaml file, check for and remove corresponding .yml file
746
+ if (file.endsWith('.yaml')) {
747
+ const ymlFile = file.replace(/\.yaml$/, '.yml');
748
+ const ymlPath = path.join(installDir, ymlFile);
749
+ if (await fileManager.pathExists(ymlPath)) {
750
+ const fs = require('fs').promises;
751
+ await fs.unlink(ymlPath);
752
+ console.log(chalk.dim(` Removed legacy: ${ymlFile} (replaced by ${file})`));
753
+ }
754
+ }
740
755
  } else {
741
756
  console.warn(chalk.yellow(` Warning: Source file not found: ${file}`));
742
757
  }
743
758
  }
744
759
  }
745
760
 
761
+ // Clean up .yml files that now have .yaml counterparts
762
+ spinner.text = "Cleaning up legacy .yml files...";
763
+ await this.cleanupLegacyYmlFiles(installDir, spinner);
764
+
746
765
  spinner.succeed("Repair completed successfully!");
747
766
 
748
767
  // Show summary
@@ -778,7 +797,13 @@ class Installer {
778
797
  }
779
798
 
780
799
  spinner.text = "Installing fresh copy...";
781
- return await this.performFreshInstall(config, installDir, spinner, { isUpdate: true });
800
+ const result = await this.performFreshInstall(config, installDir, spinner, { isUpdate: true });
801
+
802
+ // Clean up .yml files that now have .yaml counterparts
803
+ spinner.text = "Cleaning up legacy .yml files...";
804
+ await this.cleanupLegacyYmlFiles(installDir, spinner);
805
+
806
+ return result;
782
807
  }
783
808
 
784
809
  showSuccessMessage(config, installDir, options = {}) {
@@ -1637,6 +1662,42 @@ class Installer {
1637
1662
  return 0;
1638
1663
  }
1639
1664
 
1665
+ async cleanupLegacyYmlFiles(installDir, spinner) {
1666
+ const glob = require('glob');
1667
+ const fs = require('fs').promises;
1668
+
1669
+ try {
1670
+ // Find all .yml files in the installation directory
1671
+ const ymlFiles = glob.sync('**/*.yml', {
1672
+ cwd: installDir,
1673
+ ignore: ['**/node_modules/**', '**/.git/**']
1674
+ });
1675
+
1676
+ let deletedCount = 0;
1677
+
1678
+ for (const ymlFile of ymlFiles) {
1679
+ // Check if corresponding .yaml file exists
1680
+ const yamlFile = ymlFile.replace(/\.yml$/, '.yaml');
1681
+ const ymlPath = path.join(installDir, ymlFile);
1682
+ const yamlPath = path.join(installDir, yamlFile);
1683
+
1684
+ if (await fileManager.pathExists(yamlPath)) {
1685
+ // .yaml counterpart exists, delete the .yml file
1686
+ await fs.unlink(ymlPath);
1687
+ deletedCount++;
1688
+ console.log(chalk.dim(` Removed legacy: ${ymlFile} (replaced by ${yamlFile})`));
1689
+ }
1690
+ }
1691
+
1692
+ if (deletedCount > 0) {
1693
+ console.log(chalk.green(`✓ Cleaned up ${deletedCount} legacy .yml files`));
1694
+ }
1695
+
1696
+ } catch (error) {
1697
+ console.warn(chalk.yellow(`Warning: Could not cleanup legacy .yml files: ${error.message}`));
1698
+ }
1699
+ }
1700
+
1640
1701
  async findInstallation() {
1641
1702
  // Look for .bmad-core in current directory or parent directories
1642
1703
  let currentDir = process.cwd();
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.24.4",
3
+ "version": "4.24.5",
4
4
  "description": "BMad Method installer - AI-powered Agile development framework",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {