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

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

@@ -1,4 +1,5 @@
 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');
@@ -120,6 +121,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 };

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

@@ -1,4 +1,5 @@
 const path = require('node:path');
+const fs = require('fs-extra');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
 const { getAgentsFromBmad, getTasksFromBmad } = require('./shared/bmad-artifacts');
@@ -313,6 +314,59 @@ ${prompt}
       console.log(chalk.dim(`Removed old BMAD configuration from Qwen Code`));
     }
   }
+
+  /**
+   * Install a custom agent launcher for Qwen
+   * @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 qwenDir = path.join(projectDir, this.configDir);
+    const commandsDir = path.join(qwenDir, this.commandsDir);
+    const bmadCommandsDir = path.join(commandsDir, this.bmadDir);
+
+    // Create .qwen/commands/BMad directory if it doesn't exist
+    await fs.ensureDir(bmadCommandsDir);
+
+    // Create custom agent launcher in TOML format (same pattern as regular agents)
+    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*`;
+
+    // Use Qwen's TOML conversion method
+    const tomlContent = this.processAgentLauncherContent(launcherContent, {
+      name: agentName,
+      module: 'custom',
+    });
+
+    const fileName = `custom-${agentName.toLowerCase()}.toml`;
+    const launcherPath = path.join(bmadCommandsDir, fileName);
+
+    // Write the launcher file
+    await fs.writeFile(launcherPath, tomlContent, 'utf8');
+
+    return {
+      ide: 'qwen',
+      path: path.relative(projectDir, launcherPath),
+      command: agentName,
+      type: 'custom-agent-launcher',
+    };
+  }
 }
 
 module.exports = { QwenSetup };

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

@@ -248,6 +248,77 @@ class RooSetup extends BaseIdeSetup {
       console.log(chalk.dim(`Removed ${removedCount} BMAD modes from .roomodes`));
     }
   }
+
+  /**
+   * Install a custom agent launcher for Roo
+   * @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 roomodesPath = path.join(projectDir, this.configFile);
+    let existingContent = '';
+
+    // Read existing .roomodes file
+    if (await this.pathExists(roomodesPath)) {
+      existingContent = await this.readFile(roomodesPath);
+    }
+
+    // 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: 'roo',
+        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 .roomodes file with customModes
+      finalContent = 'customModes:\n' + modeEntry;
+    }
+
+    // Write .roomodes file
+    await this.writeFile(roomodesPath, finalContent);
+
+    return {
+      ide: 'roo',
+      path: this.configFile,
+      command: slug,
+      type: 'custom-agent-launcher',
+    };
+  }
 }
 
 module.exports = { RooSetup };

package/tools/cli/installers/lib/ide/rovo-dev.js

@@ -0,0 +1,290 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const chalk = require('chalk');
+const { BaseIdeSetup } = require('./_base-ide');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
+const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');
+const { TaskToolCommandGenerator } = require('./shared/task-tool-command-generator');
+
+/**
+ * Rovo Dev IDE setup handler
+ *
+ * Installs BMAD agents as Rovo Dev subagents in .rovodev/subagents/
+ * Installs workflows and tasks/tools as reference guides in .rovodev/
+ * Rovo Dev automatically discovers agents and integrates with BMAD like other IDEs
+ */
+class RovoDevSetup extends BaseIdeSetup {
+  constructor() {
+    super('rovo-dev', 'Atlassian Rovo Dev', true); // preferred IDE
+    this.configDir = '.rovodev';
+    this.subagentsDir = 'subagents';
+    this.workflowsDir = 'workflows';
+    this.referencesDir = 'references';
+  }
+
+  /**
+   * Cleanup old BMAD installation before reinstalling
+   * @param {string} projectDir - Project directory
+   */
+  async cleanup(projectDir) {
+    const rovoDevDir = path.join(projectDir, this.configDir);
+
+    if (!(await fs.pathExists(rovoDevDir))) {
+      return;
+    }
+
+    // Clean BMAD agents from subagents directory
+    const subagentsDir = path.join(rovoDevDir, this.subagentsDir);
+    if (await fs.pathExists(subagentsDir)) {
+      const entries = await fs.readdir(subagentsDir);
+      const bmadFiles = entries.filter((file) => file.startsWith('bmad-') && file.endsWith('.md'));
+
+      for (const file of bmadFiles) {
+        await fs.remove(path.join(subagentsDir, file));
+      }
+    }
+
+    // Clean BMAD workflows from workflows directory
+    const workflowsDir = path.join(rovoDevDir, this.workflowsDir);
+    if (await fs.pathExists(workflowsDir)) {
+      const entries = await fs.readdir(workflowsDir);
+      const bmadFiles = entries.filter((file) => file.startsWith('bmad-') && file.endsWith('.md'));
+
+      for (const file of bmadFiles) {
+        await fs.remove(path.join(workflowsDir, file));
+      }
+    }
+
+    // Clean BMAD tasks/tools from references directory
+    const referencesDir = path.join(rovoDevDir, this.referencesDir);
+    if (await fs.pathExists(referencesDir)) {
+      const entries = await fs.readdir(referencesDir);
+      const bmadFiles = entries.filter((file) => file.startsWith('bmad-') && file.endsWith('.md'));
+
+      for (const file of bmadFiles) {
+        await fs.remove(path.join(referencesDir, file));
+      }
+    }
+  }
+
+  /**
+   * Setup Rovo Dev configuration
+   * @param {string} projectDir - Project directory
+   * @param {string} bmadDir - BMAD installation directory
+   * @param {Object} options - Setup options
+   */
+  async setup(projectDir, bmadDir, options = {}) {
+    console.log(chalk.cyan(`Setting up ${this.name}...`));
+
+    // Clean up old BMAD installation first
+    await this.cleanup(projectDir);
+
+    // Create .rovodev directory structure
+    const rovoDevDir = path.join(projectDir, this.configDir);
+    const subagentsDir = path.join(rovoDevDir, this.subagentsDir);
+    const workflowsDir = path.join(rovoDevDir, this.workflowsDir);
+    const referencesDir = path.join(rovoDevDir, this.referencesDir);
+
+    await this.ensureDir(subagentsDir);
+    await this.ensureDir(workflowsDir);
+    await this.ensureDir(referencesDir);
+
+    // Generate and install agents
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
+
+    let agentCount = 0;
+    for (const artifact of agentArtifacts) {
+      const subagentFilename = `bmad-${artifact.module}-${artifact.name}.md`;
+      const targetPath = path.join(subagentsDir, subagentFilename);
+      const subagentContent = this.convertToRovoDevSubagent(artifact.content, artifact.name, artifact.module);
+      await this.writeFile(targetPath, subagentContent);
+      agentCount++;
+    }
+
+    // Generate and install workflows
+    const workflowGen = new WorkflowCommandGenerator(this.bmadFolderName);
+    const { artifacts: workflowArtifacts, counts: workflowCounts } = await workflowGen.collectWorkflowArtifacts(bmadDir);
+
+    let workflowCount = 0;
+    for (const artifact of workflowArtifacts) {
+      if (artifact.type === 'workflow-command') {
+        const workflowFilename = path.basename(artifact.relativePath);
+        const targetPath = path.join(workflowsDir, workflowFilename);
+        await this.writeFile(targetPath, artifact.content);
+        workflowCount++;
+      }
+    }
+
+    // Generate and install tasks and tools
+    const taskToolGen = new TaskToolCommandGenerator();
+    const { tasks: taskCount, tools: toolCount } = await this.generateTaskToolReferences(bmadDir, referencesDir, taskToolGen);
+
+    // Summary output
+    console.log(chalk.green(`✓ ${this.name} configured:`));
+    console.log(chalk.dim(`  - ${agentCount} agents installed to .rovodev/subagents/`));
+    if (workflowCount > 0) {
+      console.log(chalk.dim(`  - ${workflowCount} workflows installed to .rovodev/workflows/`));
+    }
+    if (taskCount + toolCount > 0) {
+      console.log(
+        chalk.dim(`  - ${taskCount + toolCount} tasks/tools installed to .rovodev/references/ (${taskCount} tasks, ${toolCount} tools)`),
+      );
+    }
+    console.log(chalk.yellow(`\n  Note: Agents are automatically discovered by Rovo Dev`));
+    console.log(chalk.dim(`  - Access agents by typing @ in Rovo Dev to see available options`));
+    console.log(chalk.dim(`  - Workflows and references are available in .rovodev/ directory`));
+
+    return {
+      success: true,
+      agents: agentCount,
+      workflows: workflowCount,
+      tasks: taskCount,
+      tools: toolCount,
+    };
+  }
+
+  /**
+   * Generate task and tool reference guides
+   * @param {string} bmadDir - BMAD directory
+   * @param {string} referencesDir - References directory
+   * @param {TaskToolCommandGenerator} taskToolGen - Generator instance
+   */
+  async generateTaskToolReferences(bmadDir, referencesDir, taskToolGen) {
+    const tasks = await taskToolGen.loadTaskManifest(bmadDir);
+    const tools = await taskToolGen.loadToolManifest(bmadDir);
+
+    const standaloneTasks = tasks ? tasks.filter((t) => t.standalone === 'true' || t.standalone === true) : [];
+    const standaloneTools = tools ? tools.filter((t) => t.standalone === 'true' || t.standalone === true) : [];
+
+    let taskCount = 0;
+    for (const task of standaloneTasks) {
+      const commandContent = taskToolGen.generateCommandContent(task, 'task');
+      const targetPath = path.join(referencesDir, `bmad-task-${task.module}-${task.name}.md`);
+      await this.writeFile(targetPath, commandContent);
+      taskCount++;
+    }
+
+    let toolCount = 0;
+    for (const tool of standaloneTools) {
+      const commandContent = taskToolGen.generateCommandContent(tool, 'tool');
+      const targetPath = path.join(referencesDir, `bmad-tool-${tool.module}-${tool.name}.md`);
+      await this.writeFile(targetPath, commandContent);
+      toolCount++;
+    }
+
+    return { tasks: taskCount, tools: toolCount };
+  }
+
+  /**
+   * Convert BMAD agent launcher to Rovo Dev subagent format
+   *
+   * Rovo Dev subagents use Markdown files with YAML frontmatter containing:
+   * - name: Unique identifier for the subagent
+   * - description: One-line description of the subagent's purpose
+   * - tools: Array of tools the subagent can use (optional)
+   * - model: Specific model for this subagent (optional)
+   * - load_memory: Whether to load memory files (optional, defaults to true)
+   *
+   * @param {string} launcherContent - Original agent launcher content
+   * @param {string} agentName - Name of the agent
+   * @param {string} moduleName - Name of the module
+   * @returns {string} Rovo Dev subagent-formatted content
+   */
+  convertToRovoDevSubagent(launcherContent, agentName, moduleName) {
+    // Extract metadata from the launcher XML
+    const titleMatch = launcherContent.match(/title="([^"]+)"/);
+    const title = titleMatch ? titleMatch[1] : this.formatTitle(agentName);
+
+    const descriptionMatch = launcherContent.match(/description="([^"]+)"/);
+    const description = descriptionMatch ? descriptionMatch[1] : `BMAD agent: ${title}`;
+
+    const roleDefinitionMatch = launcherContent.match(/roleDefinition="([^"]+)"/);
+    const roleDefinition = roleDefinitionMatch ? roleDefinitionMatch[1] : `You are a specialized agent for ${title.toLowerCase()} tasks.`;
+
+    // Extract the main system prompt from the launcher (content after closing tags)
+    let systemPrompt = roleDefinition;
+
+    // Try to extract additional instructions from the launcher content
+    const instructionsMatch = launcherContent.match(/<instructions>([\s\S]*?)<\/instructions>/);
+    if (instructionsMatch) {
+      systemPrompt += '\n\n' + instructionsMatch[1].trim();
+    }
+
+    // Build YAML frontmatter for Rovo Dev subagent
+    const frontmatter = {
+      name: `bmad-${moduleName}-${agentName}`,
+      description: description,
+      // Note: tools and model can be added by users in their .rovodev/subagents/*.md files
+      // We don't enforce specific tools since BMAD agents are flexible
+    };
+
+    // Create YAML frontmatter string with proper quoting for special characters
+    let yamlContent = '---\n';
+    yamlContent += `name: ${frontmatter.name}\n`;
+    // Quote description to handle colons and other special characters in YAML
+    yamlContent += `description: "${frontmatter.description.replaceAll('"', String.raw`\"`)}"\n`;
+    yamlContent += '---\n';
+
+    // Combine frontmatter with system prompt
+    const subagentContent = yamlContent + systemPrompt;
+
+    return subagentContent;
+  }
+
+  /**
+   * Detect whether Rovo Dev is already configured in the project
+   * @param {string} projectDir - Project directory
+   * @returns {boolean}
+   */
+  async detect(projectDir) {
+    const rovoDevDir = path.join(projectDir, this.configDir);
+
+    if (!(await fs.pathExists(rovoDevDir))) {
+      return false;
+    }
+
+    // Check for BMAD agents in subagents directory
+    const subagentsDir = path.join(rovoDevDir, this.subagentsDir);
+    if (await fs.pathExists(subagentsDir)) {
+      try {
+        const entries = await fs.readdir(subagentsDir);
+        if (entries.some((entry) => entry.startsWith('bmad-') && entry.endsWith('.md'))) {
+          return true;
+        }
+      } catch {
+        // Continue checking other directories
+      }
+    }
+
+    // Check for BMAD workflows in workflows directory
+    const workflowsDir = path.join(rovoDevDir, this.workflowsDir);
+    if (await fs.pathExists(workflowsDir)) {
+      try {
+        const entries = await fs.readdir(workflowsDir);
+        if (entries.some((entry) => entry.startsWith('bmad-') && entry.endsWith('.md'))) {
+          return true;
+        }
+      } catch {
+        // Continue checking other directories
+      }
+    }
+
+    // Check for BMAD tasks/tools in references directory
+    const referencesDir = path.join(rovoDevDir, this.referencesDir);
+    if (await fs.pathExists(referencesDir)) {
+      try {
+        const entries = await fs.readdir(referencesDir);
+        if (entries.some((entry) => entry.startsWith('bmad-') && entry.endsWith('.md'))) {
+          return true;
+        }
+      } catch {
+        // Continue
+      }
+    }
+
+    return false;
+  }
+}
+
+module.exports = { RovoDevSetup };

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

@@ -1,4 +1,5 @@
 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');
@@ -261,6 +262,52 @@ Part of the BMAD ${workflow.module.toUpperCase()} module.
       }
     }
   }
+
+  /**
+   * Install a custom agent launcher for Trae
+   * @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 traeDir = path.join(projectDir, this.configDir);
+    const rulesDir = path.join(traeDir, this.rulesDir);
+
+    // Create .trae/rules directory if it doesn't exist
+    await fs.ensureDir(rulesDir);
+
+    // 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 rule to activate ${agentName}
+
+The agent will follow the persona and instructions from the main agent file.
+
+---
+
+*Generated by BMAD Method*`;
+
+    const fileName = `bmad-agent-custom-${agentName.toLowerCase()}.md`;
+    const launcherPath = path.join(rulesDir, fileName);
+
+    // Write the launcher file
+    await fs.writeFile(launcherPath, launcherContent, 'utf8');
+
+    return {
+      ide: 'trae',
+      path: path.relative(projectDir, launcherPath),
+      command: agentName,
+      type: 'custom-agent-launcher',
+    };
+  }
 }
 
 module.exports = { TraeSetup };