bmad-method 4.24.3 → 4.24.5

package/tools/installer/lib/ide-setup.js

@@ -63,7 +63,7 @@ class IdeSetup {
         return this.setupCline(installDir, selectedAgent);
       case "gemini":
         return this.setupGeminiCli(installDir, selectedAgent);
-      case "vs-code-copilot":
+      case "github-copilot":
         return this.setupVsCodeCopilot(installDir, selectedAgent, spinner);
       default:
         console.log(chalk.yellow(`\nIDE ${ide} not yet supported`));
@@ -98,7 +98,7 @@ class IdeSetup {
         )} agent persona.\n\n`;
         mdcContent += "## Agent Activation\n\n";
         mdcContent +=
-          "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";
+          "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";
         mdcContent += "```yaml\n";
         // Extract just the YAML content from the agent file
         const yamlContent = extractYamlFromAgent(agentContent);
@@ -116,7 +116,7 @@ class IdeSetup {
         mdcContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
           agentId,
           installDir
-        )} persona and follow all instructions defined in the YML configuration above.\n`;
+        )} persona and follow all instructions defined in the YAML configuration above.\n`;
 
         await fileManager.writeFile(mdcPath, mdcContent);
         console.log(chalk.green(`✓ Created rule: ${agentId}.mdc`));
@@ -180,7 +180,7 @@ class IdeSetup {
         )} agent persona.\n\n`;
         mdContent += "## Agent Activation\n\n";
         mdContent +=
-          "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";
+          "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";
         mdContent += "```yaml\n";
         // Extract just the YAML content from the agent file
         const yamlContent = extractYamlFromAgent(agentContent);
@@ -198,7 +198,7 @@ class IdeSetup {
         mdContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
           agentId,
           installDir
-        )} persona and follow all instructions defined in the YML configuration above.\n`;
+        )} persona and follow all instructions defined in the YAML configuration above.\n`;
 
         await fileManager.writeFile(mdPath, mdContent);
         console.log(chalk.green(`✓ Created rule: ${agentId}.md`));
@@ -362,7 +362,7 @@ class IdeSetup {
           newModesContent += `   whenToUse: ${whenToUse}\n`;
           // Get relative path from installDir to agent file
           const relativePath = path.relative(installDir, agentPath).replace(/\\/g, '/');
-          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`;
+          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`;
           newModesContent += `   groups:\n`;
           newModesContent += `    - read\n`;
 
@@ -559,8 +559,8 @@ tools: ['changes', 'codebase', 'fetch', 'findTestFiles', 'githubRepo', 'problems
       }
     }
 
-    console.log(chalk.green(`\n✓ VS Code Copilot setup complete!`));
-    console.log(chalk.dim(`You can now find the BMAD agents in the Chat view's mode selector.`));
+    console.log(chalk.green(`\n✓ Github Copilot setup complete!`));
+    console.log(chalk.dim(`You can now find the BMad agents in the Chat view's mode selector.`));
 
     return true;
   }
@@ -578,7 +578,7 @@ tools: ['changes', 'codebase', 'fetch', 'findTestFiles', 'githubRepo', 'problems
       try {
         const existingContent = await fileManager.readFile(settingsPath);
         existingSettings = JSON.parse(existingContent);
-        console.log(chalk.yellow("Found existing .vscode/settings.json. Merging BMAD settings..."));
+        console.log(chalk.yellow("Found existing .vscode/settings.json. Merging BMad settings..."));
       } catch (error) {
         console.warn(chalk.yellow("Could not parse existing settings.json. Creating new one."));
         existingSettings = {};
@@ -587,15 +587,15 @@ tools: ['changes', 'codebase', 'fetch', 'findTestFiles', 'githubRepo', 'problems
     
     // Clear any previous output and add spacing to avoid conflicts with loaders
     console.log('\n'.repeat(2));
-    console.log(chalk.blue("🔧 VS Code Copilot Agent Settings Configuration"));
-    console.log(chalk.dim("BMAD works best with specific VS Code settings for optimal agent experience."));
+    console.log(chalk.blue("🔧 Github Copilot Agent Settings Configuration"));
+    console.log(chalk.dim("BMad works best with specific VS Code settings for optimal agent experience."));
     console.log(''); // Add extra spacing
     
     const { configChoice } = await inquirer.prompt([
       {
         type: 'list',
         name: 'configChoice',
-        message: 'How would you like to configure VS Code Copilot settings?',
+        message: 'How would you like to configure Github Copilot settings?',
         choices: [
           {
             name: 'Use recommended defaults (fastest setup)',
@@ -638,7 +638,7 @@ tools: ['changes', 'codebase', 'fetch', 'findTestFiles', 'githubRepo', 'problems
         "github.copilot.chat.agent.autoFix": true,
         "chat.tools.autoApprove": false
       };
-      console.log(chalk.green("✓ Using recommended BMAD defaults for VS Code Copilot settings"));
+      console.log(chalk.green("✓ Using recommended BMad defaults for Github Copilot settings"));
     } else {
       // Manual configuration
       console.log(chalk.blue("\n📋 Let's configure each setting for your preferences:"));
@@ -696,7 +696,7 @@ tools: ['changes', 'codebase', 'fetch', 'findTestFiles', 'githubRepo', 'problems
       }
       
       bmadSettings = {
-        "chat.agent.enabled": true, // Always enabled - required for BMAD agents
+        "chat.agent.enabled": true, // Always enabled - required for BMad agents
         "chat.agent.maxRequests": parseInt(manualSettings.maxRequests),
         "github.copilot.chat.agent.runTasks": manualSettings.runTasks,
         "chat.mcp.discovery.enabled": manualSettings.mcpDiscovery,

package/tools/installer/lib/installer.js

@@ -220,7 +220,7 @@ class Installer {
     });
 
     if (files.length > 0) {
-      // Directory has other files, but no BMAD installation.
+      // Directory has other files, but no BMad installation.
       // Treat as clean install but record that it isn't empty.
       state.hasOtherFiles = true;
     }
@@ -235,7 +235,7 @@ class Installer {
   async performFreshInstall(config, installDir, spinner, options = {}) {
     // Ensure modules are initialized
     await initializeModules();
-    spinner.text = "Installing BMAD Method...";
+    spinner.text = "Installing BMad Method...";
 
     let files = [];
 
@@ -396,7 +396,7 @@ class Installer {
     const newVersion = await this.getCoreVersion();
     const versionCompare = this.compareVersions(currentVersion, newVersion);
 
-    console.log(chalk.yellow("\n🔍 Found existing BMAD v4 installation"));
+    console.log(chalk.yellow("\n🔍 Found existing BMad v4 installation"));
     console.log(`   Directory: ${installDir}`);
     console.log(`   Current version: ${currentVersion}`);
     console.log(`   Available version: ${newVersion}`);
@@ -446,8 +446,8 @@ class Installer {
     let choices = [];
     
     if (versionCompare < 0) {
-      console.log(chalk.cyan("\n⬆️  Upgrade available for BMAD core"));
-      choices.push({ name: `Upgrade BMAD core (v${currentVersion} → v${newVersion})`, value: "upgrade" });
+      console.log(chalk.cyan("\n⬆️  Upgrade available for BMad core"));
+      choices.push({ name: `Upgrade BMad core (v${currentVersion} → v${newVersion})`, value: "upgrade" });
     } else if (versionCompare === 0) {
       if (hasIntegrityIssues) {
         // Offer repair option when files are missing or modified
@@ -457,10 +457,10 @@ class Installer {
         });
       }
       console.log(chalk.yellow("\n⚠️  Same version already installed"));
-      choices.push({ name: `Force reinstall BMAD core (v${currentVersion} - reinstall)`, value: "reinstall" });
+      choices.push({ name: `Force reinstall BMad core (v${currentVersion} - reinstall)`, value: "reinstall" });
     } else {
       console.log(chalk.yellow("\n⬇️  Installed version is newer than available"));
-      choices.push({ name: `Downgrade BMAD core (v${currentVersion} → v${newVersion})`, value: "reinstall" });
+      choices.push({ name: `Downgrade BMad core (v${currentVersion} → v${newVersion})`, value: "reinstall" });
     }
     
     choices.push(
@@ -535,7 +535,7 @@ class Installer {
     spinner.stop();
 
     console.log(
-      chalk.yellow("\n🔍 Found BMAD v3 installation (bmad-agent/ directory)")
+      chalk.yellow("\n🔍 Found BMad v3 installation (bmad-agent/ directory)")
     );
     console.log(`   Directory: ${installDir}`);
 
@@ -685,6 +685,10 @@ class Installer {
       };
 
       await this.performFreshInstall(config, installDir, spinner, { isUpdate: true });
+      
+      // Clean up .yml files that now have .yaml counterparts
+      spinner.text = "Cleaning up legacy .yml files...";
+      await this.cleanupLegacyYmlFiles(installDir, spinner);
     } catch (error) {
       spinner.fail("Update failed");
       throw error;
@@ -737,12 +741,27 @@ class Installer {
           if (await fileManager.pathExists(sourcePath)) {
             await fileManager.copyFile(sourcePath, destPath);
             spinner.text = `Restored: ${file}`;
+            
+            // If this is a .yaml file, check for and remove corresponding .yml file
+            if (file.endsWith('.yaml')) {
+              const ymlFile = file.replace(/\.yaml$/, '.yml');
+              const ymlPath = path.join(installDir, ymlFile);
+              if (await fileManager.pathExists(ymlPath)) {
+                const fs = require('fs').promises;
+                await fs.unlink(ymlPath);
+                console.log(chalk.dim(`  Removed legacy: ${ymlFile} (replaced by ${file})`));
+              }
+            }
           } else {
             console.warn(chalk.yellow(`  Warning: Source file not found: ${file}`));
           }
         }
       }
       
+      // Clean up .yml files that now have .yaml counterparts
+      spinner.text = "Cleaning up legacy .yml files...";
+      await this.cleanupLegacyYmlFiles(installDir, spinner);
+      
       spinner.succeed("Repair completed successfully!");
       
       // Show summary
@@ -768,7 +787,7 @@ class Installer {
   }
 
   async performReinstall(config, installDir, spinner) {
-    spinner.start("Preparing to reinstall BMAD Method...");
+    spinner.start("Preparing to reinstall BMad Method...");
 
     // Remove existing .bmad-core
     const bmadCorePath = path.join(installDir, ".bmad-core");
@@ -778,11 +797,17 @@ class Installer {
     }
     
     spinner.text = "Installing fresh copy...";
-    return await this.performFreshInstall(config, installDir, spinner, { isUpdate: true });
+    const result = await this.performFreshInstall(config, installDir, spinner, { isUpdate: true });
+    
+    // Clean up .yml files that now have .yaml counterparts
+    spinner.text = "Cleaning up legacy .yml files...";
+    await this.cleanupLegacyYmlFiles(installDir, spinner);
+    
+    return result;
   }
 
   showSuccessMessage(config, installDir, options = {}) {
-    console.log(chalk.green("\n✓ BMAD Method installed successfully!\n"));
+    console.log(chalk.green("\n✓ BMad Method installed successfully!\n"));
 
     const ides = config.ides || (config.ide ? [config.ide] : []);
     if (ides.length > 0) {
@@ -790,7 +815,7 @@ class Installer {
         const ideConfig = configLoader.getIdeConfiguration(ide);
         if (ideConfig?.instructions) {
           console.log(
-            chalk.bold(`To use BMAD agents in ${ideConfig.name}:`)
+            chalk.bold(`To use BMad agents in ${ideConfig.name}:`)
           );
           console.log(ideConfig.instructions);
         }
@@ -879,7 +904,7 @@ class Installer {
       };
       return await this.install(config);
     }
-    console.log(chalk.red("No BMAD installation found."));
+    console.log(chalk.red("No BMad installation found."));
   }
 
   async listAgents() {
@@ -887,7 +912,7 @@ class Installer {
     await initializeModules();
     const agents = await configLoader.getAvailableAgents();
 
-    console.log(chalk.bold("\nAvailable BMAD Agents:\n"));
+    console.log(chalk.bold("\nAvailable BMad Agents:\n"));
 
     for (const agent of agents) {
       console.log(chalk.cyan(`  ${agent.id.padEnd(20)}`), agent.description);
@@ -903,7 +928,7 @@ class Installer {
     await initializeModules();
     const expansionPacks = await this.getAvailableExpansionPacks();
 
-    console.log(chalk.bold("\nAvailable BMAD Expansion Packs:\n"));
+    console.log(chalk.bold("\nAvailable BMad Expansion Packs:\n"));
 
     if (expansionPacks.length === 0) {
       console.log(chalk.yellow("No expansion packs found."));
@@ -932,7 +957,7 @@ class Installer {
 
     if (!installDir) {
       console.log(
-        chalk.yellow("No BMAD installation found in current directory tree")
+        chalk.yellow("No BMad installation found in current directory tree")
       );
       return;
     }
@@ -944,7 +969,7 @@ class Installer {
       return;
     }
 
-    console.log(chalk.bold("\nBMAD Installation Status:\n"));
+    console.log(chalk.bold("\nBMad Installation Status:\n"));
     console.log(`  Directory:      ${installDir}`);
     console.log(`  Version:        ${manifest.version}`);
     console.log(
@@ -1399,7 +1424,7 @@ class Installer {
     await initializeModules();
     
     try {
-      // Find the dist directory in the BMAD installation
+      // Find the dist directory in the BMad installation
       const distDir = configLoader.getDistPath();
       
       if (!(await fileManager.pathExists(distDir))) {
@@ -1637,6 +1662,42 @@ class Installer {
     return 0;
   }
 
+  async cleanupLegacyYmlFiles(installDir, spinner) {
+    const glob = require('glob');
+    const fs = require('fs').promises;
+    
+    try {
+      // Find all .yml files in the installation directory
+      const ymlFiles = glob.sync('**/*.yml', {
+        cwd: installDir,
+        ignore: ['**/node_modules/**', '**/.git/**']
+      });
+      
+      let deletedCount = 0;
+      
+      for (const ymlFile of ymlFiles) {
+        // Check if corresponding .yaml file exists
+        const yamlFile = ymlFile.replace(/\.yml$/, '.yaml');
+        const ymlPath = path.join(installDir, ymlFile);
+        const yamlPath = path.join(installDir, yamlFile);
+        
+        if (await fileManager.pathExists(yamlPath)) {
+          // .yaml counterpart exists, delete the .yml file
+          await fs.unlink(ymlPath);
+          deletedCount++;
+          console.log(chalk.dim(`  Removed legacy: ${ymlFile} (replaced by ${yamlFile})`));
+        }
+      }
+      
+      if (deletedCount > 0) {
+        console.log(chalk.green(`✓ Cleaned up ${deletedCount} legacy .yml files`));
+      }
+      
+    } catch (error) {
+      console.warn(chalk.yellow(`Warning: Could not cleanup legacy .yml files: ${error.message}`));
+    }
+  }
+
   async findInstallation() {
     // Look for .bmad-core in current directory or parent directories
     let currentDir = process.cwd();

package/tools/installer/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bmad-method",
-  "version": "4.24.3",
-  "description": "BMAD Method installer - AI-powered Agile development framework",
+  "version": "4.24.5",
+  "description": "BMad Method installer - AI-powered Agile development framework",
   "main": "lib/installer.js",
   "bin": {
     "bmad": "./bin/bmad.js",
@@ -19,7 +19,7 @@
     "installer",
     "agents"
   ],
-  "author": "BMAD Team",
+  "author": "BMad Team",
   "license": "MIT",
   "dependencies": {
     "chalk": "^5.4.1",

package/tools/md-assets/web-agent-startup-instructions.md

@@ -1,6 +1,6 @@
 # Web Agent Bundle Instructions
 
-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.
+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.
 
 ## Important Instructions
 
@@ -34,6 +34,6 @@ These references map directly to bundle sections:
 
 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.
 
-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.
+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.
 
 ---

package/tools/upgraders/v3-to-v4-upgrader.js

@@ -26,10 +26,10 @@ class V3ToV4Upgrader {
 
       // 1. Welcome message
       console.log(
-        chalk.bold("\nWelcome to BMAD-METHOD V3 to V4 Upgrade Tool\n")
+        chalk.bold("\nWelcome to BMad-Method V3 to V4 Upgrade Tool\n")
       );
       console.log(
-        "This tool will help you upgrade your BMAD-METHOD V3 project to V4.\n"
+        "This tool will help you upgrade your BMad-Method V3 project to V4.\n"
       );
       console.log(chalk.cyan("What this tool does:"));
       console.log("- Creates a backup of your V3 files (.bmad-v3-backup/)");

package/tools/version-bump.js

@@ -15,7 +15,7 @@ async function initializeModules() {
 }
 
 /**
- * Simple version bumping script for BMAD-METHOD
+ * Simple version bumping script for BMad-Method
  * Usage: node tools/version-bump.js [patch|minor|major]
  */
 

package/tools/yaml-format.js

@@ -16,7 +16,7 @@ async function initializeModules() {
 }
 
 /**
- * YAML Formatter and Linter for BMAD-METHOD
+ * YAML Formatter and Linter for BMad-Method
  * Formats and validates YAML files and YAML embedded in Markdown
  */
 

package/docs/agentic-tools/vs-code-copilot-guide.md

@@ -1,53 +0,0 @@
-# BMAD Method Guide for Visual Studio Code
-
-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).
-
-## Installation
-
-When running `npx bmad-method install`, select **Visual Studio Code** as your IDE. This command will perform the following actions:
-
-- Create the `.bmad-core/` directory with all the agent rule files.
-
-- Create the `.vscode/` directory and add a `settings.json` file with the basic configuration to enable GitHub Copilot's agent mode.
-
-## Using BMAD Agents in VS Code
-
-1. In the GitHub Copilot Chat window, select **Agent** from the chat mode dropdown list (usually located next to the input field).
-
-2. Once in Agent Mode, type `@` and the agent's name in the chat input to activate it:
-
-- `@bmad-master` - Universal task executor
-
-- `@sm` - Scrum Master
-
-- `@dev` - Full-stack developer
-
-- `@architect` - Solution architect
-
-- `@pm` - Product manager
-
-- `@analyst` - Business analyst
-
-- `@qa` - QA specialist
-
-- `@po` - Product owner
-
-- `@ux-expert` - UX specialist
-
-## VS Code Specific Features
-
-- **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.
-
-- **Activation**: Use the `@` prefix in the GitHub Copilot Chat for instant switching between agents.
-
-- **Collaboration**: Fully compatible with **Live Share**, allowing you, your team, and BMAD agents to work together in real-time.
-
-- **Project Context**: Agents have full access to your workspace, including open files and the selected code.
-
-## Tips for VS Code Users
-
-- Use the `help` command (e.g., `@dev help`) to see the available commands for each agent.
-
-- Use `@workspace` in the Copilot Chat to ask questions about your entire project.
-
-- Consider adding `.vscode/` and `.bmad-core/` to your `.gitignore` file in team projects to avoid conflicts with personal settings.

package/tools/installer/templates/claude-commands.md

@@ -1,7 +0,0 @@
-# {{AGENT_NAME}} Agent
-
-{{AGENT_CONTENT}}
-
----
-
-This is a BMAD Method agent. For more information, visit: https://github.com/your-org/bmad-method

package/tools/installer/templates/cursor-rules.md

@@ -1,22 +0,0 @@
-# BMAD Method Agents for Cursor
-
-This file contains all BMAD Method agent personas. To use an agent, type its name or alias in the Cursor chat.
-
-## Available Agents
-
-{{AGENT_LIST}}
-
----
-
-{{AGENT_RULES}}
-
----
-
-# Agent Switching
-
-To switch between agents during a conversation:
-
-1. Simply type the new agent name (e.g., "architect" or "dev")
-2. The AI will adopt that agent's persona
-
-For more information about BMAD Method, visit: https://github.com/your-org/bmad-method

package/tools/installer/templates/windsurf-rules.md

@@ -1,22 +0,0 @@
-# BMAD Method Agent Commands
-
-This file contains all BMAD Method agent commands for Windsurf. Use /agent-name to switch personas.
-
-## Available Commands
-
-{{COMMAND_LIST}}
-
----
-
-{{AGENT_SECTIONS}}
-
----
-
-# Usage Tips
-
-- Type `/dev` to switch to Developer persona
-- Type `/pm` to switch to Product Manager persona
-- Type `/architect` to switch to Architect persona
-- And so on for other agents...
-
-For more information about BMAD Method, visit: https://github.com/your-org/bmad-method