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

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

@@ -5,34 +5,13 @@ const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * Roo IDE setup handler
- * Creates custom modes in .roomodes file
+ * Creates custom commands in .roo/commands directory
  */
 class RooSetup extends BaseIdeSetup {
   constructor() {
     super('roo', 'Roo Code');
-    this.configFile = '.roomodes';
-    this.defaultPermissions = {
-      dev: {
-        description: 'Development files',
-        fileRegex: String.raw`.*\.(js|jsx|ts|tsx|py|java|cpp|c|h|cs|go|rs|php|rb|swift)$`,
-      },
-      config: {
-        description: 'Configuration files',
-        fileRegex: String.raw`.*\.(json|yaml|yml|toml|xml|ini|env|config)$`,
-      },
-      docs: {
-        description: 'Documentation files',
-        fileRegex: String.raw`.*\.(md|mdx|rst|txt|doc|docx)$`,
-      },
-      styles: {
-        description: 'Style and design files',
-        fileRegex: String.raw`.*\.(css|scss|sass|less|stylus)$`,
-      },
-      all: {
-        description: 'All files',
-        fileRegex: '.*',
-      },
-    };
+    this.configDir = '.roo';
+    this.commandsDir = 'commands';
   }
 
   /**
@@ -44,94 +23,96 @@ class RooSetup extends BaseIdeSetup {
   async setup(projectDir, bmadDir, options = {}) {
     console.log(chalk.cyan(`Setting up ${this.name}...`));
 
-    // Check for existing .roomodes file
-    const roomodesPath = path.join(projectDir, this.configFile);
-    let existingModes = [];
-    let existingContent = '';
-
-    if (await this.pathExists(roomodesPath)) {
-      existingContent = await this.readFile(roomodesPath);
-      // Parse existing modes to avoid duplicates
-      const modeMatches = existingContent.matchAll(/- slug: ([\w-]+)/g);
-      for (const match of modeMatches) {
-        existingModes.push(match[1]);
-      }
-      console.log(chalk.yellow(`Found existing .roomodes file with ${existingModes.length} modes`));
-    }
+    // Create .roo/commands directory
+    const rooCommandsDir = path.join(projectDir, this.configDir, this.commandsDir);
+    await this.ensureDir(rooCommandsDir);
 
-    // Generate agent launchers (though Roo will reference the actual .bmad agents)
+    // Generate agent launchers
     const agentGen = new AgentCommandGenerator(this.bmadFolderName);
     const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
 
-    // Always use 'all' permissions - users can customize in .roomodes file
-    const permissionChoice = 'all';
-
-    // Create modes content
-    let newModesContent = '';
     let addedCount = 0;
     let skippedCount = 0;
 
     for (const artifact of agentArtifacts) {
-      const slug = `bmad-${artifact.module}-${artifact.name}`;
+      const commandName = `bmad-${artifact.module}-agent-${artifact.name}`;
+      const commandPath = path.join(rooCommandsDir, `${commandName}.md`);
 
       // Skip if already exists
-      if (existingModes.includes(slug)) {
-        console.log(chalk.dim(`  Skipping ${slug} - already exists`));
+      if (await this.pathExists(commandPath)) {
+        console.log(chalk.dim(`  Skipping ${commandName} - already exists`));
         skippedCount++;
         continue;
       }
 
-      // Read the actual agent file from .bmad for metadata extraction
+      // Read the actual agent file from .bmad for metadata extraction (installed agents are .md files)
       const agentPath = path.join(bmadDir, artifact.module, 'agents', `${artifact.name}.md`);
       const content = await this.readFile(agentPath);
 
-      // Create mode entry that references the actual .bmad agent
-      const modeEntry = await this.createModeEntry(
-        { module: artifact.module, name: artifact.name, path: agentPath },
-        content,
-        permissionChoice,
-        projectDir,
-      );
+      // Create command file that references the actual .bmad agent
+      await this.createCommandFile({ module: artifact.module, name: artifact.name, path: agentPath }, content, commandPath, projectDir);
 
-      newModesContent += modeEntry;
       addedCount++;
-      console.log(chalk.green(`  ✓ Added mode: ${slug}`));
+      console.log(chalk.green(`  ✓ Added command: ${commandName}`));
     }
 
-    // Build final content
-    let finalContent = '';
-    if (existingContent) {
-      // Append to existing content
-      finalContent = existingContent.trim() + '\n' + newModesContent;
-    } else {
-      // Create new .roomodes file
-      finalContent = 'customModes:\n' + newModesContent;
-    }
-
-    // Write .roomodes file
-    await this.writeFile(roomodesPath, finalContent);
-
     console.log(chalk.green(`✓ ${this.name} configured:`));
-    console.log(chalk.dim(`  - ${addedCount} modes added`));
+    console.log(chalk.dim(`  - ${addedCount} commands added`));
     if (skippedCount > 0) {
-      console.log(chalk.dim(`  - ${skippedCount} modes skipped (already exist)`));
+      console.log(chalk.dim(`  - ${skippedCount} commands skipped (already exist)`));
     }
-    console.log(chalk.dim(`  - Configuration file: ${this.configFile}`));
-    console.log(chalk.dim(`  - Permission level: all (unrestricted)`));
-    console.log(chalk.yellow(`\n  💡 Tip: Edit ${this.configFile} to customize file permissions per agent`));
-    console.log(chalk.dim(`  Modes will be available when you open this project in Roo Code`));
+    console.log(chalk.dim(`  - Commands directory: ${this.configDir}/${this.commandsDir}/bmad/`));
+    console.log(chalk.dim(`  Commands will be available when you open this project in Roo Code`));
 
     return {
       success: true,
-      modes: addedCount,
+      commands: addedCount,
       skipped: skippedCount,
     };
   }
 
   /**
-   * Create a mode entry for an agent
+   * Create a unified command file for agents
+   * @param {string} commandPath - Path where to write the command file
+   * @param {Object} options - Command options
+   * @param {string} options.name - Display name for the command
+   * @param {string} options.description - Description for the command
+   * @param {string} options.agentPath - Path to the agent file (relative to project root)
+   * @param {string} [options.icon] - Icon emoji (defaults to 🤖)
+   * @param {string} [options.extraContent] - Additional content to include before activation
    */
-  async createModeEntry(agent, content, permissionChoice, projectDir) {
+  async createAgentCommandFile(commandPath, options) {
+    const { name, description, agentPath, icon = '🤖', extraContent = '' } = options;
+
+    // Build command content with YAML frontmatter
+    let commandContent = `---\n`;
+    commandContent += `name: '${icon} ${name}'\n`;
+    commandContent += `description: '${description}'\n`;
+    commandContent += `---\n\n`;
+
+    commandContent += `You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.\n\n`;
+
+    // Add any extra content (e.g., warnings for custom agents)
+    if (extraContent) {
+      commandContent += `${extraContent}\n\n`;
+    }
+
+    commandContent += `<agent-activation CRITICAL="TRUE">\n`;
+    commandContent += `1. LOAD the FULL agent file from @${agentPath}\n`;
+    commandContent += `2. READ its entire contents - this contains the complete agent persona, menu, and instructions\n`;
+    commandContent += `3. Execute ALL activation steps exactly as written in the agent file\n`;
+    commandContent += `4. Follow the agent's persona and menu system precisely\n`;
+    commandContent += `5. Stay in character throughout the session\n`;
+    commandContent += `</agent-activation>\n`;
+
+    // Write command file
+    await this.writeFile(commandPath, commandContent);
+  }
+
+  /**
+   * Create a command file for an agent
+   */
+  async createCommandFile(agent, content, commandPath, projectDir) {
     // Extract metadata from agent content
     const titleMatch = content.match(/title="([^"]+)"/);
     const title = titleMatch ? titleMatch[1] : this.formatTitle(agent.name);
@@ -142,66 +123,16 @@ class RooSetup extends BaseIdeSetup {
     const whenToUseMatch = content.match(/whenToUse="([^"]+)"/);
     const whenToUse = whenToUseMatch ? whenToUseMatch[1] : `Use for ${title} tasks`;
 
-    // Get the activation header from central template
-    const activationHeader = await this.getAgentCommandHeader();
-
-    const roleDefinitionMatch = content.match(/roleDefinition="([^"]+)"/);
-    const roleDefinition = roleDefinitionMatch
-      ? roleDefinitionMatch[1]
-      : `You are a ${title} specializing in ${title.toLowerCase()} tasks and responsibilities.`;
-
     // Get relative path
     const relativePath = path.relative(projectDir, agent.path).replaceAll('\\', '/');
 
-    // Determine permissions
-    const permissions = this.getPermissionsForAgent(agent, permissionChoice);
-
-    // Build mode entry
-    const slug = `bmad-${agent.module}-${agent.name}`;
-    let modeEntry = ` - slug: ${slug}\n`;
-    modeEntry += `   name: '${icon} ${title}'\n`;
-
-    if (permissions && permissions.description) {
-      modeEntry += `   description: '${permissions.description}'\n`;
-    }
-
-    modeEntry += `   roleDefinition: ${roleDefinition}\n`;
-    modeEntry += `   whenToUse: ${whenToUse}\n`;
-    modeEntry += `   customInstructions: ${activationHeader} 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`;
-    modeEntry += `   groups:\n`;
-    modeEntry += `    - read\n`;
-
-    if (permissions && permissions.fileRegex) {
-      modeEntry += `    - - edit\n`;
-      modeEntry += `      - fileRegex: ${permissions.fileRegex}\n`;
-      modeEntry += `        description: ${permissions.description}\n`;
-    } else {
-      modeEntry += `    - edit\n`;
-    }
-
-    return modeEntry;
-  }
-
-  /**
-   * Get permissions configuration for an agent
-   */
-  getPermissionsForAgent(agent, permissionChoice) {
-    if (permissionChoice === 'custom') {
-      // Custom logic based on agent name/module
-      if (agent.name.includes('dev') || agent.name.includes('code')) {
-        return this.defaultPermissions.dev;
-      } else if (agent.name.includes('doc') || agent.name.includes('write')) {
-        return this.defaultPermissions.docs;
-      } else if (agent.name.includes('config') || agent.name.includes('setup')) {
-        return this.defaultPermissions.config;
-      } else if (agent.name.includes('style') || agent.name.includes('css')) {
-        return this.defaultPermissions.styles;
-      }
-      // Default to all for custom agents
-      return this.defaultPermissions.all;
-    }
-
-    return this.defaultPermissions[permissionChoice] || null;
+    // Use unified method
+    await this.createAgentCommandFile(commandPath, {
+      name: title,
+      description: whenToUse,
+      agentPath: relativePath,
+      icon: icon,
+    });
   }
 
   /**
@@ -219,8 +150,26 @@ class RooSetup extends BaseIdeSetup {
    */
   async cleanup(projectDir) {
     const fs = require('fs-extra');
-    const roomodesPath = path.join(projectDir, this.configFile);
+    const rooCommandsDir = path.join(projectDir, this.configDir, this.commandsDir);
+
+    if (await fs.pathExists(rooCommandsDir)) {
+      const files = await fs.readdir(rooCommandsDir);
+      let removedCount = 0;
+
+      for (const file of files) {
+        if (file.startsWith('bmad-') && file.endsWith('.md')) {
+          await fs.remove(path.join(rooCommandsDir, file));
+          removedCount++;
+        }
+      }
+
+      if (removedCount > 0) {
+        console.log(chalk.dim(`Removed ${removedCount} BMAD commands from .roo/commands/`));
+      }
+    }
 
+    // Also clean up old .roomodes file if it exists
+    const roomodesPath = path.join(projectDir, '.roomodes');
     if (await fs.pathExists(roomodesPath)) {
       const content = await fs.readFile(roomodesPath, 'utf8');
 
@@ -245,9 +194,67 @@ class RooSetup extends BaseIdeSetup {
 
       // Write back filtered content
       await fs.writeFile(roomodesPath, filteredLines.join('\n'));
-      console.log(chalk.dim(`Removed ${removedCount} BMAD modes from .roomodes`));
+      if (removedCount > 0) {
+        console.log(chalk.dim(`Removed ${removedCount} BMAD modes from legacy .roomodes file`));
+      }
     }
   }
+
+  /**
+   * 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 (unused, kept for compatibility)
+   * @returns {Object} Installation result
+   */
+  async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
+    const rooCommandsDir = path.join(projectDir, this.configDir, this.commandsDir);
+    await this.ensureDir(rooCommandsDir);
+
+    const commandName = `bmad-custom-agent-${agentName.toLowerCase()}`;
+    const commandPath = path.join(rooCommandsDir, `${commandName}.md`);
+
+    // Check if command already exists
+    if (await this.pathExists(commandPath)) {
+      return {
+        ide: 'roo',
+        path: path.join(this.configDir, this.commandsDir, `${commandName}.md`),
+        command: commandName,
+        type: 'custom-agent-launcher',
+        alreadyExists: true,
+      };
+    }
+
+    // Read the custom agent file to extract metadata (same as regular agents)
+    const fullAgentPath = path.join(projectDir, agentPath);
+    const content = await this.readFile(fullAgentPath);
+
+    // Extract metadata from agent content
+    const titleMatch = content.match(/title="([^"]+)"/);
+    const title = titleMatch ? titleMatch[1] : this.formatTitle(agentName);
+
+    const iconMatch = content.match(/icon="([^"]+)"/);
+    const icon = iconMatch ? iconMatch[1] : '🤖';
+
+    const whenToUseMatch = content.match(/whenToUse="([^"]+)"/);
+    const whenToUse = whenToUseMatch ? whenToUseMatch[1] : `Use for ${title} tasks`;
+
+    // Use unified method without extra content (clean)
+    await this.createAgentCommandFile(commandPath, {
+      name: title,
+      description: whenToUse,
+      agentPath: agentPath,
+      icon: icon,
+    });
+
+    return {
+      ide: 'roo',
+      path: path.join(this.configDir, this.commandsDir, `${commandName}.md`),
+      command: commandName,
+      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', false);
+    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/shared/agent-command-generator.js

@@ -28,11 +28,13 @@ class AgentCommandGenerator {
 
     for (const agent of agents) {
       const launcherContent = await this.generateLauncherContent(agent);
+      // Use relativePath if available (for nested agents), otherwise just name with .md
+      const agentPathInModule = agent.relativePath || `${agent.name}.md`;
       artifacts.push({
         type: 'agent-launcher',
         module: agent.module,
         name: agent.name,
-        relativePath: path.join(agent.module, 'agents', `${agent.name}.md`),
+        relativePath: path.join(agent.module, 'agents', agentPathInModule),
         content: launcherContent,
         sourcePath: agent.path,
       });
@@ -56,11 +58,15 @@ class AgentCommandGenerator {
     const template = await fs.readFile(this.templatePath, 'utf8');
 
     // Replace template variables
+    // Use relativePath if available (for nested agents), otherwise just name with .md
+    const agentPathInModule = agent.relativePath || `${agent.name}.md`;
     return template
       .replaceAll('{{name}}', agent.name)
       .replaceAll('{{module}}', agent.module)
+      .replaceAll('{{path}}', agentPathInModule)
       .replaceAll('{{description}}', agent.description || `${agent.name} agent`)
-      .replaceAll('{bmad_folder}', this.bmadFolderName);
+      .replaceAll('{bmad_folder}', this.bmadFolderName)
+      .replaceAll('{*bmad_folder*}', '{bmad_folder}');
   }
 
   /**