bmad-method 5.0.0 → 5.1.0

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

@@ -1,20 +1,38 @@
-const path = require("path");
-const fileManager = require("./file-manager");
-const configLoader = require("./config-loader");
+const path = require('node:path');
+const fs = require('fs-extra');
+const yaml = require('js-yaml');
+const chalk = require('chalk');
+const inquirer = require('inquirer');
+const fileManager = require('./file-manager');
+const configLoader = require('./config-loader');
+const { extractYamlFromAgent } = require('../../lib/yaml-utils');
+const BaseIdeSetup = require('./ide-base-setup');
+const resourceLocator = require('./resource-locator');
 
-// Dynamic import for ES module
-let chalk;
+class IdeSetup extends BaseIdeSetup {
+  constructor() {
+    super();
+    this.ideAgentConfig = null;
+  }
+
+  async loadIdeAgentConfig() {
+    if (this.ideAgentConfig) return this.ideAgentConfig;
 
-// Initialize ES modules
-async function initializeModules() {
-  if (!chalk) {
-    chalk = (await import("chalk")).default;
+    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 {
+      console.warn('Failed to load IDE agent configuration, using defaults');
+      return {
+        'roo-permissions': {},
+        'cline-order': {},
+      };
+    }
   }
-}
 
-class IdeSetup {
-  async setup(ide, installDir, selectedAgent = null) {
-    await initializeModules();
+  async setup(ide, installDir, selectedAgent = null, spinner = null, preConfiguredSettings = null) {
     const ideConfig = await configLoader.getIdeConfiguration(ide);
 
     if (!ideConfig) {
@@ -23,108 +41,185 @@ class IdeSetup {
     }
 
     switch (ide) {
-      case "cursor":
+      case 'cursor': {
         return this.setupCursor(installDir, selectedAgent);
-      case "claude-code":
+      }
+      case 'claude-code': {
         return this.setupClaudeCode(installDir, selectedAgent);
-      case "windsurf":
+      }
+      case 'crush': {
+        return this.setupCrush(installDir, selectedAgent);
+      }
+      case 'windsurf': {
         return this.setupWindsurf(installDir, selectedAgent);
-      case "roo":
+      }
+      case 'trae': {
+        return this.setupTrae(installDir, selectedAgent);
+      }
+      case 'roo': {
         return this.setupRoo(installDir, selectedAgent);
-      default:
+      }
+      case 'cline': {
+        return this.setupCline(installDir, selectedAgent);
+      }
+      case 'kilo': {
+        return this.setupKilocode(installDir, selectedAgent);
+      }
+      case 'gemini': {
+        return this.setupGeminiCli(installDir, selectedAgent);
+      }
+      case 'github-copilot': {
+        return this.setupGitHubCopilot(installDir, selectedAgent, spinner, preConfiguredSettings);
+      }
+      case 'qwen-code': {
+        return this.setupQwenCode(installDir, selectedAgent);
+      }
+      default: {
         console.log(chalk.yellow(`\nIDE ${ide} not yet supported`));
         return false;
+      }
     }
   }
 
   async setupCursor(installDir, selectedAgent) {
-    const cursorRulesDir = path.join(installDir, ".cursor", "rules");
-    const agents = selectedAgent
-      ? [selectedAgent]
-      : await this.getAllAgentIds(installDir);
+    const cursorRulesDir = path.join(installDir, '.cursor', 'rules', 'bmad');
+    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
 
     await fileManager.ensureDirectory(cursorRulesDir);
 
     for (const agentId of agents) {
-      // 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 agentPath = await this.findAgentPath(agentId, installDir);
 
-      if (await fileManager.pathExists(agentPath)) {
-        const agentContent = await fileManager.readFile(agentPath);
+      if (agentPath) {
+        const mdcContent = await this.createAgentRuleContent(agentId, agentPath, installDir, 'mdc');
         const mdcPath = path.join(cursorRulesDir, `${agentId}.mdc`);
-
-        // Create MDC content with proper format
-        let mdcContent = "---\n";
-        mdcContent += "description: \n";
-        mdcContent += "globs: []\n";
-        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 ${this.getAgentTitle(
-          agentId
-        )} agent persona.\n\n`;
-        mdcContent += "## Agent Activation\n\n";
-        mdcContent +=
-          "CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n";
-        mdcContent += "```yml\n";
-        // Extract just the YAML content from the agent file
-        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";
-        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 ${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`));
       }
     }
 
     console.log(chalk.green(`\n✓ Created Cursor rules in ${cursorRulesDir}`));
+    return true;
+  }
+
+  async setupCrush(installDir, selectedAgent) {
+    // Setup bmad-core commands
+    const coreSlashPrefix = await this.getCoreSlashPrefix(installDir);
+    const coreAgents = selectedAgent ? [selectedAgent] : await this.getCoreAgentIds(installDir);
+    const coreTasks = await this.getCoreTaskIds(installDir);
+    await this.setupCrushForPackage(
+      installDir,
+      'core',
+      coreSlashPrefix,
+      coreAgents,
+      coreTasks,
+      '.bmad-core',
+    );
+
+    // Setup expansion pack commands
+    const expansionPacks = await this.getInstalledExpansionPacks(installDir);
+    for (const packInfo of expansionPacks) {
+      const packSlashPrefix = await this.getExpansionPackSlashPrefix(packInfo.path);
+      const packAgents = await this.getExpansionPackAgents(packInfo.path);
+      const packTasks = await this.getExpansionPackTasks(packInfo.path);
+
+      if (packAgents.length > 0 || packTasks.length > 0) {
+        // Use the actual directory name where the expansion pack is installed
+        const rootPath = path.relative(installDir, packInfo.path);
+        await this.setupCrushForPackage(
+          installDir,
+          packInfo.name,
+          packSlashPrefix,
+          packAgents,
+          packTasks,
+          rootPath,
+        );
+      }
+    }
 
     return true;
   }
 
   async setupClaudeCode(installDir, selectedAgent) {
-    const commandsDir = path.join(installDir, ".claude", "commands");
-    const agents = selectedAgent
-      ? [selectedAgent]
-      : await this.getAllAgentIds(installDir);
+    // Setup bmad-core commands
+    const coreSlashPrefix = await this.getCoreSlashPrefix(installDir);
+    const coreAgents = selectedAgent ? [selectedAgent] : await this.getCoreAgentIds(installDir);
+    const coreTasks = await this.getCoreTaskIds(installDir);
+    await this.setupClaudeCodeForPackage(
+      installDir,
+      'core',
+      coreSlashPrefix,
+      coreAgents,
+      coreTasks,
+      '.bmad-core',
+    );
 
-    await fileManager.ensureDirectory(commandsDir);
+    // Setup expansion pack commands
+    const expansionPacks = await this.getInstalledExpansionPacks(installDir);
+    for (const packInfo of expansionPacks) {
+      const packSlashPrefix = await this.getExpansionPackSlashPrefix(packInfo.path);
+      const packAgents = await this.getExpansionPackAgents(packInfo.path);
+      const packTasks = await this.getExpansionPackTasks(packInfo.path);
 
-    for (const agentId of agents) {
-      // 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 (packAgents.length > 0 || packTasks.length > 0) {
+        // Use the actual directory name where the expansion pack is installed
+        const rootPath = path.relative(installDir, packInfo.path);
+        await this.setupClaudeCodeForPackage(
+          installDir,
+          packInfo.name,
+          packSlashPrefix,
+          packAgents,
+          packTasks,
+          rootPath,
+        );
       }
-      const commandPath = path.join(commandsDir, `${agentId}.md`);
+    }
 
-      if (await fileManager.pathExists(agentPath)) {
+    return true;
+  }
+
+  async setupClaudeCodeForPackage(
+    installDir,
+    packageName,
+    slashPrefix,
+    agentIds,
+    taskIds,
+    rootPath,
+  ) {
+    const commandsBaseDir = path.join(installDir, '.claude', 'commands', slashPrefix);
+    const agentsDir = path.join(commandsBaseDir, 'agents');
+    const tasksDir = path.join(commandsBaseDir, 'tasks');
+
+    // Ensure directories exist
+    await fileManager.ensureDirectory(agentsDir);
+    await fileManager.ensureDirectory(tasksDir);
+
+    // Setup agents
+    for (const agentId of agentIds) {
+      // Find the agent file - for expansion packs, prefer the expansion pack version
+      let agentPath;
+      if (packageName === 'core') {
+        // For core, use the normal search
+        agentPath = await this.findAgentPath(agentId, installDir);
+      } else {
+        // For expansion packs, first try to find the agent in the expansion pack directory
+        const expansionPackPath = path.join(installDir, rootPath, 'agents', `${agentId}.md`);
+        if (await fileManager.pathExists(expansionPackPath)) {
+          agentPath = expansionPackPath;
+        } else {
+          // Fall back to core if not found in expansion pack
+          agentPath = await this.findAgentPath(agentId, installDir);
+        }
+      }
+
+      const commandPath = path.join(agentsDir, `${agentId}.md`);
+
+      if (agentPath) {
         // Create command file with agent content
-        const agentContent = await fileManager.readFile(agentPath);
+        let agentContent = await fileManager.readFile(agentPath);
+
+        // Replace {root} placeholder with the appropriate root path for this context
+        agentContent = agentContent.replaceAll('{root}', rootPath);
 
         // Add command header
         let commandContent = `# /${agentId} Command\n\n`;
@@ -132,119 +227,551 @@ class IdeSetup {
         commandContent += agentContent;
 
         await fileManager.writeFile(commandPath, commandContent);
-        console.log(chalk.green(`✓ Created command: /${agentId}`));
+        console.log(chalk.green(`✓ Created agent command: /${agentId}`));
+      }
+    }
+
+    // Setup tasks
+    for (const taskId of taskIds) {
+      // Find the task file - for expansion packs, prefer the expansion pack version
+      let taskPath;
+      if (packageName === 'core') {
+        // For core, use the normal search
+        taskPath = await this.findTaskPath(taskId, installDir);
+      } else {
+        // For expansion packs, first try to find the task in the expansion pack directory
+        const expansionPackPath = path.join(installDir, rootPath, 'tasks', `${taskId}.md`);
+        if (await fileManager.pathExists(expansionPackPath)) {
+          taskPath = expansionPackPath;
+        } else {
+          // Fall back to core if not found in expansion pack
+          taskPath = await this.findTaskPath(taskId, installDir);
+        }
+      }
+
+      const commandPath = path.join(tasksDir, `${taskId}.md`);
+
+      if (taskPath) {
+        // Create command file with task content
+        let taskContent = await fileManager.readFile(taskPath);
+
+        // Replace {root} placeholder with the appropriate root path for this context
+        taskContent = taskContent.replaceAll('{root}', rootPath);
+
+        // Add command header
+        let commandContent = `# /${taskId} Task\n\n`;
+        commandContent += `When this command is used, execute the following task:\n\n`;
+        commandContent += taskContent;
+
+        await fileManager.writeFile(commandPath, commandContent);
+        console.log(chalk.green(`✓ Created task command: /${taskId}`));
       }
     }
 
     console.log(
-      chalk.green(`\n✓ Created Claude Code commands in ${commandsDir}`)
+      chalk.green(`\n✓ Created Claude Code commands for ${packageName} in ${commandsBaseDir}`),
     );
+    console.log(chalk.dim(`  - Agents in: ${agentsDir}`));
+    console.log(chalk.dim(`  - Tasks in: ${tasksDir}`));
+  }
 
-    return true;
+  async setupCrushForPackage(installDir, packageName, slashPrefix, agentIds, taskIds, rootPath) {
+    const commandsBaseDir = path.join(installDir, '.crush', 'commands', slashPrefix);
+    const agentsDir = path.join(commandsBaseDir, 'agents');
+    const tasksDir = path.join(commandsBaseDir, 'tasks');
+
+    // Ensure directories exist
+    await fileManager.ensureDirectory(agentsDir);
+    await fileManager.ensureDirectory(tasksDir);
+
+    // Setup agents
+    for (const agentId of agentIds) {
+      // Find the agent file - for expansion packs, prefer the expansion pack version
+      let agentPath;
+      if (packageName === 'core') {
+        // For core, use the normal search
+        agentPath = await this.findAgentPath(agentId, installDir);
+      } else {
+        // For expansion packs, first try to find the agent in the expansion pack directory
+        const expansionPackPath = path.join(installDir, rootPath, 'agents', `${agentId}.md`);
+        if (await fileManager.pathExists(expansionPackPath)) {
+          agentPath = expansionPackPath;
+        } else {
+          // Fall back to core if not found in expansion pack
+          agentPath = await this.findAgentPath(agentId, installDir);
+        }
+      }
+
+      const commandPath = path.join(agentsDir, `${agentId}.md`);
+
+      if (agentPath) {
+        // Create command file with agent content
+        let agentContent = await fileManager.readFile(agentPath);
+
+        // Replace {root} placeholder with the appropriate root path for this context
+        agentContent = agentContent.replaceAll('{root}', rootPath);
+
+        // Add command header
+        let commandContent = `# /${agentId} Command\n\n`;
+        commandContent += `When this command is used, adopt the following agent persona:\n\n`;
+        commandContent += agentContent;
+
+        await fileManager.writeFile(commandPath, commandContent);
+        console.log(chalk.green(`✓ Created agent command: /${agentId}`));
+      }
+    }
+
+    // Setup tasks
+    for (const taskId of taskIds) {
+      // Find the task file - for expansion packs, prefer the expansion pack version
+      let taskPath;
+      if (packageName === 'core') {
+        // For core, use the normal search
+        taskPath = await this.findTaskPath(taskId, installDir);
+      } else {
+        // For expansion packs, first try to find the task in the expansion pack directory
+        const expansionPackPath = path.join(installDir, rootPath, 'tasks', `${taskId}.md`);
+        if (await fileManager.pathExists(expansionPackPath)) {
+          taskPath = expansionPackPath;
+        } else {
+          // Fall back to core if not found in expansion pack
+          taskPath = await this.findTaskPath(taskId, installDir);
+        }
+      }
+
+      const commandPath = path.join(tasksDir, `${taskId}.md`);
+
+      if (taskPath) {
+        // Create command file with task content
+        let taskContent = await fileManager.readFile(taskPath);
+
+        // Replace {root} placeholder with the appropriate root path for this context
+        taskContent = taskContent.replaceAll('{root}', rootPath);
+
+        // Add command header
+        let commandContent = `# /${taskId} Task\n\n`;
+        commandContent += `When this command is used, execute the following task:\n\n`;
+        commandContent += taskContent;
+
+        await fileManager.writeFile(commandPath, commandContent);
+        console.log(chalk.green(`✓ Created task command: /${taskId}`));
+      }
+    }
+
+    console.log(chalk.green(`\n✓ Created Crush commands for ${packageName} in ${commandsBaseDir}`));
+    console.log(chalk.dim(`  - Agents in: ${agentsDir}`));
+    console.log(chalk.dim(`  - Tasks in: ${tasksDir}`));
   }
 
   async setupWindsurf(installDir, selectedAgent) {
-    const windsurfRulesDir = path.join(installDir, ".windsurf", "rules");
-    const agents = selectedAgent
-      ? [selectedAgent]
-      : await this.getAllAgentIds(installDir);
+    const windsurfWorkflowDir = path.join(installDir, '.windsurf', 'workflows');
+    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
 
-    await fileManager.ensureDirectory(windsurfRulesDir);
+    await fileManager.ensureDirectory(windsurfWorkflowDir);
 
     for (const agentId of agents) {
-      // 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`);
+      // Find the agent file
+      const agentPath = await this.findAgentPath(agentId, installDir);
+
+      if (agentPath) {
+        const agentContent = await fileManager.readFile(agentPath);
+        const mdPath = path.join(windsurfWorkflowDir, `${agentId}.md`);
+
+        // Write the agent file contents prefixed with Windsurf frontmatter
+        let mdContent = `---\n`;
+        mdContent += `description: ${agentId}\n`;
+        mdContent += `auto_execution_mode: 3\n`;
+        mdContent += `---\n\n`;
+        mdContent += agentContent;
+
+        await fileManager.writeFile(mdPath, mdContent);
+        console.log(chalk.green(`✓ Created workflow: ${agentId}.md`));
       }
+    }
 
-      if (await fileManager.pathExists(agentPath)) {
+    console.log(chalk.green(`\n✓ Created Windsurf workflows in ${windsurfWorkflowDir}`));
+
+    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(windsurfRulesDir, `${agentId}.md`);
+        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 ${this.getAgentTitle(
-          agentId
+        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 += '## Agent Activation\n\n';
         mdContent +=
-          "CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n";
-        mdContent += "```yml\n";
+          'CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n';
+        mdContent += '```yaml\n';
         // Extract just the YAML content from the agent file
-        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
-        if (yamlMatch) {
-          mdContent += yamlMatch[1].trim();
+        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 += agentContent.replace(/^#.*$/m, '').trim();
         }
-        mdContent += "\n```\n\n";
-        mdContent += "## File Reference\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 ${this.getAgentTitle(
-          agentId
-        )} persona and follow all instructions defined in the YML configuration above.\n`;
+        mdContent += '\n```\n\n';
+        mdContent += '## File Reference\n\n';
+        const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');
+        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`));
       }
     }
+  }
 
-    console.log(
-      chalk.green(`\n✓ Created Windsurf rules in ${windsurfRulesDir}`)
-    );
+  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`),
+    ];
 
-    return true;
+    // Also check expansion pack directories
+    const glob = require('glob');
+    const expansionDirectories = glob.sync('.*/agents', { cwd: installDir });
+    for (const expDir of expansionDirectories) {
+      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) {
-    // 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");
+    const glob = require('glob');
+    const allAgentIds = [];
+
+    // Check core agents in .bmad-core or root
+    let agentsDir = path.join(installDir, '.bmad-core', 'agents');
     if (!(await fileManager.pathExists(agentsDir))) {
-      agentsDir = path.join(installDir, "agents");
+      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')));
     }
 
-    const glob = require("glob");
-    const agentFiles = glob.sync("*.md", { cwd: agentsDir });
-    return agentFiles.map((file) => path.basename(file, ".md"));
+    // Also check for expansion pack agents in dot folders
+    const expansionDirectories = glob.sync('.*/agents', { cwd: installDir });
+    for (const expDir of expansionDirectories) {
+      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)];
   }
 
-  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 getCoreAgentIds(installDir) {
+    const allAgentIds = [];
+
+    // Check core agents in .bmad-core or root only
+    let agentsDir = path.join(installDir, '.bmad-core', 'agents');
+    if (!(await fileManager.pathExists(agentsDir))) {
+      agentsDir = path.join(installDir, 'bmad-core', 'agents');
+    }
+
+    if (await fileManager.pathExists(agentsDir)) {
+      const glob = require('glob');
+      const agentFiles = glob.sync('*.md', { cwd: agentsDir });
+      allAgentIds.push(...agentFiles.map((file) => path.basename(file, '.md')));
+    }
+
+    return [...new Set(allAgentIds)];
   }
 
-  async setupRoo(installDir, selectedAgent) {
-    const agents = selectedAgent
-      ? [selectedAgent]
-      : await this.getAllAgentIds(installDir);
+  async getCoreTaskIds(installDir) {
+    const allTaskIds = [];
+
+    // Check core tasks in .bmad-core or root only
+    let tasksDir = path.join(installDir, '.bmad-core', 'tasks');
+    if (!(await fileManager.pathExists(tasksDir))) {
+      tasksDir = path.join(installDir, 'bmad-core', 'tasks');
+    }
+
+    if (await fileManager.pathExists(tasksDir)) {
+      const glob = require('glob');
+      const taskFiles = glob.sync('*.md', { cwd: tasksDir });
+      allTaskIds.push(...taskFiles.map((file) => path.basename(file, '.md')));
+    }
+
+    // Check common tasks
+    const commonTasksDir = path.join(installDir, 'common', 'tasks');
+    if (await fileManager.pathExists(commonTasksDir)) {
+      const commonTaskFiles = glob.sync('*.md', { cwd: commonTasksDir });
+      allTaskIds.push(...commonTaskFiles.map((file) => path.basename(file, '.md')));
+    }
+
+    return [...new Set(allTaskIds)];
+  }
+
+  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`),
+    ];
 
-    // Create .roo directory first
-    const rooDir = path.join(installDir, ".roo");
-    await fileManager.ensureDirectory(rooDir);
+    // Also check expansion pack directories
+    const glob = require('glob');
+    const expansionDirectories = glob.sync('.*/agents', { cwd: installDir });
+    for (const expDir of expansionDirectories) {
+      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\r?\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(' ');
+  }
+
+  async getAllTaskIds(installDir) {
+    const glob = require('glob');
+    const allTaskIds = [];
+
+    // Check core tasks in .bmad-core or root
+    let tasksDir = path.join(installDir, '.bmad-core', 'tasks');
+    if (!(await fileManager.pathExists(tasksDir))) {
+      tasksDir = path.join(installDir, 'bmad-core', 'tasks');
+    }
+
+    if (await fileManager.pathExists(tasksDir)) {
+      const taskFiles = glob.sync('*.md', { cwd: tasksDir });
+      allTaskIds.push(...taskFiles.map((file) => path.basename(file, '.md')));
+    }
+
+    // Check common tasks
+    const commonTasksDir = path.join(installDir, 'common', 'tasks');
+    if (await fileManager.pathExists(commonTasksDir)) {
+      const commonTaskFiles = glob.sync('*.md', { cwd: commonTasksDir });
+      allTaskIds.push(...commonTaskFiles.map((file) => path.basename(file, '.md')));
+    }
+
+    // Also check for expansion pack tasks in dot folders
+    const expansionDirectories = glob.sync('.*/tasks', { cwd: installDir });
+    for (const expDir of expansionDirectories) {
+      const fullExpDir = path.join(installDir, expDir);
+      const expTaskFiles = glob.sync('*.md', { cwd: fullExpDir });
+      allTaskIds.push(...expTaskFiles.map((file) => path.basename(file, '.md')));
+    }
+
+    // Check expansion-packs folder tasks
+    const expansionPacksDir = path.join(installDir, 'expansion-packs');
+    if (await fileManager.pathExists(expansionPacksDir)) {
+      const expPackDirectories = glob.sync('*/tasks', { cwd: expansionPacksDir });
+      for (const expDir of expPackDirectories) {
+        const fullExpDir = path.join(expansionPacksDir, expDir);
+        const expTaskFiles = glob.sync('*.md', { cwd: fullExpDir });
+        allTaskIds.push(...expTaskFiles.map((file) => path.basename(file, '.md')));
+      }
+    }
+
+    // Remove duplicates
+    return [...new Set(allTaskIds)];
+  }
+
+  async findTaskPath(taskId, installDir) {
+    // Try to find the task file in various locations
+    const possiblePaths = [
+      path.join(installDir, '.bmad-core', 'tasks', `${taskId}.md`),
+      path.join(installDir, 'bmad-core', 'tasks', `${taskId}.md`),
+      path.join(installDir, 'common', 'tasks', `${taskId}.md`),
+    ];
 
-    // Check for existing .roomodes file inside .roo directory
-    const roomodesPath = path.join(rooDir, ".roomodes");
+    // Also check expansion pack directories
+    const glob = require('glob');
+
+    // Check dot folder expansion packs
+    const expansionDirectories = glob.sync('.*/tasks', { cwd: installDir });
+    for (const expDir of expansionDirectories) {
+      possiblePaths.push(path.join(installDir, expDir, `${taskId}.md`));
+    }
+
+    // Check expansion-packs folder
+    const expansionPacksDir = path.join(installDir, 'expansion-packs');
+    if (await fileManager.pathExists(expansionPacksDir)) {
+      const expPackDirectories = glob.sync('*/tasks', { cwd: expansionPacksDir });
+      for (const expDir of expPackDirectories) {
+        possiblePaths.push(path.join(expansionPacksDir, expDir, `${taskId}.md`));
+      }
+    }
+
+    for (const taskPath of possiblePaths) {
+      if (await fileManager.pathExists(taskPath)) {
+        return taskPath;
+      }
+    }
+
+    return null;
+  }
+
+  async getCoreSlashPrefix(installDir) {
+    try {
+      const coreConfigPath = path.join(installDir, '.bmad-core', 'core-config.yaml');
+      if (!(await fileManager.pathExists(coreConfigPath))) {
+        // Try bmad-core directory
+        const altConfigPath = path.join(installDir, 'bmad-core', 'core-config.yaml');
+        if (await fileManager.pathExists(altConfigPath)) {
+          const configContent = await fileManager.readFile(altConfigPath);
+          const config = yaml.load(configContent);
+          return config.slashPrefix || 'BMad';
+        }
+        return 'BMad'; // fallback
+      }
+
+      const configContent = await fileManager.readFile(coreConfigPath);
+      const config = yaml.load(configContent);
+      return config.slashPrefix || 'BMad';
+    } catch (error) {
+      console.warn(`Failed to read core slashPrefix, using default 'BMad': ${error.message}`);
+      return 'BMad';
+    }
+  }
+
+  async getInstalledExpansionPacks(installDir) {
+    const expansionPacks = [];
+
+    // Check for dot-prefixed expansion packs in install directory
+    const glob = require('glob');
+    const dotExpansions = glob.sync('.bmad-*', { cwd: installDir });
+
+    for (const dotExpansion of dotExpansions) {
+      if (dotExpansion !== '.bmad-core') {
+        const packPath = path.join(installDir, dotExpansion);
+        const packName = dotExpansion.slice(1); // remove the dot
+        expansionPacks.push({
+          name: packName,
+          path: packPath,
+        });
+      }
+    }
+
+    // Check for expansion-packs directory style
+    const expansionPacksDir = path.join(installDir, 'expansion-packs');
+    if (await fileManager.pathExists(expansionPacksDir)) {
+      const packDirectories = glob.sync('*', { cwd: expansionPacksDir });
+
+      for (const packDir of packDirectories) {
+        const packPath = path.join(expansionPacksDir, packDir);
+        if (
+          (await fileManager.pathExists(packPath)) &&
+          (await fileManager.pathExists(path.join(packPath, 'config.yaml')))
+        ) {
+          expansionPacks.push({
+            name: packDir,
+            path: packPath,
+          });
+        }
+      }
+    }
+
+    return expansionPacks;
+  }
+
+  async getExpansionPackSlashPrefix(packPath) {
+    try {
+      const configPath = path.join(packPath, 'config.yaml');
+      if (await fileManager.pathExists(configPath)) {
+        const configContent = await fileManager.readFile(configPath);
+        const config = yaml.load(configContent);
+        return config.slashPrefix || path.basename(packPath);
+      }
+    } catch (error) {
+      console.warn(`Failed to read expansion pack slashPrefix from ${packPath}: ${error.message}`);
+    }
+
+    return path.basename(packPath); // fallback to directory name
+  }
+
+  async getExpansionPackAgents(packPath) {
+    const agentsDir = path.join(packPath, 'agents');
+    if (!(await fileManager.pathExists(agentsDir))) {
+      return [];
+    }
+
+    try {
+      const glob = require('glob');
+      const agentFiles = glob.sync('*.md', { cwd: agentsDir });
+      return agentFiles.map((file) => path.basename(file, '.md'));
+    } catch (error) {
+      console.warn(`Failed to read expansion pack agents from ${packPath}: ${error.message}`);
+      return [];
+    }
+  }
+
+  async getExpansionPackTasks(packPath) {
+    const tasksDir = path.join(packPath, 'tasks');
+    if (!(await fileManager.pathExists(tasksDir))) {
+      return [];
+    }
+
+    try {
+      const glob = require('glob');
+      const taskFiles = glob.sync('*.md', { cwd: tasksDir });
+      return taskFiles.map((file) => path.basename(file, '.md'));
+    } catch (error) {
+      console.warn(`Failed to read expansion pack tasks from ${packPath}: ${error.message}`);
+      return [];
+    }
+  }
+
+  async setupRoo(installDir, selectedAgent) {
+    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+
+    // Check for existing .roomodes file in project root
+    const roomodesPath = path.join(installDir, '.roomodes');
     let existingModes = [];
-    let existingContent = "";
+    let existingContent = '';
 
     if (await fileManager.pathExists(roomodesPath)) {
       existingContent = await fileManager.readFile(roomodesPath);
@@ -253,76 +780,33 @@ 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 = "";
-
-    // 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
-    };
+    let newModesContent = '';
+
+    // Load dynamic agent permissions from configuration
+    const config = await this.loadIdeAgentConfig();
+    const agentPermissions = config['roo-permissions'] || {};
 
     for (const agentId of agents) {
       // Skip if already exists
-      if (existingModes.includes(`bmad-${agentId}`)) {
-        console.log(
-          chalk.dim(`Skipping ${agentId} - already exists in .roomodes`)
-        );
+      // Check both with and without bmad- prefix to handle both cases
+      const checkSlug = agentId.startsWith('bmad-') ? agentId : `bmad-${agentId}`;
+      if (existingModes.includes(checkSlug)) {
+        console.log(chalk.dim(`Skipping ${agentId} - already exists in .roomodes`));
         continue;
       }
 
       // Read agent file to extract all information
-      let agentPath = path.join(
-        installDir,
-        ".bmad-core",
-        "agents",
-        `${agentId}.md`
-      );
-      if (!(await fileManager.pathExists(agentPath))) {
-        agentPath = path.join(installDir, "agents", `${agentId}.md`);
-      }
+      const agentPath = await this.findAgentPath(agentId, installDir);
 
-      if (await fileManager.pathExists(agentPath)) {
+      if (agentPath) {
         const agentContent = await fileManager.readFile(agentPath);
 
         // Extract YAML content
-        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
+        const yamlMatch = agentContent.match(/```ya?ml\r?\n([\s\S]*?)```/);
         if (yamlMatch) {
           const yaml = yamlMatch[1];
 
@@ -332,26 +816,33 @@ class IdeSetup {
           const whenToUseMatch = yaml.match(/whenToUse:\s*"(.+)"/);
           const roleDefinitionMatch = yaml.match(/roleDefinition:\s*"(.+)"/);
 
-          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 title = titleMatch
+            ? titleMatch[1].trim()
+            : await this.getAgentTitle(agentId, installDir);
+          const icon = iconMatch ? iconMatch[1].trim() : '🤖';
+          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.`;
 
+          // Add permissions based on agent type
+          const permissions = agentPermissions[agentId];
           // Build mode entry with proper formatting (matching exact indentation)
-          newModesContent += ` - slug: bmad-${agentId}\n`;
+          // Avoid double "bmad-" prefix for agents that already have it
+          const slug = agentId.startsWith('bmad-') ? agentId : `bmad-${agentId}`;
+          newModesContent += ` - slug: ${slug}\n`;
           newModesContent += `   name: '${icon} ${title}'\n`;
+          if (permissions) {
+            newModesContent += `   description: '${permissions.description}'\n`;
+          }
           newModesContent += `   roleDefinition: ${roleDefinition}\n`;
           newModesContent += `   whenToUse: ${whenToUse}\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`;
+          // Get relative path from installDir to agent file
+          const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');
+          newModesContent += `   customInstructions: CRITICAL Read the full YAML from ${relativePath} start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode\n`;
           newModesContent += `   groups:\n`;
           newModesContent += `    - read\n`;
-          
-          // Add permissions based on agent type
-          const permissions = agentPermissions[agentId];
+
           if (permissions) {
             newModesContent += `    - - edit\n`;
             newModesContent += `      - fileRegex: ${permissions.fileRegex}\n`;
@@ -360,70 +851,591 @@ 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})`));
         }
       }
     }
 
     // Build final roomodes content
-    let roomodesContent = "";
+    let roomodesContent = '';
     if (existingContent) {
       // If there's existing content, append new modes to it
-      roomodesContent = existingContent.trim() + "\n" + newModesContent;
+      roomodesContent = existingContent.trim() + '\n' + newModesContent;
     } else {
       // Create new .roomodes file with proper YAML structure
-      roomodesContent = "customModes:\n" + newModesContent;
+      roomodesContent = 'customModes:\n' + newModesContent;
     }
 
     // Write .roomodes file
     await fileManager.writeFile(roomodesPath, roomodesContent);
-    console.log(chalk.green("✓ Created .roo/.roomodes file"));
+    console.log(chalk.green('✓ Created .roomodes file in project root'));
+
+    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 setupKilocode(installDir, selectedAgent) {
+    const filePath = path.join(installDir, '.kilocodemodes');
+    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+
+    let existingModes = [],
+      existingContent = '';
+    if (await fileManager.pathExists(filePath)) {
+      existingContent = await fileManager.readFile(filePath);
+      for (const match of existingContent.matchAll(/- slug: ([\w-]+)/g)) {
+        existingModes.push(match[1]);
+      }
+      console.log(
+        chalk.yellow(`Found existing .kilocodemodes file with ${existingModes.length} modes`),
+      );
+    }
 
-    // Create README in .roo directory
-    const rooReadme = `# Roo Code Custom Modes for BMAD-METHOD
+    const config = await this.loadIdeAgentConfig();
+    const permissions = config['roo-permissions'] || {}; // reuse same roo permissions block (Kilo Code understands same mode schema)
 
-This directory contains custom mode configurations for Roo Code to enable BMAD agent personalities.
+    let newContent = '';
 
-## Setup
+    for (const agentId of agents) {
+      const slug = agentId.startsWith('bmad-') ? agentId : `bmad-${agentId}`;
+      if (existingModes.includes(slug)) {
+        console.log(chalk.dim(`Skipping ${agentId} - already exists in .kilocodemodes`));
+        continue;
+      }
+
+      const agentPath = await this.findAgentPath(agentId, installDir);
+      if (!agentPath) {
+        console.log(chalk.red(`✗ Could not find agent file for ${agentId}`));
+        continue;
+      }
+
+      const agentContent = await fileManager.readFile(agentPath);
+      const yamlMatch = agentContent.match(/```ya?ml\r?\n([\s\S]*?)```/);
+      if (!yamlMatch) {
+        console.log(chalk.red(`✗ Could not extract YAML block for ${agentId}`));
+        continue;
+      }
+
+      const yaml = yamlMatch[1];
+
+      // Robust fallback for title and icon
+      const title =
+        yaml.match(/title:\s*(.+)/)?.[1]?.trim() || (await this.getAgentTitle(agentId, installDir));
+      const icon = yaml.match(/icon:\s*(.+)/)?.[1]?.trim() || '🤖';
+      const whenToUse = yaml.match(/whenToUse:\s*"(.+)"/)?.[1]?.trim() || `Use for ${title} tasks`;
+      const roleDefinition =
+        yaml.match(/roleDefinition:\s*"(.+)"/)?.[1]?.trim() ||
+        `You are a ${title} specializing in ${title.toLowerCase()} tasks and responsibilities.`;
+
+      const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');
+      const 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`;
+
+      // Add permissions from config if they exist
+      const agentPermission = permissions[agentId];
+
+      // Begin .kilocodemodes block
+      newContent += ` - slug: ${slug}\n`;
+      newContent += `   name: '${icon} ${title}'\n`;
+      if (agentPermission) {
+        newContent += `   description: '${agentPermission.description}'\n`;
+      }
+
+      newContent += `   roleDefinition: ${roleDefinition}\n`;
+      newContent += `   whenToUse: ${whenToUse}\n`;
+      newContent += `   customInstructions: ${customInstructions}\n`;
+      newContent += `   groups:\n`;
+      newContent += `    - read\n`;
+
+      if (agentPermission) {
+        newContent += `    - - edit\n`;
+        newContent += `      - fileRegex: ${agentPermission.fileRegex}\n`;
+        newContent += `        description: ${agentPermission.description}\n`;
+      } else {
+        // Fallback to generic edit
+        newContent += `    - edit\n`;
+      }
+
+      console.log(chalk.green(`✓ Added Kilo mode: ${slug} (${icon} ${title})`));
+    }
+
+    const finalContent = existingContent
+      ? existingContent.trim() + '\n' + newContent
+      : 'customModes:\n' + newContent;
+
+    await fileManager.writeFile(filePath, finalContent);
+    console.log(chalk.green('✓ Created .kilocodemodes file in project root'));
+    console.log(chalk.green(`✓ KiloCode setup complete!`));
+    console.log(chalk.dim('Custom modes will be available when you open this project in KiloCode'));
+
+    return true;
+  }
 
-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.
+  async setupCline(installDir, selectedAgent) {
+    const clineRulesDir = path.join(installDir, '.clinerules');
+    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
 
-## Available Modes
+    await fileManager.ensureDirectory(clineRulesDir);
 
-${agents.map((id) => `- **bmad-${id}** - ${this.getAgentTitle(id)}`).join("\n")}
+    // Load dynamic agent ordering from configuration
+    const config = await this.loadIdeAgentConfig();
+    const agentOrder = config['cline-order'] || {};
 
-## Usage
+    for (const agentId of agents) {
+      // Find the agent file
+      const agentPath = await this.findAgentPath(agentId, installDir);
+
+      if (agentPath) {
+        const agentContent = await fileManager.readFile(agentPath);
+
+        // 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).replaceAll('\\', '/');
+        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`));
+      }
+    }
 
-## File Permissions
+    console.log(chalk.green(`\n✓ Created Cline rules in ${clineRulesDir}`));
+
+    return true;
+  }
+
+  async setupGeminiCli(installDir) {
+    const geminiDir = path.join(installDir, '.gemini');
+    const bmadMethodDir = path.join(geminiDir, 'bmad-method');
+    await fileManager.ensureDirectory(bmadMethodDir);
+
+    // Update logic for existing settings.json
+    const settingsPath = path.join(geminiDir, 'settings.json');
+    if (await fileManager.pathExists(settingsPath)) {
+      try {
+        const settingsContent = await fileManager.readFile(settingsPath);
+        const settings = JSON.parse(settingsContent);
+        let updated = false;
+
+        // Handle contextFileName property
+        if (settings.contextFileName && Array.isArray(settings.contextFileName)) {
+          const originalLength = settings.contextFileName.length;
+          settings.contextFileName = settings.contextFileName.filter(
+            (fileName) => !fileName.startsWith('agents/'),
+          );
+          if (settings.contextFileName.length !== originalLength) {
+            updated = true;
+          }
+        }
+
+        if (updated) {
+          await fileManager.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+          console.log(
+            chalk.green('✓ Updated .gemini/settings.json - removed agent file references'),
+          );
+        }
+      } catch (error) {
+        console.warn(chalk.yellow('Could not update .gemini/settings.json'), error);
+      }
+    }
+
+    // Remove old agents directory
+    const agentsDir = path.join(geminiDir, 'agents');
+    if (await fileManager.pathExists(agentsDir)) {
+      await fileManager.removeDirectory(agentsDir);
+      console.log(chalk.green('✓ Removed old .gemini/agents directory'));
+    }
+
+    // Get all available agents
+    const agents = await this.getAllAgentIds(installDir);
+    let concatenatedContent = '';
+
+    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);
+
+        // Create properly formatted agent rule content (similar to trae)
+        let agentRuleContent = `# ${agentId.toUpperCase()} Agent Rule\n\n`;
+        agentRuleContent += `This rule is triggered when the user types \`*${agentId}\` and activates the ${await this.getAgentTitle(
+          agentId,
+          installDir,
+        )} agent persona.\n\n`;
+        agentRuleContent += '## Agent Activation\n\n';
+        agentRuleContent +=
+          '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';
+        agentRuleContent += '```yaml\n';
+        // Extract just the YAML content from the agent file
+        const yamlContent = extractYamlFromAgent(agentContent);
+        if (yamlContent) {
+          agentRuleContent += yamlContent;
+        } else {
+          // If no YAML found, include the whole content minus the header
+          agentRuleContent += agentContent.replace(/^#.*$/m, '').trim();
+        }
+        agentRuleContent += '\n```\n\n';
+        agentRuleContent += '## File Reference\n\n';
+        const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');
+        agentRuleContent += `The complete agent definition is available in [${relativePath}](${relativePath}).\n\n`;
+        agentRuleContent += '## Usage\n\n';
+        agentRuleContent += `When the user types \`*${agentId}\`, activate this ${await this.getAgentTitle(
+          agentId,
+          installDir,
+        )} persona and follow all instructions defined in the YAML configuration above.\n`;
+
+        // Add to concatenated content with separator
+        concatenatedContent += agentRuleContent + '\n\n---\n\n';
+        console.log(chalk.green(`✓ Added context for @${agentId}`));
+      }
+    }
+
+    // Write the concatenated content to GEMINI.md
+    const geminiMdPath = path.join(bmadMethodDir, 'GEMINI.md');
+    await fileManager.writeFile(geminiMdPath, concatenatedContent);
+    console.log(chalk.green(`\n✓ Created GEMINI.md in ${bmadMethodDir}`));
+
+    return true;
+  }
+
+  async setupQwenCode(installDir, selectedAgent) {
+    const qwenDir = path.join(installDir, '.qwen');
+    const bmadMethodDir = path.join(qwenDir, 'bmad-method');
+    await fileManager.ensureDirectory(bmadMethodDir);
+
+    // Update logic for existing settings.json
+    const settingsPath = path.join(qwenDir, 'settings.json');
+    if (await fileManager.pathExists(settingsPath)) {
+      try {
+        const settingsContent = await fileManager.readFile(settingsPath);
+        const settings = JSON.parse(settingsContent);
+        let updated = false;
+
+        // Handle contextFileName property
+        if (settings.contextFileName && Array.isArray(settings.contextFileName)) {
+          const originalLength = settings.contextFileName.length;
+          settings.contextFileName = settings.contextFileName.filter(
+            (fileName) => !fileName.startsWith('agents/'),
+          );
+          if (settings.contextFileName.length !== originalLength) {
+            updated = true;
+          }
+        }
+
+        if (updated) {
+          await fileManager.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+          console.log(chalk.green('✓ Updated .qwen/settings.json - removed agent file references'));
+        }
+      } catch (error) {
+        console.warn(chalk.yellow('Could not update .qwen/settings.json'), error);
+      }
+    }
+
+    // Remove old agents directory
+    const agentsDir = path.join(qwenDir, 'agents');
+    if (await fileManager.pathExists(agentsDir)) {
+      await fileManager.removeDirectory(agentsDir);
+      console.log(chalk.green('✓ Removed old .qwen/agents directory'));
+    }
+
+    // Get all available agents
+    const agents = selectedAgent ? [selectedAgent] : await this.getAllAgentIds(installDir);
+    let concatenatedContent = '';
+
+    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);
+
+        // Create properly formatted agent rule content (similar to gemini)
+        let agentRuleContent = `# ${agentId.toUpperCase()} Agent Rule\n\n`;
+        agentRuleContent += `This rule is triggered when the user types \`*${agentId}\` and activates the ${await this.getAgentTitle(
+          agentId,
+          installDir,
+        )} agent persona.\n\n`;
+        agentRuleContent += '## Agent Activation\n\n';
+        agentRuleContent +=
+          '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';
+        agentRuleContent += '```yaml\n';
+        // Extract just the YAML content from the agent file
+        const yamlContent = extractYamlFromAgent(agentContent);
+        if (yamlContent) {
+          agentRuleContent += yamlContent;
+        } else {
+          // If no YAML found, include the whole content minus the header
+          agentRuleContent += agentContent.replace(/^#.*$/m, '').trim();
+        }
+        agentRuleContent += '\n```\n\n';
+        agentRuleContent += '## File Reference\n\n';
+        const relativePath = path.relative(installDir, agentPath).replaceAll('\\', '/');
+        agentRuleContent += `The complete agent definition is available in [${relativePath}](${relativePath}).\n\n`;
+        agentRuleContent += '## Usage\n\n';
+        agentRuleContent += `When the user types \`*${agentId}\`, activate this ${await this.getAgentTitle(
+          agentId,
+          installDir,
+        )} persona and follow all instructions defined in the YAML configuration above.\n`;
+
+        // Add to concatenated content with separator
+        concatenatedContent += agentRuleContent + '\n\n---\n\n';
+        console.log(chalk.green(`✓ Added context for *${agentId}`));
+      }
+    }
+
+    // Write the concatenated content to QWEN.md
+    const qwenMdPath = path.join(bmadMethodDir, 'QWEN.md');
+    await fileManager.writeFile(qwenMdPath, concatenatedContent);
+    console.log(chalk.green(`\n✓ Created QWEN.md in ${bmadMethodDir}`));
+
+    return true;
+  }
+
+  async setupGitHubCopilot(
+    installDir,
+    selectedAgent,
+    spinner = null,
+    preConfiguredSettings = null,
+  ) {
+    // 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\r?\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.replaceAll('"', String.raw`\"`)}"
+tools: ['changes', 'codebase', 'fetch', 'findTestFiles', 'githubRepo', 'problems', 'usages', 'editFiles', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure']
+---
 
-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;
 
-    const readmePath = path.join(rooDir, "README.md");
-    await fileManager.writeFile(readmePath, rooReadme);
-    console.log(chalk.green("✓ Created .roo/README.md"));
+        await fileManager.writeFile(chatmodePath, chatmodeContent);
+        console.log(chalk.green(`✓ Created chat mode: ${agentId}.chatmode.md`));
+      }
+    }
 
-    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"
-      )
-    );
+    console.log(chalk.green(`\n✓ Github Copilot setup complete!`));
+    console.log(chalk.dim(`You can now find the BMad agents in the Chat view's mode selector.`));
 
     return true;
   }
+
+  async configureVsCodeSettings(installDir, spinner, preConfiguredSettings = null) {
+    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 {
+        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 number_ = Number.parseInt(input);
+            if (isNaN(number_) || number_ < 1 || number_ > 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': Number.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:'));
+    for (const [key, value] of Object.entries(bmadSettings)) {
+      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();