bmad-method 5.0.0 → 5.1.0

package/tools/installer/config/ide-agent-config.yaml

@@ -0,0 +1,58 @@
+# IDE-specific agent configurations
+# This file defines agent-specific settings for different IDEs
+
+# Roo Code file permissions
+# Each agent can have restricted file access based on regex patterns
+# If an agent is not listed here, it gets full edit access
+roo-permissions:
+  # Core agents
+  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"
+  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"
+  # Expansion pack agents
+  game-designer:
+    fileRegex: "\\.(md|txt|json|yaml|yml)$"
+    description: "Game design documents and configs"
+  game-sm:
+    fileRegex: "\\.(md|txt)$"
+    description: "Game project management docs"
+
+# Cline agent ordering
+# Lower numbers appear first in the list
+# Agents not listed get order 99
+cline-order:
+  # Core agents
+  bmad-master: 1
+  bmad-orchestrator: 2
+  pm: 3
+  analyst: 4
+  architect: 5
+  po: 6
+  sm: 7
+  dev: 8
+  qa: 9
+  ux-expert: 10
+  # Expansion pack agents
+  bmad-the-creator: 11
+  game-designer: 12
+  game-developer: 13
+  game-sm: 14
+  infra-devops-platform: 15

package/tools/installer/config/install.config.yaml

@@ -0,0 +1,123 @@
+installation-options:
+  full:
+    name: Complete BMad Core
+    description: Copy the entire .bmad-core folder with all agents, templates, and tools
+    action: copy-folder
+    source: bmad-core
+  single-agent:
+    name: Single Agent
+    description: Select and install a single agent with its dependencies
+    action: copy-agent
+ide-configurations:
+  cursor:
+    name: Cursor
+    rule-dir: .cursor/rules/bmad/
+    format: multi-file
+    command-suffix: .mdc
+    instructions: |
+      # To use BMad agents in Cursor:
+      # 1. Press Ctrl+L (Cmd+L on Mac) to open the chat
+      # 2. Type @agent-name (e.g., "@dev", "@pm", "@architect")
+      # 3. The agent will adopt that persona for the conversation
+  claude-code:
+    name: Claude Code
+    rule-dir: .claude/commands/BMad/
+    format: multi-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents in Claude Code:
+      # 1. Type /agent-name (e.g., "/dev", "/pm", "/architect")
+      # 2. Claude will switch to that agent's persona
+  crush:
+    name: Crush
+    rule-dir: .crush/commands/BMad/
+    format: multi-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents in Crush:
+      # 1. Press CTRL + P and press TAB
+      # 2. Select agent or task
+      # 3. Crush will switch to that agent's persona / task
+  windsurf:
+    name: Windsurf
+    rule-dir: .windsurf/workflows/
+    format: multi-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents in Windsurf:
+      # 1. Type /agent-name (e.g., "/dev", "/pm")
+      # 2. Windsurf will adopt that agent's persona
+  trae:
+    name: Trae
+    rule-dir: .trae/rules/
+    format: multi-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents in Trae:
+      # 1. Type @agent-name (e.g., "@dev", "@pm", "@architect")
+      # 2. Trae will adopt that agent's persona
+  roo:
+    name: Roo Code
+    format: custom-modes
+    file: .roomodes
+    instructions: |
+      # To use BMad agents in Roo Code:
+      # 1. Open the mode selector (usually in the status bar)
+      # 2. Select any bmad-{agent} mode (e.g., "bmad-dev", "bmad-pm")
+      # 3. The AI will adopt that agent's full personality and capabilities
+  cline:
+    name: Cline
+    rule-dir: .clinerules/
+    format: multi-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents in Cline:
+      # 1. Open the Cline chat panel in VS Code
+      # 2. Type @agent-name (e.g., "@dev", "@pm", "@architect")
+      # 3. The agent will adopt that persona for the conversation
+      # 4. Rules are stored in .clinerules/ directory in your project
+  gemini:
+    name: Gemini CLI
+    rule-dir: .gemini/bmad-method/
+    format: single-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents with the Gemini CLI:
+      # 1. The installer creates a .gemini/bmad-method/ directory in your project.
+      # 2. It concatenates all agent files into a single GEMINI.md file.
+      # 3. Simply mention the agent in your prompt (e.g., "As *dev, ...").
+      # 4. The Gemini CLI will automatically have the context for that agent.
+  github-copilot:
+    name: Github Copilot
+    rule-dir: .github/chatmodes/
+    format: multi-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents with Github Copilot:
+      # 1. The installer creates a .github/chatmodes/ directory in your project
+      # 2. Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
+      # 3. The agent will adopt that persona for the conversation
+      # 4. Requires VS Code 1.101+ with `chat.agent.enabled: true` in settings
+      # 5. Agent files are stored in .github/chatmodes/
+      # 6. Use `*help` to see available commands and agents
+  kilo:
+    name: Kilo Code
+    format: custom-modes
+    file: .kilocodemodes
+    instructions: |
+      # To use BMAD agents in Kilo Code:
+      # 1. Open the mode selector in VSCode
+      # 2. Select a bmad-{agent} mode (e.g. "bmad-dev")
+      # 3. The AI adopts that agent's persona and capabilities
+
+  qwen-code:
+    name: Qwen Code
+    rule-dir: .qwen/bmad-method/
+    format: single-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents with Qwen Code:
+      # 1. The installer creates a .qwen/bmad-method/ directory in your project.
+      # 2. It concatenates all agent files into a single QWEN.md file.
+      # 3. Simply mention the agent in your prompt (e.g., "As *dev, ...").
+      # 4. The Qwen Code CLI will automatically have the context for that agent.

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

@@ -1,16 +1,17 @@
 const fs = require('fs-extra');
-const path = require('path');
+const path = require('node:path');
 const yaml = require('js-yaml');
+const { extractYamlFromAgent } = require('../../lib/yaml-utils');
 
 class ConfigLoader {
   constructor() {
-    this.configPath = path.join(__dirname, '..', 'config', 'install.config.yml');
+    this.configPath = path.join(__dirname, '..', 'config', 'install.config.yaml');
     this.config = null;
   }
 
   async load() {
     if (this.config) return this.config;
-    
+
     try {
       const configContent = await fs.readFile(this.configPath, 'utf8');
       this.config = yaml.load(configContent);
@@ -26,48 +27,134 @@ 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 yamlContentText = extractYamlFromAgent(agentContent);
+            if (yamlContentText) {
+              const yamlContent = yaml.load(yamlContentText);
+              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() {
+    const expansionPacksDir = path.join(this.getBmadCorePath(), '..', 'expansion-packs');
+
+    try {
+      const entries = await fs.readdir(expansionPacksDir, { withFileTypes: true });
+      const expansionPacks = [];
+
+      for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith('.')) {
+          const packPath = path.join(expansionPacksDir, entry.name);
+          const configPath = path.join(packPath, 'config.yaml');
+
+          try {
+            // Read config.yaml
+            const configContent = await fs.readFile(configPath, 'utf8');
+            const config = yaml.load(configContent);
+
+            expansionPacks.push({
+              id: entry.name,
+              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) {
+            // Fallback if config.yaml 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: [],
+            });
+          }
+        }
+      }
+
+      return expansionPacks;
+    } catch (error) {
+      console.warn(`Failed to read expansion packs directory: ${error.message}`);
+      return [];
+    }
   }
 
   async getAgentDependencies(agentId) {
     // Use DependencyResolver to dynamically parse agent dependencies
     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 = [];
-      
-      // Add core files
-      const config = await this.load();
-      const coreFiles = config['agent-dependencies']?.['core-files'] || [];
-      depPaths.push(...coreFiles);
-      
-      // 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) {
@@ -77,13 +164,94 @@ class ConfigLoader {
   }
 
   getBmadCorePath() {
-    // Get the path to .bmad-core relative to the installer (now under tools)
-    return path.join(__dirname, '..', '..', '..', '.bmad-core');
+    // Get the path to bmad-core relative to the installer (now under tools)
+    return path.join(__dirname, '..', '..', '..', 'bmad-core');
+  }
+
+  getDistPath() {
+    // Get the path to dist directory relative to the installer
+    return path.join(__dirname, '..', '..', '..', 'dist');
   }
 
   getAgentPath(agentId) {
     return path.join(this.getBmadCorePath(), 'agents', `${agentId}.md`);
   }
+
+  async getAvailableTeams() {
+    const teamsDir = path.join(this.getBmadCorePath(), 'agent-teams');
+
+    try {
+      const entries = await fs.readdir(teamsDir, { withFileTypes: true });
+      const teams = [];
+
+      for (const entry of entries) {
+        if (entry.isFile() && entry.name.endsWith('.yaml')) {
+          const teamPath = path.join(teamsDir, entry.name);
+
+          try {
+            const teamContent = await fs.readFile(teamPath, 'utf8');
+            const teamConfig = yaml.load(teamContent);
+
+            if (teamConfig.bundle) {
+              teams.push({
+                id: path.basename(entry.name, '.yaml'),
+                name: teamConfig.bundle.name || entry.name,
+                description: teamConfig.bundle.description || 'Team configuration',
+                icon: teamConfig.bundle.icon || '📋',
+              });
+            }
+          } catch (error) {
+            console.warn(`Warning: Could not load team config ${entry.name}: ${error.message}`);
+          }
+        }
+      }
+
+      return teams;
+    } catch (error) {
+      console.warn(`Warning: Could not scan teams directory: ${error.message}`);
+      return [];
+    }
+  }
+
+  getTeamPath(teamId) {
+    return path.join(this.getBmadCorePath(), 'agent-teams', `${teamId}.yaml`);
+  }
+
+  async getTeamDependencies(teamId) {
+    // Use DependencyResolver to dynamically parse team dependencies
+    const DependencyResolver = require('../../lib/dependency-resolver');
+    const resolver = new DependencyResolver(path.join(__dirname, '..', '..', '..'));
+
+    try {
+      const teamDeps = await resolver.resolveTeamDependencies(teamId);
+
+      // Convert to flat list of file paths
+      const depPaths = [];
+
+      // Add team config file
+      depPaths.push(`.bmad-core/agent-teams/${teamId}.yaml`);
+
+      // Add all agents
+      for (const agent of teamDeps.agents) {
+        const filePath = `.bmad-core/agents/${agent.id}.md`;
+        if (!depPaths.includes(filePath)) {
+          depPaths.push(filePath);
+        }
+      }
+
+      // Add all resolved resources
+      for (const resource of teamDeps.resources) {
+        const filePath = `.bmad-core/${resource.type}/${resource.id}.${resource.type === 'workflows' ? 'yaml' : 'md'}`;
+        if (!depPaths.includes(filePath)) {
+          depPaths.push(filePath);
+        }
+      }
+
+      return depPaths;
+    } catch (error) {
+      throw new Error(`Failed to resolve team dependencies for ${teamId}: ${error.message}`);
+    }
+  }
 }
 
-module.exports = new ConfigLoader();
+module.exports = new ConfigLoader();