bmad-method 4.24.2 → 4.24.4

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 (79) hide show
  1. package/.prettierignore +1 -1
  2. package/CHANGELOG.md +15 -1
  3. package/README.md +22 -22
  4. package/bmad-core/agents/bmad-master.md +5 -5
  5. package/bmad-core/agents/bmad-orchestrator.md +9 -9
  6. package/bmad-core/checklists/change-checklist.md +2 -2
  7. package/bmad-core/data/bmad-kb.md +18 -18
  8. package/bmad-core/tasks/create-brownfield-story.md +2 -2
  9. package/bmad-core/tasks/create-next-story.md +2 -2
  10. package/bmad-core/tasks/kb-mode-interaction.md +13 -13
  11. package/common/utils/template-format.md +1 -1
  12. package/common/utils/workflow-management.md +1 -1
  13. package/dist/agents/analyst.txt +21 -21
  14. package/dist/agents/architect.txt +3 -3
  15. package/dist/agents/bmad-master.txt +31 -31
  16. package/dist/agents/bmad-orchestrator.txt +44 -44
  17. package/dist/agents/dev.txt +2 -2
  18. package/dist/agents/pm.txt +5 -5
  19. package/dist/agents/po.txt +5 -5
  20. package/dist/agents/qa.txt +3 -3
  21. package/dist/agents/sm.txt +5 -5
  22. package/dist/agents/ux-expert.txt +3 -3
  23. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +2 -2
  24. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +2 -2
  25. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +2 -2
  26. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +29 -29
  27. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +21 -21
  28. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +14 -14
  29. package/dist/teams/team-all.txt +48 -48
  30. package/dist/teams/team-fullstack.txt +46 -46
  31. package/dist/teams/team-ide-minimal.txt +48 -48
  32. package/dist/teams/team-no-ui.txt +46 -46
  33. package/docs/agentic-tools/claude-code-guide.md +5 -22
  34. package/docs/agentic-tools/cline-guide.md +3 -29
  35. package/docs/agentic-tools/cursor-guide.md +4 -27
  36. package/docs/agentic-tools/gemini-cli-guide.md +3 -17
  37. package/docs/agentic-tools/github-copilot-guide.md +22 -0
  38. package/docs/agentic-tools/roo-code-guide.md +2 -35
  39. package/docs/agentic-tools/windsurf-guide.md +3 -28
  40. package/docs/bmad-workflow-guide.md +8 -8
  41. package/docs/core-architecture.md +19 -184
  42. package/docs/expansion-packs.md +4 -4
  43. package/docs/how-to-contribute-with-pull-requests.md +1 -1
  44. package/docs/user-guide.md +29 -414
  45. package/docs/versions.md +4 -4
  46. package/docs/working-in-the-brownfield.md +9 -6
  47. package/expansion-packs/README.md +2 -2
  48. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  49. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +3 -3
  50. package/expansion-packs/bmad-creator-tools/README.md +2 -2
  51. package/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.md +8 -8
  52. package/expansion-packs/bmad-creator-tools/config.yaml +2 -2
  53. package/expansion-packs/bmad-creator-tools/tasks/create-agent.md +1 -1
  54. package/expansion-packs/bmad-creator-tools/tasks/generate-expansion-pack.md +9 -9
  55. package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.md +1 -1
  56. package/expansion-packs/bmad-infrastructure-devops/README.md +6 -6
  57. package/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md +1 -1
  58. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  59. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +4 -4
  60. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +4 -4
  61. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.md +2 -2
  62. package/package.json +1 -1
  63. package/tools/bmad-npx-wrapper.js +1 -1
  64. package/tools/builders/web-builder.js +1 -1
  65. package/tools/cli.js +2 -2
  66. package/tools/installer/README.md +1 -51
  67. package/tools/installer/bin/bmad.js +9 -9
  68. package/tools/installer/config/install.config.yaml +10 -10
  69. package/tools/installer/lib/config-loader.js +2 -2
  70. package/tools/installer/lib/ide-setup.js +9 -9
  71. package/tools/installer/lib/installer.js +19 -19
  72. package/tools/installer/package.json +3 -3
  73. package/tools/md-assets/web-agent-startup-instructions.md +2 -2
  74. package/tools/upgraders/v3-to-v4-upgrader.js +2 -2
  75. package/tools/version-bump.js +1 -1
  76. package/tools/yaml-format.js +1 -1
  77. package/tools/installer/templates/claude-commands.md +0 -7
  78. package/tools/installer/templates/cursor-rules.md +0 -22
  79. package/tools/installer/templates/windsurf-rules.md +0 -22
@@ -220,7 +220,7 @@ class Installer {
220
220
  });
221
221
 
222
222
  if (files.length > 0) {
223
- // Directory has other files, but no BMAD installation.
223
+ // Directory has other files, but no BMad installation.
224
224
  // Treat as clean install but record that it isn't empty.
225
225
  state.hasOtherFiles = true;
226
226
  }
@@ -235,7 +235,7 @@ class Installer {
235
235
  async performFreshInstall(config, installDir, spinner, options = {}) {
236
236
  // Ensure modules are initialized
237
237
  await initializeModules();
238
- spinner.text = "Installing BMAD Method...";
238
+ spinner.text = "Installing BMad Method...";
239
239
 
240
240
  let files = [];
241
241
 
@@ -396,7 +396,7 @@ class Installer {
396
396
  const newVersion = await this.getCoreVersion();
397
397
  const versionCompare = this.compareVersions(currentVersion, newVersion);
398
398
 
399
- console.log(chalk.yellow("\n🔍 Found existing BMAD v4 installation"));
399
+ console.log(chalk.yellow("\n🔍 Found existing BMad v4 installation"));
400
400
  console.log(` Directory: ${installDir}`);
401
401
  console.log(` Current version: ${currentVersion}`);
402
402
  console.log(` Available version: ${newVersion}`);
@@ -446,8 +446,8 @@ class Installer {
446
446
  let choices = [];
447
447
 
448
448
  if (versionCompare < 0) {
449
- console.log(chalk.cyan("\n⬆️ Upgrade available for BMAD core"));
450
- choices.push({ name: `Upgrade BMAD core (v${currentVersion} → v${newVersion})`, value: "upgrade" });
449
+ console.log(chalk.cyan("\n⬆️ Upgrade available for BMad core"));
450
+ choices.push({ name: `Upgrade BMad core (v${currentVersion} → v${newVersion})`, value: "upgrade" });
451
451
  } else if (versionCompare === 0) {
452
452
  if (hasIntegrityIssues) {
453
453
  // Offer repair option when files are missing or modified
@@ -457,10 +457,10 @@ class Installer {
457
457
  });
458
458
  }
459
459
  console.log(chalk.yellow("\n⚠️ Same version already installed"));
460
- choices.push({ name: `Force reinstall BMAD core (v${currentVersion} - reinstall)`, value: "reinstall" });
460
+ choices.push({ name: `Force reinstall BMad core (v${currentVersion} - reinstall)`, value: "reinstall" });
461
461
  } else {
462
462
  console.log(chalk.yellow("\n⬇️ Installed version is newer than available"));
463
- choices.push({ name: `Downgrade BMAD core (v${currentVersion} → v${newVersion})`, value: "reinstall" });
463
+ choices.push({ name: `Downgrade BMad core (v${currentVersion} → v${newVersion})`, value: "reinstall" });
464
464
  }
465
465
 
466
466
  choices.push(
@@ -535,7 +535,7 @@ class Installer {
535
535
  spinner.stop();
536
536
 
537
537
  console.log(
538
- chalk.yellow("\n🔍 Found BMAD v3 installation (bmad-agent/ directory)")
538
+ chalk.yellow("\n🔍 Found BMad v3 installation (bmad-agent/ directory)")
539
539
  );
540
540
  console.log(` Directory: ${installDir}`);
541
541
 
@@ -768,7 +768,7 @@ class Installer {
768
768
  }
769
769
 
770
770
  async performReinstall(config, installDir, spinner) {
771
- spinner.start("Preparing to reinstall BMAD Method...");
771
+ spinner.start("Preparing to reinstall BMad Method...");
772
772
 
773
773
  // Remove existing .bmad-core
774
774
  const bmadCorePath = path.join(installDir, ".bmad-core");
@@ -782,7 +782,7 @@ class Installer {
782
782
  }
783
783
 
784
784
  showSuccessMessage(config, installDir, options = {}) {
785
- console.log(chalk.green("\n✓ BMAD Method installed successfully!\n"));
785
+ console.log(chalk.green("\n✓ BMad Method installed successfully!\n"));
786
786
 
787
787
  const ides = config.ides || (config.ide ? [config.ide] : []);
788
788
  if (ides.length > 0) {
@@ -790,7 +790,7 @@ class Installer {
790
790
  const ideConfig = configLoader.getIdeConfiguration(ide);
791
791
  if (ideConfig?.instructions) {
792
792
  console.log(
793
- chalk.bold(`To use BMAD agents in ${ideConfig.name}:`)
793
+ chalk.bold(`To use BMad agents in ${ideConfig.name}:`)
794
794
  );
795
795
  console.log(ideConfig.instructions);
796
796
  }
@@ -879,7 +879,7 @@ class Installer {
879
879
  };
880
880
  return await this.install(config);
881
881
  }
882
- console.log(chalk.red("No BMAD installation found."));
882
+ console.log(chalk.red("No BMad installation found."));
883
883
  }
884
884
 
885
885
  async listAgents() {
@@ -887,7 +887,7 @@ class Installer {
887
887
  await initializeModules();
888
888
  const agents = await configLoader.getAvailableAgents();
889
889
 
890
- console.log(chalk.bold("\nAvailable BMAD Agents:\n"));
890
+ console.log(chalk.bold("\nAvailable BMad Agents:\n"));
891
891
 
892
892
  for (const agent of agents) {
893
893
  console.log(chalk.cyan(` ${agent.id.padEnd(20)}`), agent.description);
@@ -903,7 +903,7 @@ class Installer {
903
903
  await initializeModules();
904
904
  const expansionPacks = await this.getAvailableExpansionPacks();
905
905
 
906
- console.log(chalk.bold("\nAvailable BMAD Expansion Packs:\n"));
906
+ console.log(chalk.bold("\nAvailable BMad Expansion Packs:\n"));
907
907
 
908
908
  if (expansionPacks.length === 0) {
909
909
  console.log(chalk.yellow("No expansion packs found."));
@@ -932,7 +932,7 @@ class Installer {
932
932
 
933
933
  if (!installDir) {
934
934
  console.log(
935
- chalk.yellow("No BMAD installation found in current directory tree")
935
+ chalk.yellow("No BMad installation found in current directory tree")
936
936
  );
937
937
  return;
938
938
  }
@@ -944,7 +944,7 @@ class Installer {
944
944
  return;
945
945
  }
946
946
 
947
- console.log(chalk.bold("\nBMAD Installation Status:\n"));
947
+ console.log(chalk.bold("\nBMad Installation Status:\n"));
948
948
  console.log(` Directory: ${installDir}`);
949
949
  console.log(` Version: ${manifest.version}`);
950
950
  console.log(
@@ -1210,7 +1210,7 @@ class Installer {
1210
1210
 
1211
1211
  async resolveExpansionPackCoreDependencies(installDir, expansionDotFolder, packId, spinner) {
1212
1212
  const glob = require('glob');
1213
- const yaml = require('yaml');
1213
+ const yaml = require('js-yaml');
1214
1214
  const fs = require('fs').promises;
1215
1215
 
1216
1216
  // Find all agent files in the expansion pack
@@ -1265,7 +1265,7 @@ class Installer {
1265
1265
 
1266
1266
  async resolveExpansionPackCoreAgents(installDir, expansionDotFolder, packId, spinner) {
1267
1267
  const glob = require('glob');
1268
- const yaml = require('yaml');
1268
+ const yaml = require('js-yaml');
1269
1269
  const fs = require('fs').promises;
1270
1270
 
1271
1271
  // Find all team files in the expansion pack
@@ -1399,7 +1399,7 @@ class Installer {
1399
1399
  await initializeModules();
1400
1400
 
1401
1401
  try {
1402
- // Find the dist directory in the BMAD installation
1402
+ // Find the dist directory in the BMad installation
1403
1403
  const distDir = configLoader.getDistPath();
1404
1404
 
1405
1405
  if (!(await fileManager.pathExists(distDir))) {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.24.2",
4
- "description": "BMAD Method installer - AI-powered Agile development framework",
3
+ "version": "4.24.4",
4
+ "description": "BMad Method installer - AI-powered Agile development framework",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {
7
7
  "bmad": "./bin/bmad.js",
@@ -19,7 +19,7 @@
19
19
  "installer",
20
20
  "agents"
21
21
  ],
22
- "author": "BMAD Team",
22
+ "author": "BMad Team",
23
23
  "license": "MIT",
24
24
  "dependencies": {
25
25
  "chalk": "^5.4.1",
@@ -1,6 +1,6 @@
1
1
  # Web Agent Bundle Instructions
2
2
 
3
- You are now operating as a specialized AI agent from the BMAD-METHOD framework. This is a bundled web-compatible version containing all necessary resources for your role.
3
+ You are now operating as a specialized AI agent from the BMad-Method framework. This is a bundled web-compatible version containing all necessary resources for your role.
4
4
 
5
5
  ## Important Instructions
6
6
 
@@ -34,6 +34,6 @@ These references map directly to bundle sections:
34
34
 
35
35
  3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
36
 
37
- 4. **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role according to the BMAD-METHOD framework.
37
+ 4. **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role according to the BMad-Method framework.
38
38
 
39
39
  ---
@@ -26,10 +26,10 @@ class V3ToV4Upgrader {
26
26
 
27
27
  // 1. Welcome message
28
28
  console.log(
29
- chalk.bold("\nWelcome to BMAD-METHOD V3 to V4 Upgrade Tool\n")
29
+ chalk.bold("\nWelcome to BMad-Method V3 to V4 Upgrade Tool\n")
30
30
  );
31
31
  console.log(
32
- "This tool will help you upgrade your BMAD-METHOD V3 project to V4.\n"
32
+ "This tool will help you upgrade your BMad-Method V3 project to V4.\n"
33
33
  );
34
34
  console.log(chalk.cyan("What this tool does:"));
35
35
  console.log("- Creates a backup of your V3 files (.bmad-v3-backup/)");
@@ -15,7 +15,7 @@ async function initializeModules() {
15
15
  }
16
16
 
17
17
  /**
18
- * Simple version bumping script for BMAD-METHOD
18
+ * Simple version bumping script for BMad-Method
19
19
  * Usage: node tools/version-bump.js [patch|minor|major]
20
20
  */
21
21
 
@@ -16,7 +16,7 @@ async function initializeModules() {
16
16
  }
17
17
 
18
18
  /**
19
- * YAML Formatter and Linter for BMAD-METHOD
19
+ * YAML Formatter and Linter for BMad-Method
20
20
  * Formats and validates YAML files and YAML embedded in Markdown
21
21
  */
22
22
 
@@ -1,7 +0,0 @@
1
- # {{AGENT_NAME}} Agent
2
-
3
- {{AGENT_CONTENT}}
4
-
5
- ---
6
-
7
- This is a BMAD Method agent. For more information, visit: https://github.com/your-org/bmad-method
@@ -1,22 +0,0 @@
1
- # BMAD Method Agents for Cursor
2
-
3
- This file contains all BMAD Method agent personas. To use an agent, type its name or alias in the Cursor chat.
4
-
5
- ## Available Agents
6
-
7
- {{AGENT_LIST}}
8
-
9
- ---
10
-
11
- {{AGENT_RULES}}
12
-
13
- ---
14
-
15
- # Agent Switching
16
-
17
- To switch between agents during a conversation:
18
-
19
- 1. Simply type the new agent name (e.g., "architect" or "dev")
20
- 2. The AI will adopt that agent's persona
21
-
22
- For more information about BMAD Method, visit: https://github.com/your-org/bmad-method
@@ -1,22 +0,0 @@
1
- # BMAD Method Agent Commands
2
-
3
- This file contains all BMAD Method agent commands for Windsurf. Use /agent-name to switch personas.
4
-
5
- ## Available Commands
6
-
7
- {{COMMAND_LIST}}
8
-
9
- ---
10
-
11
- {{AGENT_SECTIONS}}
12
-
13
- ---
14
-
15
- # Usage Tips
16
-
17
- - Type `/dev` to switch to Developer persona
18
- - Type `/pm` to switch to Product Manager persona
19
- - Type `/architect` to switch to Architect persona
20
- - And so on for other agents...
21
-
22
- For more information about BMAD Method, visit: https://github.com/your-org/bmad-method