bmad-method 4.24.3 → 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 (80) hide show
  1. package/.prettierignore +1 -1
  2. package/CHANGELOG.md +8 -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 +17 -17
  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/docs/agentic-tools/vs-code-copilot-guide.md +0 -53
  78. package/tools/installer/templates/claude-commands.md +0 -7
  79. package/tools/installer/templates/cursor-rules.md +0 -22
  80. 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(
@@ -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.3",
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,53 +0,0 @@
1
- # BMAD Method Guide for Visual Studio Code
2
-
3
- This guide covers the setup and usage of the BMAD Method in Visual Studio Code. For the complete workflow, see the [BMAD Workflow Guide](../bmad-workflow-guide.md).
4
-
5
- ## Installation
6
-
7
- When running `npx bmad-method install`, select **Visual Studio Code** as your IDE. This command will perform the following actions:
8
-
9
- - Create the `.bmad-core/` directory with all the agent rule files.
10
-
11
- - Create the `.vscode/` directory and add a `settings.json` file with the basic configuration to enable GitHub Copilot's agent mode.
12
-
13
- ## Using BMAD Agents in VS Code
14
-
15
- 1. In the GitHub Copilot Chat window, select **Agent** from the chat mode dropdown list (usually located next to the input field).
16
-
17
- 2. Once in Agent Mode, type `@` and the agent's name in the chat input to activate it:
18
-
19
- - `@bmad-master` - Universal task executor
20
-
21
- - `@sm` - Scrum Master
22
-
23
- - `@dev` - Full-stack developer
24
-
25
- - `@architect` - Solution architect
26
-
27
- - `@pm` - Product manager
28
-
29
- - `@analyst` - Business analyst
30
-
31
- - `@qa` - QA specialist
32
-
33
- - `@po` - Product owner
34
-
35
- - `@ux-expert` - UX specialist
36
-
37
- ## VS Code Specific Features
38
-
39
- - **Dynamic Configuration**: When you first invoke an agent (e.g., `@dev`), VS Code will automatically update `.vscode/settings.json` by adding the configuration for that chat mode.
40
-
41
- - **Activation**: Use the `@` prefix in the GitHub Copilot Chat for instant switching between agents.
42
-
43
- - **Collaboration**: Fully compatible with **Live Share**, allowing you, your team, and BMAD agents to work together in real-time.
44
-
45
- - **Project Context**: Agents have full access to your workspace, including open files and the selected code.
46
-
47
- ## Tips for VS Code Users
48
-
49
- - Use the `help` command (e.g., `@dev help`) to see the available commands for each agent.
50
-
51
- - Use `@workspace` in the Copilot Chat to ask questions about your entire project.
52
-
53
- - Consider adding `.vscode/` and `.bmad-core/` to your `.gitignore` file in team projects to avoid conflicts with personal settings.
@@ -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