bmad-method 4.27.6 → 5.0.0

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

@@ -1,47 +1,19 @@
 const path = require("path");
-const fs = require("fs-extra");
-const yaml = require("js-yaml");
 const fileManager = require("./file-manager");
 const configLoader = require("./config-loader");
-const { extractYamlFromAgent } = require("../../lib/yaml-utils");
 
 // Dynamic import for ES module
 let chalk;
-let inquirer;
 
 // Initialize ES modules
 async function initializeModules() {
   if (!chalk) {
     chalk = (await import("chalk")).default;
   }
-  if (!inquirer) {
-    inquirer = (await import("inquirer")).default;
-  }
 }
 
 class IdeSetup {
-  constructor() {
-    this.ideAgentConfig = null;
-  }
-
-  async loadIdeAgentConfig() {
-    if (this.ideAgentConfig) return this.ideAgentConfig;
-    
-    try {
-      const configPath = path.join(__dirname, '..', 'config', 'ide-agent-config.yaml');
-      const configContent = await fs.readFile(configPath, 'utf8');
-      this.ideAgentConfig = yaml.load(configContent);
-      return this.ideAgentConfig;
-    } catch (error) {
-      console.warn('Failed to load IDE agent configuration, using defaults');
-      return {
-        'roo-permissions': {},
-        'cline-order': {}
-      };
-    }
-  }
-
-  async setup(ide, installDir, selectedAgent = null, spinner = null, preConfiguredSettings = null) {
+  async setup(ide, installDir, selectedAgent = null) {
     await initializeModules();
     const ideConfig = await configLoader.getIdeConfiguration(ide);
 
@@ -57,16 +29,8 @@ class IdeSetup {
         return this.setupClaudeCode(installDir, selectedAgent);
       case "windsurf":
         return this.setupWindsurf(installDir, selectedAgent);
-      case "trae":
-        return this.setupTrae(installDir, selectedAgent);
       case "roo":
         return this.setupRoo(installDir, selectedAgent);
-      case "cline":
-        return this.setupCline(installDir, selectedAgent);
-      case "gemini":
-        return this.setupGeminiCli(installDir, selectedAgent);
-      case "github-copilot":
-        return this.setupGitHubCopilot(installDir, selectedAgent, spinner, preConfiguredSettings);
       default:
         console.log(chalk.yellow(`\nIDE ${ide} not yet supported`));
         return false;
@@ -75,15 +39,25 @@ class IdeSetup {
 
   async setupCursor(installDir, selectedAgent) {
     const cursorRulesDir = path.join(installDir, ".cursor", "rules");
-    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+    const agents = selectedAgent
+      ? [selectedAgent]
+      : await this.getAllAgentIds(installDir);
 
     await fileManager.ensureDirectory(cursorRulesDir);
 
     for (const agentId of agents) {
-      // Find the agent file
-      const agentPath = await this.findAgentPath(agentId, installDir);
+      // Check if .bmad-core is a subdirectory (full install) or if agents are in root (single agent install)
+      let agentPath = path.join(
+        installDir,
+        ".bmad-core",
+        "agents",
+        `${agentId}.md`
+      );
+      if (!(await fileManager.pathExists(agentPath))) {
+        agentPath = path.join(installDir, "agents", `${agentId}.md`);
+      }
 
-      if (agentPath) {
+      if (await fileManager.pathExists(agentPath)) {
         const agentContent = await fileManager.readFile(agentPath);
         const mdcPath = path.join(cursorRulesDir, `${agentId}.mdc`);
 
@@ -94,31 +68,28 @@ class IdeSetup {
         mdcContent += "alwaysApply: false\n";
         mdcContent += "---\n\n";
         mdcContent += `# ${agentId.toUpperCase()} Agent Rule\n\n`;
-        mdcContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${await this.getAgentTitle(
-          agentId,
-          installDir
+        mdcContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${this.getAgentTitle(
+          agentId
         )} agent persona.\n\n`;
         mdcContent += "## Agent Activation\n\n";
         mdcContent +=
-          "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";
+          "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";
+        mdcContent += "```yml\n";
         // Extract just the YAML content from the agent file
-        const yamlContent = extractYamlFromAgent(agentContent);
-        if (yamlContent) {
-          mdcContent += yamlContent;
+        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
+        if (yamlMatch) {
+          mdcContent += yamlMatch[1].trim();
         } else {
           // If no YAML found, include the whole content minus the header
           mdcContent += agentContent.replace(/^#.*$/m, "").trim();
         }
         mdcContent += "\n```\n\n";
         mdcContent += "## File Reference\n\n";
-        const relativePath = path.relative(installDir, agentPath).replace(/\\/g, '/');
-        mdcContent += `The complete agent definition is available in [${relativePath}](mdc:${relativePath}).\n\n`;
+        mdcContent += `The complete agent definition is available in [.bmad-core/agents/${agentId}.md](mdc:.bmad-core/agents/${agentId}.md).\n\n`;
         mdcContent += "## Usage\n\n";
-        mdcContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
-          agentId,
-          installDir
-        )} persona and follow all instructions defined in the YAML configuration above.\n`;
+        mdcContent += `When the user types \`@${agentId}\`, activate this ${this.getAgentTitle(
+          agentId
+        )} persona and follow all instructions defined in the YML configuration above.\n`;
 
         await fileManager.writeFile(mdcPath, mdcContent);
         console.log(chalk.green(`✓ Created rule: ${agentId}.mdc`));
@@ -132,16 +103,26 @@ class IdeSetup {
 
   async setupClaudeCode(installDir, selectedAgent) {
     const commandsDir = path.join(installDir, ".claude", "commands");
-    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+    const agents = selectedAgent
+      ? [selectedAgent]
+      : await this.getAllAgentIds(installDir);
 
     await fileManager.ensureDirectory(commandsDir);
 
     for (const agentId of agents) {
-      // Find the agent file
-      const agentPath = await this.findAgentPath(agentId, installDir);
+      // Check if .bmad-core is a subdirectory (full install) or if agents are in root (single agent install)
+      let agentPath = path.join(
+        installDir,
+        ".bmad-core",
+        "agents",
+        `${agentId}.md`
+      );
+      if (!(await fileManager.pathExists(agentPath))) {
+        agentPath = path.join(installDir, "agents", `${agentId}.md`);
+      }
       const commandPath = path.join(commandsDir, `${agentId}.md`);
 
-      if (agentPath) {
+      if (await fileManager.pathExists(agentPath)) {
         // Create command file with agent content
         const agentContent = await fileManager.readFile(agentPath);
 
@@ -155,206 +136,113 @@ class IdeSetup {
       }
     }
 
-    console.log(chalk.green(`\n✓ Created Claude Code commands in ${commandsDir}`));
+    console.log(
+      chalk.green(`\n✓ Created Claude Code commands in ${commandsDir}`)
+    );
 
     return true;
   }
 
   async setupWindsurf(installDir, selectedAgent) {
     const windsurfRulesDir = path.join(installDir, ".windsurf", "rules");
-    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+    const agents = selectedAgent
+      ? [selectedAgent]
+      : await this.getAllAgentIds(installDir);
 
     await fileManager.ensureDirectory(windsurfRulesDir);
 
     for (const agentId of agents) {
-      // Find the agent file
-      const agentPath = await this.findAgentPath(agentId, installDir);
+      // Check if .bmad-core is a subdirectory (full install) or if agents are in root (single agent install)
+      let agentPath = path.join(
+        installDir,
+        ".bmad-core",
+        "agents",
+        `${agentId}.md`
+      );
+      if (!(await fileManager.pathExists(agentPath))) {
+        agentPath = path.join(installDir, "agents", `${agentId}.md`);
+      }
 
-      if (agentPath) {
+      if (await fileManager.pathExists(agentPath)) {
         const agentContent = await fileManager.readFile(agentPath);
         const mdPath = path.join(windsurfRulesDir, `${agentId}.md`);
 
         // Create MD content (similar to Cursor but without frontmatter)
         let mdContent = `# ${agentId.toUpperCase()} Agent Rule\n\n`;
-        mdContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${await this.getAgentTitle(
-          agentId,
-          installDir
+        mdContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${this.getAgentTitle(
+          agentId
         )} agent persona.\n\n`;
         mdContent += "## Agent Activation\n\n";
         mdContent +=
-          "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";
+          "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";
+        mdContent += "```yml\n";
         // Extract just the YAML content from the agent file
-        const yamlContent = extractYamlFromAgent(agentContent);
-        if (yamlContent) {
-          mdContent += yamlContent;
+        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
+        if (yamlMatch) {
+          mdContent += yamlMatch[1].trim();
         } else {
           // If no YAML found, include the whole content minus the header
           mdContent += agentContent.replace(/^#.*$/m, "").trim();
         }
         mdContent += "\n```\n\n";
         mdContent += "## File Reference\n\n";
-        const relativePath = path.relative(installDir, agentPath).replace(/\\/g, '/');
-        mdContent += `The complete agent definition is available in [${relativePath}](${relativePath}).\n\n`;
+        mdContent += `The complete agent definition is available in [.bmad-core/agents/${agentId}.md](.bmad-core/agents/${agentId}.md).\n\n`;
         mdContent += "## Usage\n\n";
-        mdContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
-          agentId,
-          installDir
-        )} persona and follow all instructions defined in the YAML configuration above.\n`;
+        mdContent += `When the user types \`@${agentId}\`, activate this ${this.getAgentTitle(
+          agentId
+        )} persona and follow all instructions defined in the YML configuration above.\n`;
 
         await fileManager.writeFile(mdPath, mdContent);
         console.log(chalk.green(`✓ Created rule: ${agentId}.md`));
       }
     }
 
-    console.log(chalk.green(`\n✓ Created Windsurf rules in ${windsurfRulesDir}`));
+    console.log(
+      chalk.green(`\n✓ Created Windsurf rules in ${windsurfRulesDir}`)
+    );
 
     return true;
   }
 
-  async setupTrae(installDir, selectedAgent) {
-    const traeRulesDir = path.join(installDir, ".trae", "rules");
-    const agents = selectedAgent? [selectedAgent] : await this.getAllAgentIds(installDir);
-    
-    await fileManager.ensureDirectory(traeRulesDir);
-    
-    for (const agentId of agents) {
-      // Find the agent file
-      const agentPath = await this.findAgentPath(agentId, installDir);
-      
-      if (agentPath) {
-        const agentContent = await fileManager.readFile(agentPath);
-        const mdPath = path.join(traeRulesDir, `${agentId}.md`);
-        
-        // Create MD content (similar to Cursor but without frontmatter)
-        let mdContent = `# ${agentId.toUpperCase()} Agent Rule\n\n`;
-        mdContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${await this.getAgentTitle(
-          agentId,
-          installDir
-        )} agent persona.\n\n`;
-        mdContent += "## Agent Activation\n\n";
-        mdContent +=
-          "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);
-        if (yamlContent) {
-          mdContent += yamlContent;
-        }
-        else {
-          // If no YAML found, include the whole content minus the header
-          mdContent += agentContent.replace(/^#.*$/m, "").trim();
-        }
-        mdContent += "\n```\n\n";
-        mdContent += "## File Reference\n\n";
-        const relativePath = path.relative(installDir, agentPath).replace(/\\/g, '/');
-        mdContent += `The complete agent definition is available in [${relativePath}](${relativePath}).\n\n`;
-        mdContent += "## Usage\n\n";
-        mdContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
-          agentId,
-          installDir
-        )} 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`));
-      }
-    }
-  }
-
-  async findAgentPath(agentId, installDir) {
-    // Try to find the agent file in various locations
-    const possiblePaths = [
-      path.join(installDir, ".bmad-core", "agents", `${agentId}.md`),
-      path.join(installDir, "agents", `${agentId}.md`)
-    ];
-    
-    // Also check expansion pack directories
-    const glob = require("glob");
-    const expansionDirs = glob.sync(".*/agents", { cwd: installDir });
-    for (const expDir of expansionDirs) {
-      possiblePaths.push(path.join(installDir, expDir, `${agentId}.md`));
-    }
-    
-    for (const agentPath of possiblePaths) {
-      if (await fileManager.pathExists(agentPath)) {
-        return agentPath;
-      }
-    }
-    
-    return null;
-  }
-
   async getAllAgentIds(installDir) {
-    const glob = require("glob");
-    const allAgentIds = [];
-    
-    // Check core agents in .bmad-core or root
+    // Check if .bmad-core is a subdirectory (full install) or if agents are in root (single agent install)
     let agentsDir = path.join(installDir, ".bmad-core", "agents");
     if (!(await fileManager.pathExists(agentsDir))) {
       agentsDir = path.join(installDir, "agents");
     }
-    
-    if (await fileManager.pathExists(agentsDir)) {
-      const agentFiles = glob.sync("*.md", { cwd: agentsDir });
-      allAgentIds.push(...agentFiles.map((file) => path.basename(file, ".md")));
-    }
-    
-    // Also check for expansion pack agents in dot folders
-    const expansionDirs = glob.sync(".*/agents", { cwd: installDir });
-    for (const expDir of expansionDirs) {
-      const fullExpDir = path.join(installDir, expDir);
-      const expAgentFiles = glob.sync("*.md", { cwd: fullExpDir });
-      allAgentIds.push(...expAgentFiles.map((file) => path.basename(file, ".md")));
-    }
-    
-    // Remove duplicates
-    return [...new Set(allAgentIds)];
-  }
 
-  async getAgentTitle(agentId, installDir) {
-    // Try to find the agent file in various locations
-    const possiblePaths = [
-      path.join(installDir, ".bmad-core", "agents", `${agentId}.md`),
-      path.join(installDir, "agents", `${agentId}.md`)
-    ];
-    
-    // Also check expansion pack directories
     const glob = require("glob");
-    const expansionDirs = glob.sync(".*/agents", { cwd: installDir });
-    for (const expDir of expansionDirs) {
-      possiblePaths.push(path.join(installDir, expDir, `${agentId}.md`));
-    }
-    
-    for (const agentPath of possiblePaths) {
-      if (await fileManager.pathExists(agentPath)) {
-        try {
-          const agentContent = await fileManager.readFile(agentPath);
-          const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
-          
-          if (yamlMatch) {
-            const yaml = yamlMatch[1];
-            const titleMatch = yaml.match(/title:\s*(.+)/);
-            if (titleMatch) {
-              return titleMatch[1].trim();
-            }
-          }
-        } catch (error) {
-          console.warn(`Failed to read agent title for ${agentId}: ${error.message}`);
-        }
-      }
-    }
-    
-    // Fallback to formatted agent ID
-    return agentId.split('-').map(word => 
-      word.charAt(0).toUpperCase() + word.slice(1)
-    ).join(' ');
+    const agentFiles = glob.sync("*.md", { cwd: agentsDir });
+    return agentFiles.map((file) => path.basename(file, ".md"));
+  }
+
+  getAgentTitle(agentId) {
+    const agentTitles = {
+      analyst: "Business Analyst",
+      architect: "Solution Architect",
+      "bmad-master": "BMAD Master",
+      "bmad-orchestrator": "BMAD Orchestrator",
+      dev: "Developer",
+      pm: "Product Manager",
+      po: "Product Owner",
+      qa: "QA Specialist",
+      sm: "Scrum Master",
+      "ux-expert": "UX Expert",
+    };
+    return agentTitles[agentId] || agentId;
   }
 
   async setupRoo(installDir, selectedAgent) {
-    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+    const agents = selectedAgent
+      ? [selectedAgent]
+      : await this.getAllAgentIds(installDir);
 
-    // Check for existing .roomodes file in project root
-    const roomodesPath = path.join(installDir, ".roomodes");
+    // Create .roo directory first
+    const rooDir = path.join(installDir, ".roo");
+    await fileManager.ensureDirectory(rooDir);
+
+    // Check for existing .roomodes file inside .roo directory
+    const roomodesPath = path.join(rooDir, ".roomodes");
     let existingModes = [];
     let existingContent = "";
 
@@ -365,27 +253,72 @@ class IdeSetup {
       for (const match of modeMatches) {
         existingModes.push(match[1]);
       }
-      console.log(chalk.yellow(`Found existing .roomodes file with ${existingModes.length} modes`));
+      console.log(
+        chalk.yellow(
+          `Found existing .roomodes file with ${existingModes.length} modes`
+        )
+      );
     }
 
     // Create new modes content
     let newModesContent = "";
 
-    // Load dynamic agent permissions from configuration
-    const config = await this.loadIdeAgentConfig();
-    const agentPermissions = config['roo-permissions'] || {};
+    // Define file permissions for each agent type
+    const agentPermissions = {
+      'analyst': {
+        fileRegex: '\\.(md|txt)$',
+        description: 'Documentation and text files'
+      },
+      'pm': {
+        fileRegex: '\\.(md|txt)$',
+        description: 'Product documentation'
+      },
+      'architect': {
+        fileRegex: '\\.(md|txt|yml|yaml|json)$',
+        description: 'Architecture docs and configs'
+      },
+      'dev': null, // Full edit access
+      'qa': {
+        fileRegex: '\\.(test|spec)\\.(js|ts|jsx|tsx)$|\\.md$',
+        description: 'Test files and documentation'
+      },
+      'ux-expert': {
+        fileRegex: '\\.(md|css|scss|html|jsx|tsx)$',
+        description: 'Design-related files'
+      },
+      'po': {
+        fileRegex: '\\.(md|txt)$',
+        description: 'Story and requirement docs'
+      },
+      'sm': {
+        fileRegex: '\\.(md|txt)$',
+        description: 'Process and planning docs'
+      },
+      'bmad-orchestrator': null, // Full edit access
+      'bmad-master': null // Full edit access
+    };
 
     for (const agentId of agents) {
       // Skip if already exists
       if (existingModes.includes(`bmad-${agentId}`)) {
-        console.log(chalk.dim(`Skipping ${agentId} - already exists in .roomodes`));
+        console.log(
+          chalk.dim(`Skipping ${agentId} - already exists in .roomodes`)
+        );
         continue;
       }
 
       // Read agent file to extract all information
-      const agentPath = await this.findAgentPath(agentId, installDir);
+      let agentPath = path.join(
+        installDir,
+        ".bmad-core",
+        "agents",
+        `${agentId}.md`
+      );
+      if (!(await fileManager.pathExists(agentPath))) {
+        agentPath = path.join(installDir, "agents", `${agentId}.md`);
+      }
 
-      if (agentPath) {
+      if (await fileManager.pathExists(agentPath)) {
         const agentContent = await fileManager.readFile(agentPath);
 
         // Extract YAML content
@@ -399,9 +332,11 @@ class IdeSetup {
           const whenToUseMatch = yaml.match(/whenToUse:\s*"(.+)"/);
           const roleDefinitionMatch = yaml.match(/roleDefinition:\s*"(.+)"/);
 
-          const title = titleMatch ? titleMatch[1].trim() : await this.getAgentTitle(agentId, installDir);
+          const title = titleMatch ? titleMatch[1].trim() : this.getAgentTitle(agentId);
           const icon = iconMatch ? iconMatch[1].trim() : "🤖";
-          const whenToUse = whenToUseMatch ? whenToUseMatch[1].trim() : `Use for ${title} tasks`;
+          const whenToUse = whenToUseMatch
+            ? whenToUseMatch[1].trim()
+            : `Use for ${title} tasks`;
           const roleDefinition = roleDefinitionMatch
             ? roleDefinitionMatch[1].trim()
             : `You are a ${title} specializing in ${title.toLowerCase()} tasks and responsibilities.`;
@@ -411,12 +346,10 @@ class IdeSetup {
           newModesContent += `   name: '${icon} ${title}'\n`;
           newModesContent += `   roleDefinition: ${roleDefinition}\n`;
           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 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 += `   customInstructions: CRITICAL Read the full YML from .bmad-core/agents/${agentId}.md 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`;
-
+          
           // Add permissions based on agent type
           const permissions = agentPermissions[agentId];
           if (permissions) {
@@ -427,7 +360,9 @@ class IdeSetup {
             newModesContent += `    - edit\n`;
           }
 
-          console.log(chalk.green(`✓ Added mode: bmad-${agentId} (${icon} ${title})`));
+          console.log(
+            chalk.green(`✓ Added mode: bmad-${agentId} (${icon} ${title})`)
+          );
         }
       }
     }
@@ -444,342 +379,51 @@ class IdeSetup {
 
     // Write .roomodes file
     await fileManager.writeFile(roomodesPath, roomodesContent);
-    console.log(chalk.green("✓ Created .roomodes file in project root"));
+    console.log(chalk.green("✓ Created .roo/.roomodes file"));
 
-    console.log(chalk.green(`\n✓ Roo Code setup complete!`));
-    console.log(chalk.dim("Custom modes will be available when you open this project in Roo Code"));
+    // Create README in .roo directory
+    const rooReadme = `# Roo Code Custom Modes for BMAD-METHOD
 
-    return true;
-  }
+This directory contains custom mode configurations for Roo Code to enable BMAD agent personalities.
 
-  async setupCline(installDir, selectedAgent) {
-    const clineRulesDir = path.join(installDir, ".clinerules");
-    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+## Setup
 
-    await fileManager.ensureDirectory(clineRulesDir);
+The \`.roomodes\` file defines all BMAD agents as custom modes using the proper \`customModes:\` structure. Modes are automatically available in Roo Code when you open this project.
 
-    // Load dynamic agent ordering from configuration
-    const config = await this.loadIdeAgentConfig();
-    const agentOrder = config['cline-order'] || {};
+## Available Modes
 
-    for (const agentId of agents) {
-      // Find the agent file
-      const agentPath = await this.findAgentPath(agentId, installDir);
+${agents.map((id) => `- **bmad-${id}** - ${this.getAgentTitle(id)}`).join("\n")}
 
-      if (agentPath) {
-        const agentContent = await fileManager.readFile(agentPath);
+## Usage
 
-        // Get numeric prefix for ordering
-        const order = agentOrder[agentId] || 99;
-        const prefix = order.toString().padStart(2, '0');
-        const mdPath = path.join(clineRulesDir, `${prefix}-${agentId}.md`);
+In Roo Code:
+1. Open the mode selector (usually in the status bar)
+2. Select any BMAD agent mode
+3. The AI will adopt that agent's personality and expertise
 
-        // Create MD content for Cline (focused on project standards and role)
-        let mdContent = `# ${await this.getAgentTitle(agentId, installDir)} Agent\n\n`;
-        mdContent += `This rule defines the ${await this.getAgentTitle(agentId, installDir)} persona and project standards.\n\n`;
-        mdContent += "## Role Definition\n\n";
-        mdContent +=
-          "When the user types `@" + agentId + "`, adopt this persona and follow these guidelines:\n\n";
-        mdContent += "```yaml\n";
-        // Extract just the YAML content from the agent file
-        const yamlContent = extractYamlFromAgent(agentContent);
-        if (yamlContent) {
-          mdContent += yamlContent;
-        } else {
-          // If no YAML found, include the whole content minus the header
-          mdContent += agentContent.replace(/^#.*$/m, "").trim();
-        }
-        mdContent += "\n```\n\n";
-        mdContent += "## Project Standards\n\n";
-        mdContent += `- Always maintain consistency with project documentation in .bmad-core/\n`;
-        mdContent += `- Follow the agent's specific guidelines and constraints\n`;
-        mdContent += `- Update relevant project files when making changes\n`;
-        const relativePath = path.relative(installDir, agentPath).replace(/\\/g, '/');
-        mdContent += `- Reference the complete agent definition in [${relativePath}](${relativePath})\n\n`;
-        mdContent += "## Usage\n\n";
-        mdContent += `Type \`@${agentId}\` to activate this ${await this.getAgentTitle(agentId, installDir)} persona.\n`;
-
-        await fileManager.writeFile(mdPath, mdContent);
-        console.log(chalk.green(`✓ Created rule: ${prefix}-${agentId}.md`));
-      }
-    }
-
-    console.log(chalk.green(`\n✓ Created Cline rules in ${clineRulesDir}`));
-
-    return true;
-  }
-
-  async setupGeminiCli(installDir, selectedAgent) {
-    await initializeModules();
-    const geminiDir = path.join(installDir, ".gemini");
-    const agentsContextDir = path.join(geminiDir, "agents");
-    await fileManager.ensureDirectory(agentsContextDir);
-
-    // Get all available agents
-    const agents = await this.getAllAgentIds(installDir);
-    const agentContextFiles = [];
-
-    for (const agentId of agents) {
-      // Find the source agent file
-      const agentPath = await this.findAgentPath(agentId, installDir);
-
-      if (agentPath) {
-        const agentContent = await fileManager.readFile(agentPath);
-        const contextFilePath = path.join(agentsContextDir, `${agentId}.md`);
-
-        // Copy the agent content directly into its own context file
-        await fileManager.writeFile(contextFilePath, agentContent);
-
-        // Store the relative path for settings.json
-        const relativePath = path.relative(geminiDir, contextFilePath);
-        agentContextFiles.push(relativePath.replace(/\\/g, '/')); // Ensure forward slashes for consistency
-        console.log(chalk.green(`✓ Created context file for @${agentId}`));
-      }
-    }
-
-    console.log(chalk.green(`\n✓ Created individual agent context files in ${agentsContextDir}`));
-
-    // Add GEMINI.md to the context files array
-    agentContextFiles.push("GEMINI.md");
-
-    // Create or update settings.json
-    const settingsPath = path.join(geminiDir, "settings.json");
-    let settings = {};
-
-    if (await fileManager.pathExists(settingsPath)) {
-      try {
-        const existingSettings = await fileManager.readFile(settingsPath);
-        settings = JSON.parse(existingSettings);
-        console.log(chalk.yellow("Found existing .gemini/settings.json. Merging settings..."));
-      } catch (e) {
-        console.error(chalk.red("Error parsing existing settings.json. It will be overwritten."), e);
-        settings = {};
-      }
-    }
-
-    // Set contextFileName to our new array of files
-    settings.contextFileName = agentContextFiles;
-
-    await fileManager.writeFile(settingsPath, JSON.stringify(settings, null, 2));
-    console.log(chalk.green(`✓ Configured .gemini/settings.json to load all agent context files.`));
-
-    return true;
-  }
-
-  async setupGitHubCopilot(installDir, selectedAgent, spinner = null, preConfiguredSettings = null) {
-    await initializeModules();
-    
-    // Configure VS Code workspace settings first to avoid UI conflicts with loading spinners
-    await this.configureVsCodeSettings(installDir, spinner, preConfiguredSettings);
-    
-    const chatmodesDir = path.join(installDir, ".github", "chatmodes");
-    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
-     
-    await fileManager.ensureDirectory(chatmodesDir);
-
-    for (const agentId of agents) {
-      // Find the agent file
-      const agentPath = await this.findAgentPath(agentId, installDir);
-      const chatmodePath = path.join(chatmodesDir, `${agentId}.chatmode.md`);
-
-      if (agentPath) {
-        // Create chat mode file with agent content
-        const agentContent = await fileManager.readFile(agentPath);
-        const agentTitle = await this.getAgentTitle(agentId, installDir);
-        
-        // Extract whenToUse for the description
-        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
-        let description = `Activates the ${agentTitle} agent persona.`;
-        if (yamlMatch) {
-          const whenToUseMatch = yamlMatch[1].match(/whenToUse:\s*"(.*?)"/);
-          if (whenToUseMatch && whenToUseMatch[1]) {
-            description = whenToUseMatch[1];
-          }
-        }
-        
-        let chatmodeContent = `---
-description: "${description.replace(/"/g, '\\"')}"
-tools: ['changes', 'codebase', 'fetch', 'findTestFiles', 'githubRepo', 'problems', 'usages']
----
+## File Permissions
 
+Each agent has specific file access permissions:
+- **Analysts, PM, PO, SM**: Limited to documentation files (.md, .txt)
+- **Architect**: Architecture docs and configs (.md, .txt, .yml, .yaml, .json)
+- **QA**: Test files and documentation
+- **UX Expert**: Design-related files (.md, .css, .scss, .html, .jsx, .tsx)
+- **Developer, Orchestrator, Master**: Full edit access to all files
 `;
-        chatmodeContent += agentContent;
 
-        await fileManager.writeFile(chatmodePath, chatmodeContent);
-        console.log(chalk.green(`✓ Created chat mode: ${agentId}.chatmode.md`));
-      }
-    }
+    const readmePath = path.join(rooDir, "README.md");
+    await fileManager.writeFile(readmePath, rooReadme);
+    console.log(chalk.green("✓ Created .roo/README.md"));
 
-    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.`));
+    console.log(chalk.green(`\n✓ Roo Code setup complete!`));
+    console.log(
+      chalk.dim(
+        "Custom modes will be available when you open this project in Roo Code"
+      )
+    );
 
     return true;
   }
-
-  async configureVsCodeSettings(installDir, spinner, preConfiguredSettings = null) {
-    await initializeModules(); // Ensure inquirer is loaded
-    const vscodeDir = path.join(installDir, ".vscode");
-    const settingsPath = path.join(vscodeDir, "settings.json");
-    
-    await fileManager.ensureDirectory(vscodeDir);
-    
-    // Read existing settings if they exist
-    let existingSettings = {};
-    if (await fileManager.pathExists(settingsPath)) {
-      try {
-        const existingContent = await fileManager.readFile(settingsPath);
-        existingSettings = JSON.parse(existingContent);
-        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 = {};
-      }
-    }
-    
-    // Use pre-configured settings if provided, otherwise prompt
-    let configChoice;
-    if (preConfiguredSettings && preConfiguredSettings.configChoice) {
-      configChoice = preConfiguredSettings.configChoice;
-      console.log(chalk.dim(`Using pre-configured GitHub Copilot settings: ${configChoice}`));
-    } else {
-      // Clear any previous output and add spacing to avoid conflicts with loaders
-      console.log('\n'.repeat(2));
-      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 response = await inquirer.prompt([
-        {
-          type: 'list',
-          name: 'configChoice',
-          message: chalk.yellow('How would you like to configure GitHub Copilot settings?'),
-          choices: [
-            {
-              name: 'Use recommended defaults (fastest setup)',
-              value: 'defaults'
-            },
-            {
-              name: 'Configure each setting manually (customize to your preferences)',
-              value: 'manual'
-            },
-            {
-              name: 'Skip settings configuration (I\'ll configure manually later)',
-              value: 'skip'
-            }
-          ],
-          default: 'defaults'
-        }
-      ]);
-      configChoice = response.configChoice;
-    }
-    
-    let bmadSettings = {};
-    
-    if (configChoice === 'skip') {
-      console.log(chalk.yellow("⚠️  Skipping VS Code settings configuration."));
-      console.log(chalk.dim("You can manually configure these settings in .vscode/settings.json:"));
-      console.log(chalk.dim("  • chat.agent.enabled: true"));
-      console.log(chalk.dim("  • chat.agent.maxRequests: 15"));
-      console.log(chalk.dim("  • github.copilot.chat.agent.runTasks: true"));
-      console.log(chalk.dim("  • chat.mcp.discovery.enabled: true"));
-      console.log(chalk.dim("  • github.copilot.chat.agent.autoFix: true"));
-      console.log(chalk.dim("  • chat.tools.autoApprove: false"));
-      return true;
-    }
-    
-    if (configChoice === 'defaults') {
-      // Use recommended defaults
-      bmadSettings = {
-        "chat.agent.enabled": true,
-        "chat.agent.maxRequests": 15,
-        "github.copilot.chat.agent.runTasks": true,
-        "chat.mcp.discovery.enabled": true,
-        "github.copilot.chat.agent.autoFix": true,
-        "chat.tools.autoApprove": false
-      };
-      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:"));
-      
-      // Pause spinner during manual configuration prompts
-      let spinnerWasActive = false;
-      if (spinner && spinner.isSpinning) {
-        spinner.stop();
-        spinnerWasActive = true;
-      }
-      
-      const manualSettings = await inquirer.prompt([
-        {
-          type: 'input',
-          name: 'maxRequests',
-          message: 'Maximum requests per agent session (recommended: 15)?',
-          default: '15',
-          validate: (input) => {
-            const num = parseInt(input);
-            if (isNaN(num) || num < 1 || num > 50) {
-              return 'Please enter a number between 1 and 50';
-            }
-            return true;
-          }
-        },
-        {
-          type: 'confirm',
-          name: 'runTasks',
-          message: 'Allow agents to run workspace tasks (package.json scripts, etc.)?',
-          default: true
-        },
-        {
-          type: 'confirm',
-          name: 'mcpDiscovery',
-          message: 'Enable MCP (Model Context Protocol) server discovery?',
-          default: true
-        },
-        {
-          type: 'confirm',
-          name: 'autoFix',
-          message: 'Enable automatic error detection and fixing in generated code?',
-          default: true
-        },
-        {
-          type: 'confirm',
-          name: 'autoApprove',
-          message: 'Auto-approve ALL tools without confirmation? (⚠️  EXPERIMENTAL - less secure)',
-          default: false
-        }
-      ]);
-
-      // Restart spinner if it was active before prompts
-      if (spinner && spinnerWasActive) {
-        spinner.start();
-      }
-      
-      bmadSettings = {
-        "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,
-        "github.copilot.chat.agent.autoFix": manualSettings.autoFix,
-        "chat.tools.autoApprove": manualSettings.autoApprove
-      };
-      
-      console.log(chalk.green("✓ Custom settings configured"));
-    }
-    
-    // Merge settings (existing settings take precedence to avoid overriding user preferences)
-    const mergedSettings = { ...bmadSettings, ...existingSettings };
-    
-    // Write the updated settings
-    await fileManager.writeFile(settingsPath, JSON.stringify(mergedSettings, null, 2));
-    
-    console.log(chalk.green("✓ VS Code workspace settings configured successfully"));
-    console.log(chalk.dim("  Settings written to .vscode/settings.json:"));
-    Object.entries(bmadSettings).forEach(([key, value]) => {
-      console.log(chalk.dim(`  • ${key}: ${value}`));
-    });
-    console.log(chalk.dim(""));
-    console.log(chalk.dim("You can modify these settings anytime in .vscode/settings.json"));
-  }
 }
 
 module.exports = new IdeSetup();