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.
- package/.prettierignore +1 -1
- package/CHANGELOG.md +8 -1
- package/README.md +22 -22
- package/bmad-core/agents/bmad-master.md +5 -5
- package/bmad-core/agents/bmad-orchestrator.md +9 -9
- package/bmad-core/checklists/change-checklist.md +2 -2
- package/bmad-core/data/bmad-kb.md +18 -18
- package/bmad-core/tasks/create-brownfield-story.md +2 -2
- package/bmad-core/tasks/create-next-story.md +2 -2
- package/bmad-core/tasks/kb-mode-interaction.md +13 -13
- package/common/utils/template-format.md +1 -1
- package/common/utils/workflow-management.md +1 -1
- package/dist/agents/analyst.txt +21 -21
- package/dist/agents/architect.txt +3 -3
- package/dist/agents/bmad-master.txt +31 -31
- package/dist/agents/bmad-orchestrator.txt +44 -44
- package/dist/agents/dev.txt +2 -2
- package/dist/agents/pm.txt +5 -5
- package/dist/agents/po.txt +5 -5
- package/dist/agents/qa.txt +3 -3
- package/dist/agents/sm.txt +5 -5
- package/dist/agents/ux-expert.txt +3 -3
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +2 -2
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +2 -2
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +2 -2
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +29 -29
- package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +21 -21
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +14 -14
- package/dist/teams/team-all.txt +48 -48
- package/dist/teams/team-fullstack.txt +46 -46
- package/dist/teams/team-ide-minimal.txt +48 -48
- package/dist/teams/team-no-ui.txt +46 -46
- package/docs/agentic-tools/claude-code-guide.md +5 -22
- package/docs/agentic-tools/cline-guide.md +3 -29
- package/docs/agentic-tools/cursor-guide.md +4 -27
- package/docs/agentic-tools/gemini-cli-guide.md +3 -17
- package/docs/agentic-tools/github-copilot-guide.md +22 -0
- package/docs/agentic-tools/roo-code-guide.md +2 -35
- package/docs/agentic-tools/windsurf-guide.md +3 -28
- package/docs/bmad-workflow-guide.md +8 -8
- package/docs/core-architecture.md +19 -184
- package/docs/expansion-packs.md +4 -4
- package/docs/how-to-contribute-with-pull-requests.md +1 -1
- package/docs/user-guide.md +29 -414
- package/docs/versions.md +4 -4
- package/docs/working-in-the-brownfield.md +9 -6
- package/expansion-packs/README.md +2 -2
- package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
- package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +3 -3
- package/expansion-packs/bmad-creator-tools/README.md +2 -2
- package/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.md +8 -8
- package/expansion-packs/bmad-creator-tools/config.yaml +2 -2
- package/expansion-packs/bmad-creator-tools/tasks/create-agent.md +1 -1
- package/expansion-packs/bmad-creator-tools/tasks/generate-expansion-pack.md +9 -9
- package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.md +1 -1
- package/expansion-packs/bmad-infrastructure-devops/README.md +6 -6
- package/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md +1 -1
- package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
- package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +4 -4
- package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +4 -4
- package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.md +2 -2
- package/package.json +1 -1
- package/tools/bmad-npx-wrapper.js +1 -1
- package/tools/builders/web-builder.js +1 -1
- package/tools/cli.js +2 -2
- package/tools/installer/README.md +1 -51
- package/tools/installer/bin/bmad.js +9 -9
- package/tools/installer/config/install.config.yaml +10 -10
- package/tools/installer/lib/config-loader.js +2 -2
- package/tools/installer/lib/ide-setup.js +9 -9
- package/tools/installer/lib/installer.js +17 -17
- package/tools/installer/package.json +3 -3
- package/tools/md-assets/web-agent-startup-instructions.md +2 -2
- package/tools/upgraders/v3-to-v4-upgrader.js +2 -2
- package/tools/version-bump.js +1 -1
- package/tools/yaml-format.js +1 -1
- package/docs/agentic-tools/vs-code-copilot-guide.md +0 -53
- package/tools/installer/templates/claude-commands.md +0 -7
- package/tools/installer/templates/cursor-rules.md +0 -22
- 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
|
|
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
|
|
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
|
|
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
|
|
450
|
-
choices.push({ name: `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
|
|
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
|
|
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
|
|
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
|
|
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✓
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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("\
|
|
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
|
|
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.
|
|
4
|
-
"description": "
|
|
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": "
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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/)");
|
package/tools/version-bump.js
CHANGED
package/tools/yaml-format.js
CHANGED
|
@@ -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,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
|