bmad-method 6.0.0-alpha.12 → 6.0.0-alpha.14

package/tools/cli/installers/lib/ide/github-copilot.js

@@ -6,13 +6,13 @@ const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * GitHub Copilot setup handler
- * Creates chat modes in .github/chatmodes/ and configures VS Code settings
+ * Creates agents in .github/agents/ and configures VS Code settings
  */
 class GitHubCopilotSetup extends BaseIdeSetup {
   constructor() {
     super('github-copilot', 'GitHub Copilot', true); // preferred IDE
     this.configDir = '.github';
-    this.chatmodesDir = 'chatmodes';
+    this.agentsDir = 'agents';
     this.vscodeDir = '.vscode';
   }
 
@@ -50,7 +50,8 @@ class GitHubCopilotSetup extends BaseIdeSetup {
           message: 'Maximum requests per session (1-50)?',
           default: '15',
           validate: (input) => {
-            const num = parseInt(input);
+            const num = parseInt(input, 10);
+            if (isNaN(num)) return 'Enter a valid number 1-50';
             return (num >= 1 && num <= 50) || 'Enter 1-50';
           },
         },
@@ -97,10 +98,10 @@ class GitHubCopilotSetup extends BaseIdeSetup {
     const config = options.preCollectedConfig || {};
     await this.configureVsCodeSettings(projectDir, { ...options, ...config });
 
-    // Create .github/chatmodes directory
+    // Create .github/agents directory
     const githubDir = path.join(projectDir, this.configDir);
-    const chatmodesDir = path.join(githubDir, this.chatmodesDir);
-    await this.ensureDir(chatmodesDir);
+    const agentsDir = path.join(githubDir, this.agentsDir);
+    await this.ensureDir(agentsDir);
 
     // Clean up any existing BMAD files before reinstalling
     await this.cleanup(projectDir);
@@ -109,29 +110,29 @@ class GitHubCopilotSetup extends BaseIdeSetup {
     const agentGen = new AgentCommandGenerator(this.bmadFolderName);
     const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
 
-    // Create chat mode files with bmad- prefix
-    let modeCount = 0;
+    // Create agent files with bmd- prefix
+    let agentCount = 0;
     for (const artifact of agentArtifacts) {
       const content = artifact.content;
-      const chatmodeContent = await this.createChatmodeContent({ module: artifact.module, name: artifact.name }, content);
+      const agentContent = await this.createAgentContent({ module: artifact.module, name: artifact.name }, content);
 
-      // Use bmad- prefix: bmad-agent-{module}-{name}.chatmode.md
-      const targetPath = path.join(chatmodesDir, `bmad-agent-${artifact.module}-${artifact.name}.chatmode.md`);
-      await this.writeFile(targetPath, chatmodeContent);
-      modeCount++;
+      // Use bmd- prefix: bmd-custom-{module}-{name}.agent.md
+      const targetPath = path.join(agentsDir, `bmd-custom-${artifact.module}-${artifact.name}.agent.md`);
+      await this.writeFile(targetPath, agentContent);
+      agentCount++;
 
-      console.log(chalk.green(`  ✓ Created chat mode: bmad-agent-${artifact.module}-${artifact.name}`));
+      console.log(chalk.green(`  ✓ Created agent: bmd-custom-${artifact.module}-${artifact.name}`));
     }
 
     console.log(chalk.green(`✓ ${this.name} configured:`));
-    console.log(chalk.dim(`  - ${modeCount} chat modes created`));
-    console.log(chalk.dim(`  - Chat modes directory: ${path.relative(projectDir, chatmodesDir)}`));
+    console.log(chalk.dim(`  - ${agentCount} agents created`));
+    console.log(chalk.dim(`  - Agents directory: ${path.relative(projectDir, agentsDir)}`));
     console.log(chalk.dim(`  - VS Code settings configured`));
-    console.log(chalk.dim('\n  Chat modes available in VS Code Chat view'));
+    console.log(chalk.dim('\n  Agents available in VS Code Chat view'));
 
     return {
       success: true,
-      chatmodes: modeCount,
+      agents: agentCount,
       settings: true,
     };
   }
@@ -187,9 +188,10 @@ class GitHubCopilotSetup extends BaseIdeSetup {
       // Manual configuration - use pre-collected settings
       const manual = options.manualSettings || {};
 
+      const maxRequests = parseInt(manual.maxRequests || '15', 10);
       bmadSettings = {
         'chat.agent.enabled': true,
-        'chat.agent.maxRequests': parseInt(manual.maxRequests || 15),
+        'chat.agent.maxRequests': isNaN(maxRequests) ? 15 : maxRequests,
         'github.copilot.chat.agent.runTasks': manual.runTasks === undefined ? true : manual.runTasks,
         'chat.mcp.discovery.enabled': manual.mcpDiscovery === undefined ? true : manual.mcpDiscovery,
         'github.copilot.chat.agent.autoFix': manual.autoFix === undefined ? true : manual.autoFix,
@@ -206,9 +208,9 @@ class GitHubCopilotSetup extends BaseIdeSetup {
   }
 
   /**
-   * Create chat mode content
+   * Create agent content
    */
-  async createChatmodeContent(agent, content) {
+  async createAgentContent(agent, content) {
     // Extract metadata from launcher frontmatter if present
     const descMatch = content.match(/description:\s*"([^"]+)"/);
     const title = descMatch ? descMatch[1] : this.formatTitle(agent.name);
@@ -226,30 +228,21 @@ class GitHubCopilotSetup extends BaseIdeSetup {
     // Reference: https://code.visualstudio.com/docs/copilot/reference/copilot-vscode-features#_chat-tools
     const tools = [
       'changes', // List of source control changes
-      'codebase', // Perform code search in workspace
-      'createDirectory', // Create new directory in workspace
-      'createFile', // Create new file in workspace
-      'editFiles', // Apply edits to files in workspace
+      'edit', // Edit files in your workspace including: createFile, createDirectory, editNotebook, newJupyterNotebook and editFiles
       'fetch', // Fetch content from web page
-      'fileSearch', // Search files using glob patterns
       'githubRepo', // Perform code search in GitHub repo
-      'listDirectory', // List files in a directory
       'problems', // Add workspace issues from Problems panel
-      'readFile', // Read content of a file in workspace
-      'runInTerminal', // Run shell command in integrated terminal
-      'runTask', // Run existing task in workspace
+      'runCommands', // Runs commands in the terminal including: getTerminalOutput, terminalSelection, terminalLastCommand and runInTerminal
+      'runTasks', // Runs tasks and gets their output for your workspace
       'runTests', // Run unit tests in workspace
-      'runVscodeCommand', // Run VS Code command
-      'search', // Enable file searching in workspace
-      'searchResults', // Get search results from Search view
-      'terminalLastCommand', // Get last terminal command and output
-      'terminalSelection', // Get current terminal selection
+      'search', // Search and read files in your workspace, including:fileSearch, textSearch, listDirectory, readFile, codebase and searchResults
+      'runSubagent', // Runs a task within an isolated subagent context. Enables efficient organization of tasks and context window management.
       'testFailure', // Get unit test failure information
-      'textSearch', // Find text in files
+      'todos', // Tool for managing and tracking todo items for task planning
       'usages', // Find references and navigate definitions
     ];
 
-    let chatmodeContent = `---
+    let agentContent = `---
 description: "${description.replaceAll('"', String.raw`\"`)}"
 tools: ${JSON.stringify(tools)}
 ---
@@ -260,7 +253,7 @@ ${cleanContent}
 
 `;
 
-    return chatmodeContent;
+    return agentContent;
   }
 
   /**
@@ -278,10 +271,10 @@ ${cleanContent}
    */
   async cleanup(projectDir) {
     const fs = require('fs-extra');
-    const chatmodesDir = path.join(projectDir, this.configDir, this.chatmodesDir);
 
+    // Clean up old chatmodes directory
+    const chatmodesDir = path.join(projectDir, this.configDir, 'chatmodes');
     if (await fs.pathExists(chatmodesDir)) {
-      // Only remove files that start with bmad- prefix
       const files = await fs.readdir(chatmodesDir);
       let removed = 0;
 
@@ -293,7 +286,25 @@ ${cleanContent}
       }
 
       if (removed > 0) {
-        console.log(chalk.dim(`  Cleaned up ${removed} existing BMAD chat modes`));
+        console.log(chalk.dim(`  Cleaned up ${removed} old BMAD chat modes`));
+      }
+    }
+
+    // Clean up new agents directory
+    const agentsDir = path.join(projectDir, this.configDir, this.agentsDir);
+    if (await fs.pathExists(agentsDir)) {
+      const files = await fs.readdir(agentsDir);
+      let removed = 0;
+
+      for (const file of files) {
+        if (file.startsWith('bmd-') && file.endsWith('.agent.md')) {
+          await fs.remove(path.join(agentsDir, file));
+          removed++;
+        }
+      }
+
+      if (removed > 0) {
+        console.log(chalk.dim(`  Cleaned up ${removed} existing BMAD agents`));
       }
     }
   }
@@ -307,13 +318,13 @@ ${cleanContent}
    * @returns {Object|null} Info about created command
    */
   async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
-    const chatmodesDir = path.join(projectDir, this.configDir, this.chatmodesDir);
+    const agentsDir = path.join(projectDir, this.configDir, this.agentsDir);
 
     if (!(await this.exists(path.join(projectDir, this.configDir)))) {
       return null; // IDE not configured for this project
     }
 
-    await this.ensureDir(chatmodesDir);
+    await this.ensureDir(agentsDir);
 
     const launcherContent = `You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
@@ -353,7 +364,7 @@ ${cleanContent}
       'usages',
     ];
 
-    const chatmodeContent = `---
+    const agentContent = `---
 description: "Activates the ${metadata.title || agentName} agent persona."
 tools: ${JSON.stringify(copilotTools)}
 ---
@@ -363,12 +374,12 @@ tools: ${JSON.stringify(copilotTools)}
 ${launcherContent}
 `;
 
-    const chatmodePath = path.join(chatmodesDir, `bmad-agent-custom-${agentName}.chatmode.md`);
-    await this.writeFile(chatmodePath, chatmodeContent);
+    const agentFilePath = path.join(agentsDir, `bmd-custom-${agentName}.agent.md`);
+    await this.writeFile(agentFilePath, agentContent);
 
     return {
-      path: chatmodePath,
-      command: `bmad-agent-custom-${agentName}`,
+      path: agentFilePath,
+      command: `bmd-custom-${agentName}`,
     };
   }
 }

package/tools/cli/installers/lib/ide/iflow.js

@@ -1,7 +1,9 @@
 const path = require('node:path');
+const fs = require('fs-extra');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
 const { AgentCommandGenerator } = require('./shared/agent-command-generator');
+const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');
 
 /**
  * iFlow CLI setup handler
@@ -28,9 +30,11 @@ class IFlowSetup extends BaseIdeSetup {
     const commandsDir = path.join(iflowDir, this.commandsDir, 'bmad');
     const agentsDir = path.join(commandsDir, 'agents');
     const tasksDir = path.join(commandsDir, 'tasks');
+    const workflowsDir = path.join(commandsDir, 'workflows');
 
     await this.ensureDir(agentsDir);
     await this.ensureDir(tasksDir);
+    await this.ensureDir(workflowsDir);
 
     // Generate agent launchers
     const agentGen = new AgentCommandGenerator(this.bmadFolderName);
@@ -46,9 +50,13 @@ class IFlowSetup extends BaseIdeSetup {
       agentCount++;
     }
 
-    // Get tasks
+    // Get tasks and workflows (ALL workflows now generate commands)
     const tasks = await this.getTasks(bmadDir);
 
+    // Get ALL workflows using the new workflow command generator
+    const workflowGenerator = new WorkflowCommandGenerator(this.bmadFolderName);
+    const { artifacts: workflowArtifacts, counts: workflowCounts } = await workflowGenerator.collectWorkflowArtifacts(bmadDir);
+
     // Setup tasks as commands
     let taskCount = 0;
     for (const task of tasks) {
@@ -60,15 +68,27 @@ class IFlowSetup extends BaseIdeSetup {
       taskCount++;
     }
 
+    // Setup workflows as commands (already generated)
+    let workflowCount = 0;
+    for (const artifact of workflowArtifacts) {
+      if (artifact.type === 'workflow-command') {
+        const targetPath = path.join(workflowsDir, `${artifact.module}-${path.basename(artifact.relativePath, '.md')}.md`);
+        await this.writeFile(targetPath, artifact.content);
+        workflowCount++;
+      }
+    }
+
     console.log(chalk.green(`✓ ${this.name} configured:`));
     console.log(chalk.dim(`  - ${agentCount} agent commands created`));
     console.log(chalk.dim(`  - ${taskCount} task commands created`));
+    console.log(chalk.dim(`  - ${workflowCount} workflow commands created`));
     console.log(chalk.dim(`  - Commands directory: ${path.relative(projectDir, commandsDir)}`));
 
     return {
       success: true,
       agents: agentCount,
       tasks: taskCount,
+      workflows: workflowCount,
     };
   }
 
@@ -120,6 +140,52 @@ Part of the BMAD ${task.module.toUpperCase()} module.
       console.log(chalk.dim(`Removed BMAD commands from iFlow CLI`));
     }
   }
+
+  /**
+   * Install a custom agent launcher for iFlow
+   * @param {string} projectDir - Project directory
+   * @param {string} agentName - Agent name (e.g., "fred-commit-poet")
+   * @param {string} agentPath - Path to compiled agent (relative to project root)
+   * @param {Object} metadata - Agent metadata
+   * @returns {Object} Installation result
+   */
+  async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
+    const iflowDir = path.join(projectDir, this.configDir);
+    const bmadCommandsDir = path.join(iflowDir, this.commandsDir, 'bmad');
+
+    // Create .iflow/commands/bmad directory if it doesn't exist
+    await fs.ensureDir(bmadCommandsDir);
+
+    // Create custom agent launcher
+    const launcherContent = `# ${agentName} Custom Agent
+
+**⚠️ IMPORTANT**: Run @${agentPath} first to load the complete agent!
+
+This is a launcher for the custom BMAD agent "${agentName}".
+
+## Usage
+1. First run: \`${agentPath}\` to load the complete agent
+2. Then use this command to activate ${agentName}
+
+The agent will follow the persona and instructions from the main agent file.
+
+---
+
+*Generated by BMAD Method*`;
+
+    const fileName = `custom-${agentName.toLowerCase()}.md`;
+    const launcherPath = path.join(bmadCommandsDir, fileName);
+
+    // Write the launcher file
+    await fs.writeFile(launcherPath, launcherContent, 'utf8');
+
+    return {
+      ide: 'iflow',
+      path: path.relative(projectDir, launcherPath),
+      command: agentName,
+      type: 'custom-agent-launcher',
+    };
+  }
 }
 
 module.exports = { IFlowSetup };

package/tools/cli/installers/lib/ide/kilo.js

@@ -123,6 +123,9 @@ class KiloSetup extends BaseIdeSetup {
     modeEntry += `   groups:\n`;
     modeEntry += `    - read\n`;
     modeEntry += `    - edit\n`;
+    modeEntry += `    - browser\n`;
+    modeEntry += `    - command\n`;
+    modeEntry += `    - mcp\n`;
 
     return modeEntry;
   }
@@ -170,6 +173,77 @@ class KiloSetup extends BaseIdeSetup {
       console.log(chalk.dim(`Removed ${removedCount} BMAD modes from .kilocodemodes`));
     }
   }
+
+  /**
+   * Install a custom agent launcher for Kilo
+   * @param {string} projectDir - Project directory
+   * @param {string} agentName - Agent name (e.g., "fred-commit-poet")
+   * @param {string} agentPath - Path to compiled agent (relative to project root)
+   * @param {Object} metadata - Agent metadata
+   * @returns {Object} Installation result
+   */
+  async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
+    const kilocodemodesPath = path.join(projectDir, this.configFile);
+    let existingContent = '';
+
+    // Read existing .kilocodemodes file
+    if (await this.pathExists(kilocodemodesPath)) {
+      existingContent = await this.readFile(kilocodemodesPath);
+    }
+
+    // Create custom agent mode entry
+    const slug = `bmad-custom-${agentName.toLowerCase()}`;
+    const modeEntry = ` - slug: ${slug}
+   name: 'BMAD Custom: ${agentName}'
+   description: |
+    Custom BMAD agent: ${agentName}
+
+    **⚠️ IMPORTANT**: Run @${agentPath} first to load the complete agent!
+
+    This is a launcher for the custom BMAD agent "${agentName}". The agent will follow the persona and instructions from the main agent file.
+   prompt: |
+    @${agentPath}
+   always: false
+   permissions: all
+`;
+
+    // Check if mode already exists
+    if (existingContent.includes(slug)) {
+      return {
+        ide: 'kilo',
+        path: this.configFile,
+        command: agentName,
+        type: 'custom-agent-launcher',
+        alreadyExists: true,
+      };
+    }
+
+    // Build final content
+    let finalContent = '';
+    if (existingContent) {
+      // Find customModes section or add it
+      if (existingContent.includes('customModes:')) {
+        // Append to existing customModes
+        finalContent = existingContent + modeEntry;
+      } else {
+        // Add customModes section
+        finalContent = existingContent.trim() + '\n\ncustomModes:\n' + modeEntry;
+      }
+    } else {
+      // Create new .kilocodemodes file with customModes
+      finalContent = 'customModes:\n' + modeEntry;
+    }
+
+    // Write .kilocodemodes file
+    await this.writeFile(kilocodemodesPath, finalContent);
+
+    return {
+      ide: 'kilo',
+      path: this.configFile,
+      command: slug,
+      type: 'custom-agent-launcher',
+    };
+  }
 }
 
 module.exports = { KiloSetup };