bmad-method 4.17.0 → 4.19.0

package/tools/installer/config/install.config.yml

@@ -8,50 +8,6 @@ installation-options:
     name: Single Agent
     description: Select and install a single agent with its dependencies
     action: copy-agent
-agent-dependencies:
-  core-files:
-    - bmad-core/utils/template-format.md
-  dev:
-    - bmad-core/templates/story-tmpl.md
-    - bmad-core/checklists/story-dod-checklist.md
-  pm:
-    - bmad-core/templates/prd-tmpl.md
-    - bmad-core/templates/brownfield-prd-tmpl.md
-    - bmad-core/checklists/pm-checklist.md
-    - bmad-core/checklists/change-checklist.md
-    - bmad-core/tasks/advanced-elicitation.md
-    - bmad-core/tasks/create-doc.md
-    - bmad-core/tasks/correct-course.md
-    - bmad-core/tasks/create-deep-research-prompt.md
-    - bmad-core/tasks/brownfield-create-epic.md
-    - bmad-core/tasks/brownfield-create-story.md
-    - bmad-core/tasks/execute-checklist.md
-    - bmad-core/tasks/shard-doc.md
-  architect:
-    - bmad-core/templates/architecture-tmpl.md
-    - bmad-core/checklists/architect-checklist.md
-  sm:
-    - bmad-core/templates/story-tmpl.md
-    - bmad-core/checklists/story-draft-checklist.md
-    - bmad-core/workflows/*.yml
-  po:
-    - bmad-core/checklists/po-master-checklist.md
-    - bmad-core/templates/acceptance-criteria-tmpl.md
-  analyst:
-    - bmad-core/templates/prd-tmpl.md
-    - bmad-core/tasks/advanced-elicitation.md
-  qa:
-    - bmad-core/checklists/story-dod-checklist.md
-    - bmad-core/templates/test-plan-tmpl.md
-  ux-expert:
-    - bmad-core/templates/ux-tmpl.md
-  bmad-master:
-    - bmad-core/templates/*.md
-    - bmad-core/tasks/*.md
-    - bmad-core/schemas/*.yml
-  bmad-orchestrator:
-    - bmad-core/agent-teams/*.yml
-    - bmad-core/workflows/*.yml
 ide-configurations:
   cursor:
     name: Cursor
@@ -111,44 +67,3 @@ ide-configurations:
       # 2. It also configures .gemini/settings.json to load all agent files.
       # 3. Simply mention the agent in your prompt (e.g., "As @dev, ...").
       # 4. The Gemini CLI will automatically have the context for that agent.
-available-agents:
-  - id: analyst
-    name: Business Analyst
-    file: bmad-core/agents/analyst.md
-    description: Requirements gathering and analysis
-  - id: pm
-    name: Product Manager
-    file: bmad-core/agents/pm.md
-    description: Product strategy and roadmap planning
-  - id: architect
-    name: Solution Architect
-    file: bmad-core/agents/architect.md
-    description: Technical design and architecture
-  - id: po
-    name: Product Owner
-    file: bmad-core/agents/po.md
-    description: Backlog management and prioritization
-  - id: sm
-    name: Scrum Master
-    file: bmad-core/agents/sm.md
-    description: Agile process and story creation
-  - id: dev
-    name: Developer
-    file: bmad-core/agents/dev.md
-    description: Code implementation and testing
-  - id: qa
-    name: QA Engineer
-    file: bmad-core/agents/qa.md
-    description: Quality assurance and testing
-  - id: ux-expert
-    name: UX Expert
-    file: bmad-core/agents/ux-expert.md
-    description: User experience design
-  - id: bmad-master
-    name: BMAD Master
-    file: bmad-core/agents/bmad-master.md
-    description: BMAD framework expert and guide
-  - id: bmad-orchestrator
-    name: BMAD Orchestrator
-    file: bmad-core/agents/bmad-orchestrator.md
-    description: Multi-agent workflow coordinator

package/tools/installer/lib/config-loader.js

@@ -26,8 +26,47 @@ class ConfigLoader {
   }
 
   async getAvailableAgents() {
-    const config = await this.load();
-    return config['available-agents'] || [];
+    const agentsDir = path.join(this.getBmadCorePath(), 'agents');
+    
+    try {
+      const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+      const agents = [];
+      
+      for (const entry of entries) {
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+          const agentPath = path.join(agentsDir, entry.name);
+          const agentId = path.basename(entry.name, '.md');
+          
+          try {
+            const agentContent = await fs.readFile(agentPath, 'utf8');
+            
+            // Extract YAML block from agent file
+            const yamlMatch = agentContent.match(/```yml\n([\s\S]*?)\n```/);
+            if (yamlMatch) {
+              const yamlContent = yaml.load(yamlMatch[1]);
+              const agentConfig = yamlContent.agent || {};
+              
+              agents.push({
+                id: agentId,
+                name: agentConfig.title || agentConfig.name || agentId,
+                file: `bmad-core/agents/${entry.name}`,
+                description: agentConfig.whenToUse || 'No description available'
+              });
+            }
+          } catch (error) {
+            console.warn(`Failed to read agent ${entry.name}: ${error.message}`);
+          }
+        }
+      }
+      
+      // Sort agents by name for consistent display
+      agents.sort((a, b) => a.name.localeCompare(b.name));
+      
+      return agents;
+    } catch (error) {
+      console.warn(`Failed to read agents directory: ${error.message}`);
+      return [];
+    }
   }
 
   async getAvailableExpansionPacks() {
@@ -38,24 +77,45 @@ class ConfigLoader {
       const expansionPacks = [];
       
       for (const entry of entries) {
-        if (entry.isDirectory()) {
-          const manifestPath = path.join(expansionPacksDir, entry.name, 'manifest.yml');
+        if (entry.isDirectory() && !entry.name.startsWith('.')) {
+          const packPath = path.join(expansionPacksDir, entry.name);
+          const configPath = path.join(packPath, 'config.yml');
           
           try {
-            const manifestContent = await fs.readFile(manifestPath, 'utf8');
-            const manifest = yaml.load(manifestContent);
+            // Read config.yml
+            const configContent = await fs.readFile(configPath, 'utf8');
+            const config = yaml.load(configContent);
             
             expansionPacks.push({
               id: entry.name,
-              name: manifest.name || entry.name,
-              description: manifest.description || 'No description available',
-              version: manifest.version || '1.0.0',
-              author: manifest.author || 'Unknown',
-              manifestPath: manifestPath,
-              dependencies: manifest.dependencies || []
+              name: config.name || entry.name,
+              description: config['short-title'] || config.description || 'No description available',
+              fullDescription: config.description || config['short-title'] || 'No description available',
+              version: config.version || '1.0.0',
+              author: config.author || 'BMAD Team',
+              packPath: packPath,
+              dependencies: config.dependencies?.agents || []
             });
           } catch (error) {
-            console.warn(`Failed to read manifest for expansion pack ${entry.name}: ${error.message}`);
+            // Fallback if config.yml doesn't exist or can't be read
+            console.warn(`Failed to read config for expansion pack ${entry.name}: ${error.message}`);
+            
+            // Try to derive info from directory name as fallback
+            const name = entry.name
+              .split('-')
+              .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+              .join(' ');
+            
+            expansionPacks.push({
+              id: entry.name,
+              name: name,
+              description: 'No description available',
+              fullDescription: 'No description available',
+              version: '1.0.0',
+              author: 'BMAD Team',
+              packPath: packPath,
+              dependencies: []
+            });
           }
         }
       }
@@ -72,36 +132,24 @@ class ConfigLoader {
     const DependencyResolver = require('../../lib/dependency-resolver');
     const resolver = new DependencyResolver(path.join(__dirname, '..', '..', '..'));
     
-    try {
-      const agentDeps = await resolver.resolveAgentDependencies(agentId);
-      
-      // Convert to flat list of file paths
-      const depPaths = [];
-      
-      // Core files and utilities are included automatically by DependencyResolver
-      
-      // Add agent file itself is already handled by installer
-      
-      // Add all resolved resources
-      for (const resource of agentDeps.resources) {
-        const filePath = `.bmad-core/${resource.type}/${resource.id}.md`;
-        if (!depPaths.includes(filePath)) {
-          depPaths.push(filePath);
-        }
+    const agentDeps = await resolver.resolveAgentDependencies(agentId);
+    
+    // Convert to flat list of file paths
+    const depPaths = [];
+    
+    // Core files and utilities are included automatically by DependencyResolver
+    
+    // Add agent file itself is already handled by installer
+    
+    // Add all resolved resources
+    for (const resource of agentDeps.resources) {
+      const filePath = `.bmad-core/${resource.type}/${resource.id}.md`;
+      if (!depPaths.includes(filePath)) {
+        depPaths.push(filePath);
       }
-      
-      return depPaths;
-    } catch (error) {
-      console.warn(`Failed to dynamically resolve dependencies for ${agentId}: ${error.message}`);
-      
-      // Fall back to static config
-      const config = await this.load();
-      const dependencies = config['agent-dependencies'] || {};
-      const coreFiles = dependencies['core-files'] || [];
-      const agentDeps = dependencies[agentId] || [];
-      
-      return [...coreFiles, ...agentDeps];
     }
+    
+    return depPaths;
   }
 
   async getIdeConfiguration(ide) {

package/tools/installer/lib/file-manager.js

@@ -90,6 +90,7 @@ class FileManager {
       agent: config.agent || null,
       ide_setup: config.ide || null,
       ides_setup: config.ides || [],
+      expansion_packs: config.expansionPacks || [],
       files: [],
     };
 

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

@@ -1,4 +1,6 @@
 const path = require("path");
+const fs = require("fs-extra");
+const yaml = require("js-yaml");
 const fileManager = require("./file-manager");
 const configLoader = require("./config-loader");
 
@@ -13,6 +15,27 @@ async function initializeModules() {
 }
 
 class IdeSetup {
+  constructor() {
+    this.ideAgentConfig = null;
+  }
+
+  async loadIdeAgentConfig() {
+    if (this.ideAgentConfig) return this.ideAgentConfig;
+    
+    try {
+      const configPath = path.join(__dirname, '..', 'config', 'ide-agent-config.yml');
+      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) {
     await initializeModules();
     const ideConfig = await configLoader.getIdeConfiguration(ide);
@@ -48,13 +71,10 @@ class IdeSetup {
     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`);
-      }
+      // Find the agent file
+      const agentPath = await this.findAgentPath(agentId, installDir);
 
-      if (await fileManager.pathExists(agentPath)) {
+      if (agentPath) {
         const agentContent = await fileManager.readFile(agentPath);
         const mdcPath = path.join(cursorRulesDir, `${agentId}.mdc`);
 
@@ -65,8 +85,9 @@ 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 ${this.getAgentTitle(
-          agentId
+        mdcContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${await this.getAgentTitle(
+          agentId,
+          installDir
         )} agent persona.\n\n`;
         mdcContent += "## Agent Activation\n\n";
         mdcContent +=
@@ -82,10 +103,12 @@ class IdeSetup {
         }
         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`;
+        const relativePath = path.relative(installDir, agentPath).replace(/\\/g, '/');
+        mdcContent += `The complete agent definition is available in [${relativePath}](mdc:${relativePath}).\n\n`;
         mdcContent += "## Usage\n\n";
-        mdcContent += `When the user types \`@${agentId}\`, activate this ${this.getAgentTitle(
-          agentId
+        mdcContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
+          agentId,
+          installDir
         )} persona and follow all instructions defined in the YML configuration above.\n`;
 
         await fileManager.writeFile(mdcPath, mdcContent);
@@ -105,14 +128,11 @@ class IdeSetup {
     await fileManager.ensureDirectory(commandsDir);
 
     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);
       const commandPath = path.join(commandsDir, `${agentId}.md`);
 
-      if (await fileManager.pathExists(agentPath)) {
+      if (agentPath) {
         // Create command file with agent content
         const agentContent = await fileManager.readFile(agentPath);
 
@@ -138,20 +158,18 @@ class IdeSetup {
     await fileManager.ensureDirectory(windsurfRulesDir);
 
     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 (await fileManager.pathExists(agentPath)) {
+      if (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 ${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 +=
@@ -167,10 +185,12 @@ class IdeSetup {
         }
         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`;
+        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 ${this.getAgentTitle(
-          agentId
+        mdContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
+          agentId,
+          installDir
         )} persona and follow all instructions defined in the YML configuration above.\n`;
 
         await fileManager.writeFile(mdPath, mdContent);
@@ -183,32 +203,93 @@ class IdeSetup {
     return true;
   }
 
+  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) {
-    // Check if .bmad-core is a subdirectory (full install) or if agents are in root (single agent install)
+    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");
     }
-
-    const glob = require("glob");
-    const agentFiles = glob.sync("*.md", { cwd: agentsDir });
-    return agentFiles.map((file) => path.basename(file, ".md"));
+    
+    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)];
   }
 
-  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 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(' ');
   }
 
   async setupRoo(installDir, selectedAgent) {
@@ -232,40 +313,9 @@ class IdeSetup {
     // 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
-    };
+    // 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
@@ -275,12 +325,9 @@ class IdeSetup {
       }
 
       // 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
@@ -294,7 +341,7 @@ class IdeSetup {
           const whenToUseMatch = yaml.match(/whenToUse:\s*"(.+)"/);
           const roleDefinitionMatch = yaml.match(/roleDefinition:\s*"(.+)"/);
 
-          const title = titleMatch ? titleMatch[1].trim() : this.getAgentTitle(agentId);
+          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
@@ -306,7 +353,9 @@ class IdeSetup {
           newModesContent += `   name: '${icon} ${title}'\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).replace(/\\/g, '/');
+          newModesContent += `   customInstructions: CRITICAL Read the full YML 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`;
 
@@ -351,28 +400,15 @@ class IdeSetup {
 
     await fileManager.ensureDirectory(clineRulesDir);
 
-    // Define agent order for numeric prefixes
-    const agentOrder = {
-      'bmad-master': 1,
-      'bmad-orchestrator': 2,
-      'pm': 3,
-      'analyst': 4,
-      'architect': 5,
-      'po': 6,
-      'sm': 7,
-      'dev': 8,
-      'qa': 9,
-      'ux-expert': 10
-    };
+    // Load dynamic agent ordering from configuration
+    const config = await this.loadIdeAgentConfig();
+    const agentOrder = config['cline-order'] || {};
 
     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 (await fileManager.pathExists(agentPath)) {
+      if (agentPath) {
         const agentContent = await fileManager.readFile(agentPath);
 
         // Get numeric prefix for ordering
@@ -381,8 +417,8 @@ class IdeSetup {
         const mdPath = path.join(clineRulesDir, `${prefix}-${agentId}.md`);
 
         // Create MD content for Cline (focused on project standards and role)
-        let mdContent = `# ${this.getAgentTitle(agentId)} Agent\n\n`;
-        mdContent += `This rule defines the ${this.getAgentTitle(agentId)} persona and project standards.\n\n`;
+        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";
@@ -400,9 +436,10 @@ class IdeSetup {
         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`;
-        mdContent += `- Reference the complete agent definition in [.bmad-core/agents/${agentId}.md](.bmad-core/agents/${agentId}.md)\n\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 ${this.getAgentTitle(agentId)} persona.\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`));
@@ -426,12 +463,9 @@ class IdeSetup {
 
     for (const agentId of agents) {
       // Find the source agent file
-      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);
         const contextFilePath = path.join(agentsContextDir, `${agentId}.md`);