bmad-method 4.31.0 → 4.33.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/.vscode/settings.json +1 -7
  2. package/CHANGELOG.md +113 -173
  3. package/README.md +47 -0
  4. package/bmad-core/agents/analyst.md +1 -1
  5. package/bmad-core/agents/architect.md +2 -3
  6. package/bmad-core/agents/bmad-master.md +0 -1
  7. package/bmad-core/agents/bmad-orchestrator.md +9 -10
  8. package/bmad-core/agents/dev.md +1 -2
  9. package/bmad-core/agents/pm.md +3 -1
  10. package/bmad-core/agents/po.md +1 -1
  11. package/bmad-core/agents/qa.md +1 -1
  12. package/bmad-core/agents/sm.md +1 -1
  13. package/bmad-core/agents/ux-expert.md +1 -1
  14. package/bmad-core/bmad-core/user-guide.md +0 -0
  15. package/bmad-core/checklists/architect-checklist.md +0 -5
  16. package/bmad-core/checklists/pm-checklist.md +0 -5
  17. package/bmad-core/checklists/po-master-checklist.md +0 -9
  18. package/bmad-core/checklists/story-dod-checklist.md +0 -7
  19. package/bmad-core/checklists/story-draft-checklist.md +0 -3
  20. package/bmad-core/data/bmad-kb.md +5 -2
  21. package/bmad-core/data/elicitation-methods.md +20 -0
  22. package/bmad-core/enhanced-ide-development-workflow.md +43 -0
  23. package/bmad-core/tasks/create-brownfield-story.md +11 -3
  24. package/bmad-core/tasks/create-deep-research-prompt.md +0 -11
  25. package/bmad-core/tasks/document-project.md +15 -13
  26. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  27. package/bmad-core/tasks/index-docs.md +0 -6
  28. package/bmad-core/tasks/kb-mode-interaction.md +3 -3
  29. package/bmad-core/tasks/review-story.md +10 -1
  30. package/bmad-core/tasks/shard-doc.md +0 -2
  31. package/bmad-core/user-guide.md +7 -6
  32. package/bmad-core/working-in-the-brownfield.md +39 -36
  33. package/common/tasks/execute-checklist.md +0 -7
  34. package/dist/agents/analyst.txt +6 -6
  35. package/dist/agents/architect.txt +8 -3
  36. package/dist/agents/bmad-master.txt +2 -1
  37. package/dist/agents/pm.txt +9 -2
  38. package/dist/agents/po.txt +2 -318
  39. package/dist/agents/qa.txt +0 -1
  40. package/dist/agents/sm.txt +3 -3
  41. package/dist/agents/ux-expert.txt +2 -297
  42. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +6 -6
  43. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +4047 -0
  44. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +1520 -185
  45. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +214 -1229
  46. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +537 -373
  47. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +6917 -2140
  48. package/dist/teams/team-all.txt +30 -25
  49. package/dist/teams/team-fullstack.txt +27 -21
  50. package/dist/teams/team-ide-minimal.txt +5 -322
  51. package/dist/teams/team-no-ui.txt +25 -16
  52. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  53. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +0 -4
  54. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +3 -5
  55. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +0 -1
  56. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +0 -18
  57. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +1 -0
  58. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +80 -0
  59. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +21 -16
  60. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +25 -25
  61. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +15 -14
  62. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +391 -0
  63. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +203 -0
  64. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +1 -1
  65. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +103 -139
  66. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +1 -1
  67. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +586 -68
  68. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +0 -4
  69. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +0 -1
  70. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +141 -0
  71. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +165 -198
  72. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +0 -18
  73. package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +200 -0
  74. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +938 -453
  75. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +3 -3
  76. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +517 -155
  77. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +12 -12
  78. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +11 -11
  79. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  80. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +0 -3
  81. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +0 -1
  82. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +0 -1
  83. package/package.json +4 -1
  84. package/tools/bmad-npx-wrapper.js +5 -7
  85. package/tools/flattener/main.js +570 -0
  86. package/tools/installer/bin/bmad.js +14 -0
  87. package/tools/installer/lib/installer.js +29 -3
  88. package/tools/installer/package-lock.json +89 -89
  89. package/tools/installer/package.json +1 -1
  90. package/.husky/pre-commit +0 -2
  91. package/.prettierignore +0 -21
  92. package/.prettierrc +0 -23
@@ -1,7 +1,7 @@
1
1
  template:
2
- id: game-story-template-v2
2
+ id: game-story-template-v3
3
3
  name: Game Development Story
4
- version: 2.0
4
+ version: 3.0
5
5
  output:
6
6
  format: markdown
7
7
  filename: "stories/{{epic_name}}/{{story_id}}-{{story_name}}.md"
@@ -49,9 +49,9 @@ sections:
49
49
  title: Technical Requirements
50
50
  type: checklist
51
51
  items:
52
- - "Code follows C# best practices"
53
- - "Maintains stable frame rate on target devices"
54
- - "No memory leaks or performance degradation"
52
+ - Code follows C# best practices
53
+ - Maintains stable frame rate on target devices
54
+ - No memory leaks or performance degradation
55
55
  - "{{specific_technical_requirement}}"
56
56
  - id: game-design-requirements
57
57
  title: Game Design Requirements
@@ -227,13 +227,13 @@ sections:
227
227
  instruction: Checklist that must be completed before the story is considered finished
228
228
  type: checklist
229
229
  items:
230
- - "All acceptance criteria met"
231
- - "Code reviewed and approved"
232
- - "Unit tests written and passing"
233
- - "Integration tests passing"
234
- - "Performance targets met"
235
- - "No C# compiler errors or warnings"
236
- - "Documentation updated"
230
+ - All acceptance criteria met
231
+ - Code reviewed and approved
232
+ - Unit tests written and passing
233
+ - Integration tests passing
234
+ - Performance targets met
235
+ - No C# compiler errors or warnings
236
+ - Documentation updated
237
237
  - "{{game_specific_dod_item}}"
238
238
 
239
239
  - id: notes
@@ -1,10 +1,10 @@
1
1
  template:
2
2
  id: level-design-doc-template-v2
3
3
  name: Level Design Document
4
- version: 2.0
4
+ version: 2.1
5
5
  output:
6
6
  format: markdown
7
- filename: "docs/{{game_name}}-level-design-document.md"
7
+ filename: docs/level-design-document.md
8
8
  title: "{{game_title}} Level Design Document"
9
9
 
10
10
  workflow:
@@ -371,19 +371,19 @@ sections:
371
371
  title: Playtesting Checklist
372
372
  type: checklist
373
373
  items:
374
- - "Level completes within target time range"
375
- - "All mechanics function correctly"
376
- - "Difficulty feels appropriate for level category"
377
- - "Player guidance is clear and effective"
378
- - "No exploits or sequence breaks (unless intended)"
374
+ - Level completes within target time range
375
+ - All mechanics function correctly
376
+ - Difficulty feels appropriate for level category
377
+ - Player guidance is clear and effective
378
+ - No exploits or sequence breaks (unless intended)
379
379
  - id: player-experience-testing
380
380
  title: Player Experience Testing
381
381
  type: checklist
382
382
  items:
383
- - "Tutorial levels teach effectively"
384
- - "Challenge feels fair and rewarding"
385
- - "Flow and pacing maintain engagement"
386
- - "Audio and visual feedback support gameplay"
383
+ - Tutorial levels teach effectively
384
+ - Challenge feels fair and rewarding
385
+ - Flow and pacing maintain engagement
386
+ - Audio and visual feedback support gameplay
387
387
  - id: balance-validation
388
388
  title: Balance Validation
389
389
  template: |
@@ -1,5 +1,5 @@
1
1
  name: bmad-infrastructure-devops
2
- version: 1.10.0
2
+ version: 1.11.0
3
3
  short-title: Infrastructure DevOps Pack
4
4
  description: >-
5
5
  This expansion pack extends BMad Method with comprehensive infrastructure and
@@ -247,17 +247,14 @@ A comprehensive 16-section checklist covering:
247
247
  ### Common Issues
248
248
 
249
249
  1. **Infrastructure Drift**
250
-
251
250
  - Solution: Implement drift detection in IaC pipelines
252
251
  - Prevention: Restrict manual changes, enforce GitOps
253
252
 
254
253
  2. **Cost Overruns**
255
-
256
254
  - Solution: Implement cost monitoring and alerts
257
255
  - Prevention: Resource tagging, budget limits
258
256
 
259
257
  3. **Performance Problems**
260
-
261
258
  - Solution: Review monitoring data, scale resources
262
259
  - Prevention: Load testing, capacity planning
263
260
 
@@ -32,7 +32,6 @@ To conduct a thorough review of existing infrastructure to identify improvement
32
32
  ### 3. Conduct Systematic Review
33
33
 
34
34
  - **If "Incremental Mode" was selected:**
35
-
36
35
  - For each section of the infrastructure checklist:
37
36
  - **a. Present Section Focus:** Explain what aspects of infrastructure this section reviews
38
37
  - **b. Work Through Items:** Examine each checklist item against current infrastructure
@@ -55,7 +55,6 @@ To comprehensively validate platform infrastructure changes against security, re
55
55
  ### 4. Execute Comprehensive Platform Validation Process
56
56
 
57
57
  - **If "Incremental Mode" was selected:**
58
-
59
58
  - For each section of the infrastructure checklist (Sections 1-16):
60
59
  - **a. Present Section Purpose:** Explain what this section validates and why it's important for platform operations
61
60
  - **b. Work Through Items:** Present each checklist item, guide the user through validation, and document compliance or gaps
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.31.0",
3
+ "version": "4.33.0",
4
4
  "description": "Breakthrough Method of Agile AI-driven Development",
5
5
  "main": "tools/cli.js",
6
6
  "bin": {
@@ -13,6 +13,7 @@
13
13
  "build:teams": "node tools/cli.js build --teams-only",
14
14
  "list:agents": "node tools/cli.js list:agents",
15
15
  "validate": "node tools/cli.js validate",
16
+ "flatten": "node tools/flattener/main.js",
16
17
  "install:bmad": "node tools/installer/bin/bmad.js install",
17
18
  "format": "prettier --write \"**/*.md\"",
18
19
  "version:patch": "node tools/version-bump.js patch",
@@ -41,6 +42,7 @@
41
42
  "glob": "^11.0.3",
42
43
  "inquirer": "^8.2.6",
43
44
  "js-yaml": "^4.1.0",
45
+ "minimatch": "^10.0.3",
44
46
  "ora": "^5.4.1"
45
47
  },
46
48
  "keywords": [
@@ -65,6 +67,7 @@
65
67
  "@semantic-release/changelog": "^6.0.3",
66
68
  "@semantic-release/git": "^10.0.1",
67
69
  "husky": "^9.1.7",
70
+ "jest": "^30.0.4",
68
71
  "lint-staged": "^16.1.1",
69
72
  "prettier": "^3.5.3",
70
73
  "semantic-release": "^22.0.0",
@@ -14,28 +14,26 @@ const isNpxExecution = __dirname.includes('_npx') || __dirname.includes('.npm');
14
14
 
15
15
  // If running via npx, we need to handle things differently
16
16
  if (isNpxExecution) {
17
- // The actual bmad.js is in installer/bin/ (relative to tools directory)
17
+ const args = process.argv.slice(2);
18
+
19
+ // Use the installer for all commands
18
20
  const bmadScriptPath = path.join(__dirname, 'installer', 'bin', 'bmad.js');
19
21
 
20
- // Verify the file exists
21
22
  if (!fs.existsSync(bmadScriptPath)) {
22
23
  console.error('Error: Could not find bmad.js at', bmadScriptPath);
23
24
  console.error('Current directory:', __dirname);
24
25
  process.exit(1);
25
26
  }
26
27
 
27
- // Execute with proper working directory
28
28
  try {
29
- execSync(`node "${bmadScriptPath}" ${process.argv.slice(2).join(' ')}`, {
29
+ execSync(`node "${bmadScriptPath}" ${args.join(' ')}`, {
30
30
  stdio: 'inherit',
31
31
  cwd: path.dirname(__dirname)
32
32
  });
33
33
  } catch (error) {
34
- // execSync will throw if the command exits with non-zero
35
- // But the stdio is inherited, so the error is already displayed
36
34
  process.exit(error.status || 1);
37
35
  }
38
36
  } else {
39
- // Local execution - just require the installer directly
37
+ // Local execution - use installer for all commands
40
38
  require('./installer/bin/bmad.js');
41
39
  }