bmad-method 6.0.0-alpha.7 → 6.0.0-alpha.9

package/tools/cli/installers/lib/ide/_base-ide.js

@@ -18,6 +18,31 @@ class BaseIdeSetup {
     this.configFile = null; // Override in subclasses when detection is file-based
     this.detectionPaths = []; // Additional paths that indicate the IDE is configured
     this.xmlHandler = new XmlHandler();
+    this.bmadFolderName = 'bmad'; // Default, can be overridden
+  }
+
+  /**
+   * Set the bmad folder name for placeholder replacement
+   * @param {string} bmadFolderName - The bmad folder name
+   */
+  setBmadFolderName(bmadFolderName) {
+    this.bmadFolderName = bmadFolderName;
+  }
+
+  /**
+   * Get the agent command activation header from the central template
+   * @returns {string} The activation header text (without XML tags)
+   */
+  async getAgentCommandHeader() {
+    const headerPath = path.join(getSourcePath(), 'src', 'utility', 'models', 'agent-command-header.md');
+    try {
+      const content = await fs.readFile(headerPath, 'utf8');
+      // Strip the <critical> tags to get plain text
+      return content.replaceAll(/<critical>|<\/critical>/g, '').trim();
+    } catch {
+      // Fallback if file doesn't exist
+      return "You must fully embody this agent's persona and follow all activation instructions, steps and rules exactly as specified. NEVER break character until given an exit command.";
+    }
   }
 
   /**
@@ -489,23 +514,52 @@ class BaseIdeSetup {
   }
 
   /**
-   * Write file with content
+   * Write file with content (replaces {bmad_folder} placeholder)
    * @param {string} filePath - File path
    * @param {string} content - File content
    */
   async writeFile(filePath, content) {
+    // Replace {bmad_folder} placeholder if present
+    if (typeof content === 'string' && content.includes('{bmad_folder}')) {
+      content = content.replaceAll('{bmad_folder}', this.bmadFolderName);
+    }
     await this.ensureDir(path.dirname(filePath));
     await fs.writeFile(filePath, content, 'utf8');
   }
 
   /**
-   * Copy file from source to destination
+   * Copy file from source to destination (replaces {bmad_folder} placeholder in text files)
    * @param {string} source - Source file path
    * @param {string} dest - Destination file path
    */
   async copyFile(source, dest) {
+    // List of text file extensions that should have placeholder replacement
+    const textExtensions = ['.md', '.yaml', '.yml', '.txt', '.json', '.js', '.ts', '.html', '.css', '.sh', '.bat', '.csv'];
+    const ext = path.extname(source).toLowerCase();
+
     await this.ensureDir(path.dirname(dest));
-    await fs.copy(source, dest, { overwrite: true });
+
+    // Check if this is a text file that might contain placeholders
+    if (textExtensions.includes(ext)) {
+      try {
+        // Read the file content
+        let content = await fs.readFile(source, 'utf8');
+
+        // Replace {bmad_folder} placeholder with actual folder name
+        if (content.includes('{bmad_folder}')) {
+          content = content.replaceAll('{bmad_folder}', this.bmadFolderName);
+        }
+
+        // Write to dest with replaced content
+        await fs.writeFile(dest, content, 'utf8');
+      } catch {
+        // If reading as text fails, fall back to regular copy
+        await fs.copy(source, dest, { overwrite: true });
+      }
+    } else {
+      // Binary file or other file type - just copy directly
+      await fs.copy(source, dest, { overwrite: true });
+    }
   }
 
   /**

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

@@ -1,70 +1,18 @@
 const path = require('node:path');
-const os = require('node:os');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
-const inquirer = require('inquirer');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * Auggie CLI setup handler
- * Allows flexible installation of agents to multiple locations
+ * Installs to project directory (.augment/commands)
  */
 class AuggieSetup extends BaseIdeSetup {
   constructor() {
     super('auggie', 'Auggie CLI');
-    this.defaultLocations = [
-      { name: 'Project Directory (.augment/commands)', value: '.augment/commands', checked: true },
-      { name: 'User Home (~/.augment/commands)', value: path.join(os.homedir(), '.augment', 'commands') },
-      { name: 'Custom Location', value: 'custom' },
-    ];
     this.detectionPaths = ['.augment'];
   }
 
-  /**
-   * Collect configuration choices before installation
-   * @param {Object} options - Configuration options
-   * @returns {Object} Collected configuration
-   */
-  async collectConfiguration(options = {}) {
-    const response = await inquirer.prompt([
-      {
-        type: 'checkbox',
-        name: 'locations',
-        message: 'Select Auggie CLI installation locations:',
-        choices: this.defaultLocations,
-        validate: (answers) => {
-          if (answers.length === 0) {
-            return 'Please select at least one location';
-          }
-          return true;
-        },
-      },
-    ]);
-
-    const locations = [];
-    for (const loc of response.locations) {
-      if (loc === 'custom') {
-        const custom = await inquirer.prompt([
-          {
-            type: 'input',
-            name: 'path',
-            message: 'Enter custom path for Auggie commands:',
-            validate: (input) => {
-              if (!input.trim()) {
-                return 'Path cannot be empty';
-              }
-              return true;
-            },
-          },
-        ]);
-        locations.push(custom.path);
-      } else {
-        locations.push(loc);
-      }
-    }
-
-    return { auggieLocations: locations };
-  }
-
   /**
    * Setup Auggie CLI configuration
    * @param {string} projectDir - Project directory
@@ -74,175 +22,82 @@ class AuggieSetup extends BaseIdeSetup {
   async setup(projectDir, bmadDir, options = {}) {
     console.log(chalk.cyan(`Setting up ${this.name}...`));
 
-    // Use pre-collected configuration if available
-    const config = options.preCollectedConfig || {};
-    const locations = await this.getInstallLocations(projectDir, { ...options, auggieLocations: config.auggieLocations });
-
-    if (locations.length === 0) {
-      console.log(chalk.yellow('No locations selected. Skipping Auggie CLI setup.'));
-      return { success: false, reason: 'no-locations' };
-    }
+    // Always use project directory
+    const location = path.join(projectDir, '.augment', 'commands');
 
     // Clean up old BMAD installation first
     await this.cleanup(projectDir);
 
-    // Get agents, tasks, tools, and workflows (standalone only)
-    const agents = await this.getAgents(bmadDir);
+    // Generate agent launchers
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
+
+    // Get tasks, tools, and workflows (standalone only)
     const tasks = await this.getTasks(bmadDir, true);
     const tools = await this.getTools(bmadDir, true);
     const workflows = await this.getWorkflows(bmadDir, true);
 
-    let totalInstalled = 0;
-
-    // Install to each selected location
-    for (const location of locations) {
-      console.log(chalk.dim(`\n  Installing to: ${location}`));
-
-      const bmadCommandsDir = path.join(location, 'bmad');
-      const agentsDir = path.join(bmadCommandsDir, 'agents');
-      const tasksDir = path.join(bmadCommandsDir, 'tasks');
-      const toolsDir = path.join(bmadCommandsDir, 'tools');
-      const workflowsDir = path.join(bmadCommandsDir, 'workflows');
-
-      await this.ensureDir(agentsDir);
-      await this.ensureDir(tasksDir);
-      await this.ensureDir(toolsDir);
-      await this.ensureDir(workflowsDir);
-
-      // Install agents
-      for (const agent of agents) {
-        const content = await this.readFile(agent.path);
-        const commandContent = this.createAgentCommand(agent, content);
-
-        const targetPath = path.join(agentsDir, `${agent.module}-${agent.name}.md`);
-        await this.writeFile(targetPath, commandContent);
-        totalInstalled++;
-      }
-
-      // Install tasks
-      for (const task of tasks) {
-        const content = await this.readFile(task.path);
-        const commandContent = this.createTaskCommand(task, content);
-
-        const targetPath = path.join(tasksDir, `${task.module}-${task.name}.md`);
-        await this.writeFile(targetPath, commandContent);
-        totalInstalled++;
-      }
-
-      // Install tools
-      for (const tool of tools) {
-        const content = await this.readFile(tool.path);
-        const commandContent = this.createToolCommand(tool, content);
-
-        const targetPath = path.join(toolsDir, `${tool.module}-${tool.name}.md`);
-        await this.writeFile(targetPath, commandContent);
-        totalInstalled++;
-      }
-
-      // Install workflows
-      for (const workflow of workflows) {
-        const content = await this.readFile(workflow.path);
-        const commandContent = this.createWorkflowCommand(workflow, content);
-
-        const targetPath = path.join(workflowsDir, `${workflow.module}-${workflow.name}.md`);
-        await this.writeFile(targetPath, commandContent);
-        totalInstalled++;
-      }
-
-      console.log(
-        chalk.green(`  ✓ Installed ${agents.length} agents, ${tasks.length} tasks, ${tools.length} tools, ${workflows.length} workflows`),
-      );
+    const bmadCommandsDir = path.join(location, 'bmad');
+    const agentsDir = path.join(bmadCommandsDir, 'agents');
+    const tasksDir = path.join(bmadCommandsDir, 'tasks');
+    const toolsDir = path.join(bmadCommandsDir, 'tools');
+    const workflowsDir = path.join(bmadCommandsDir, 'workflows');
+
+    await this.ensureDir(agentsDir);
+    await this.ensureDir(tasksDir);
+    await this.ensureDir(toolsDir);
+    await this.ensureDir(workflowsDir);
+
+    // Install agent launchers
+    for (const artifact of agentArtifacts) {
+      const targetPath = path.join(agentsDir, `${artifact.module}-${artifact.name}.md`);
+      await this.writeFile(targetPath, artifact.content);
     }
 
-    console.log(chalk.green(`\n✓ ${this.name} configured:`));
-    console.log(chalk.dim(`  - ${totalInstalled} total commands installed`));
-    console.log(chalk.dim(`  - ${locations.length} location(s) configured`));
+    // Install tasks
+    for (const task of tasks) {
+      const content = await this.readFile(task.path);
+      const commandContent = this.createTaskCommand(task, content);
 
-    return {
-      success: true,
-      commands: totalInstalled,
-      locations: locations.length,
-    };
-  }
-
-  /**
-   * Get installation locations from user
-   */
-  async getInstallLocations(projectDir, options) {
-    if (options.auggieLocations) {
-      // Process the pre-collected locations to resolve relative paths
-      const processedLocations = [];
-      for (const loc of options.auggieLocations) {
-        if (loc === '.augment/commands') {
-          // Relative to project directory
-          processedLocations.push(path.join(projectDir, loc));
-        } else {
-          processedLocations.push(loc);
-        }
-      }
-      return processedLocations;
+      const targetPath = path.join(tasksDir, `${task.module}-${task.name}.md`);
+      await this.writeFile(targetPath, commandContent);
     }
 
-    const response = await inquirer.prompt([
-      {
-        type: 'checkbox',
-        name: 'locations',
-        message: 'Select Auggie CLI installation locations:',
-        choices: this.defaultLocations,
-        validate: (answers) => {
-          if (answers.length === 0) {
-            return 'Please select at least one location';
-          }
-          return true;
-        },
-      },
-    ]);
-
-    const locations = [];
-    for (const loc of response.locations) {
-      if (loc === 'custom') {
-        const custom = await inquirer.prompt([
-          {
-            type: 'input',
-            name: 'path',
-            message: 'Enter custom path for Auggie commands:',
-            validate: (input) => {
-              if (!input.trim()) {
-                return 'Path cannot be empty';
-              }
-              return true;
-            },
-          },
-        ]);
-        locations.push(custom.path);
-      } else if (loc.startsWith('.augment')) {
-        // Relative to project directory
-        locations.push(path.join(projectDir, loc));
-      } else {
-        locations.push(loc);
-      }
+    // Install tools
+    for (const tool of tools) {
+      const content = await this.readFile(tool.path);
+      const commandContent = this.createToolCommand(tool, content);
+
+      const targetPath = path.join(toolsDir, `${tool.module}-${tool.name}.md`);
+      await this.writeFile(targetPath, commandContent);
     }
 
-    return locations;
-  }
+    // Install workflows
+    for (const workflow of workflows) {
+      const content = await this.readFile(workflow.path);
+      const commandContent = this.createWorkflowCommand(workflow, content);
 
-  /**
-   * Create agent command content
-   */
-  createAgentCommand(agent, content) {
-    const titleMatch = content.match(/title="([^"]+)"/);
-    const title = titleMatch ? titleMatch[1] : this.formatTitle(agent.name);
-
-    return `# ${title} Agent
+      const targetPath = path.join(workflowsDir, `${workflow.module}-${workflow.name}.md`);
+      await this.writeFile(targetPath, commandContent);
+    }
 
-## Activation
-Type \`@${agent.name}\` to activate this agent.
+    const totalInstalled = agentArtifacts.length + tasks.length + tools.length + workflows.length;
 
-${content}
+    console.log(chalk.green(`✓ ${this.name} configured:`));
+    console.log(chalk.dim(`  - ${agentArtifacts.length} agents installed`));
+    console.log(chalk.dim(`  - ${tasks.length} tasks installed`));
+    console.log(chalk.dim(`  - ${tools.length} tools installed`));
+    console.log(chalk.dim(`  - ${workflows.length} workflows installed`));
+    console.log(chalk.dim(`  - Location: ${path.relative(projectDir, location)}`));
+    console.log(chalk.yellow(`\n  💡 Tip: Add 'model: gpt-4o' to command frontmatter to specify AI model`));
 
-## Module
-BMAD ${agent.module.toUpperCase()} module
-`;
+    return {
+      success: true,
+      agents: agentArtifacts.length,
+      tasks: tasks.length,
+      tools: tools.length,
+      workflows: workflows.length,
+    };
   }
 
   /**
@@ -252,10 +107,11 @@ BMAD ${agent.module.toUpperCase()} module
     const nameMatch = content.match(/name="([^"]+)"/);
     const taskName = nameMatch ? nameMatch[1] : this.formatTitle(task.name);
 
-    return `# ${taskName} Task
+    return `---
+description: "Execute the ${taskName} task"
+---
 
-## Activation
-Type \`@task-${task.name}\` to execute this task.
+# ${taskName} Task
 
 ${content}
 
@@ -271,10 +127,11 @@ BMAD ${task.module.toUpperCase()} module
     const nameMatch = content.match(/name="([^"]+)"/);
     const toolName = nameMatch ? nameMatch[1] : this.formatTitle(tool.name);
 
-    return `# ${toolName} Tool
+    return `---
+description: "Use the ${toolName} tool"
+---
 
-## Activation
-Type \`@tool-${tool.name}\` to execute this tool.
+# ${toolName} Tool
 
 ${content}
 
@@ -287,13 +144,13 @@ BMAD ${tool.module.toUpperCase()} module
    * Create workflow command content
    */
   createWorkflowCommand(workflow, content) {
-    return `# ${workflow.name} Workflow
+    const description = workflow.description || `Execute the ${workflow.name} workflow`;
 
-## Description
-${workflow.description || 'No description provided'}
+    return `---
+description: "${description}"
+---
 
-## Activation
-Type \`@workflow-${workflow.name}\` to execute this workflow.
+# ${workflow.name} Workflow
 
 ${content}
 
@@ -308,16 +165,13 @@ BMAD ${workflow.module.toUpperCase()} module
   async cleanup(projectDir) {
     const fs = require('fs-extra');
 
-    // Check common locations - bmad folder structure
-    const locations = [path.join(os.homedir(), '.augment', 'commands'), path.join(projectDir, '.augment', 'commands')];
-
-    for (const location of locations) {
-      const bmadDir = path.join(location, 'bmad');
+    // Only clean up project directory
+    const location = path.join(projectDir, '.augment', 'commands');
+    const bmadDir = path.join(location, 'bmad');
 
-      if (await fs.pathExists(bmadDir)) {
-        await fs.remove(bmadDir);
-        console.log(chalk.dim(`  Removed old BMAD commands from ${location}`));
-      }
+    if (await fs.pathExists(bmadDir)) {
+      await fs.remove(bmadDir);
+      console.log(chalk.dim(`  Removed old BMAD commands`));
     }
   }
 }

package/tools/cli/installers/lib/ide/claude-code.js

@@ -2,8 +2,9 @@ const path = require('node:path');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
 const { getProjectRoot, getSourcePath, getModulePath } = require('../../../lib/project-root');
-const { WorkflowCommandGenerator } = require('./workflow-command-generator');
-const { TaskToolCommandGenerator } = require('./task-tool-command-generator');
+const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');
+const { TaskToolCommandGenerator } = require('./shared/task-tool-command-generator');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 const {
   loadModuleInjectionConfig,
   shouldApplyInjection,
@@ -117,33 +118,24 @@ class ClaudeCodeSetup extends BaseIdeSetup {
 
     await this.ensureDir(bmadCommandsDir);
 
-    // Get agents from INSTALLED bmad/ directory
-    // Base installer has already built .md files from .agent.yaml sources
-    const agents = await getAgentsFromBmad(bmadDir, options.selectedModules || []);
+    // Generate agent launchers using AgentCommandGenerator
+    // This creates small launcher files that reference the actual agents in .bmad/
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts, counts: agentCounts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
 
-    // Create directories for each module (including standalone)
+    // Create directories for each module
     const modules = new Set();
-    for (const item of agents) modules.add(item.module);
+    for (const artifact of agentArtifacts) {
+      modules.add(artifact.module);
+    }
 
     for (const module of modules) {
       await this.ensureDir(path.join(bmadCommandsDir, module));
       await this.ensureDir(path.join(bmadCommandsDir, module, 'agents'));
     }
 
-    // Copy agents from bmad/ to .claude/commands/
-    let agentCount = 0;
-    for (const agent of agents) {
-      const sourcePath = agent.path;
-      const targetPath = path.join(bmadCommandsDir, agent.module, 'agents', `${agent.name}.md`);
-
-      const content = await this.readAndProcess(sourcePath, {
-        module: agent.module,
-        name: agent.name,
-      });
-
-      await this.writeFile(targetPath, content);
-      agentCount++;
-    }
+    // Write agent launcher files
+    const agentCount = await agentGen.writeAgentLaunchers(bmadCommandsDir, agentArtifacts);
 
     // Process Claude Code specific injections for installed modules
     // Use pre-collected configuration if available, or skip if already configured
@@ -161,7 +153,7 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     // await this.createClaudeConfig(projectDir, modules);
 
     // Generate workflow commands from manifest (if it exists)
-    const workflowGen = new WorkflowCommandGenerator();
+    const workflowGen = new WorkflowCommandGenerator(this.bmadFolderName);
     const { artifacts: workflowArtifacts } = await workflowGen.collectWorkflowArtifacts(bmadDir);
 
     // Write only workflow-command artifacts, skip workflow-launcher READMEs

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

@@ -2,7 +2,8 @@ const path = require('node:path');
 const fs = require('fs-extra');
 const chalk = require('chalk');
 const { BaseIdeSetup } = require('./_base-ide');
-const { WorkflowCommandGenerator } = require('./workflow-command-generator');
+const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 const { getAgentsFromBmad, getTasksFromBmad } = require('./shared/bmad-artifacts');
 
 /**
@@ -11,7 +12,7 @@ const { getAgentsFromBmad, getTasksFromBmad } = require('./shared/bmad-artifacts
  */
 class ClineSetup extends BaseIdeSetup {
   constructor() {
-    super('cline', 'Cline', true); // preferred IDE
+    super('cline', 'Cline', false);
     this.configDir = '.clinerules';
     this.workflowsDir = 'workflows';
   }
@@ -88,23 +89,19 @@ class ClineSetup extends BaseIdeSetup {
     const selectedModules = options.selectedModules || [];
     const artifacts = [];
 
-    // Get agents
-    const agents = await getAgentsFromBmad(bmadDir, selectedModules);
-    for (const agent of agents) {
-      const content = await this.readAndProcessWithProject(
-        agent.path,
-        {
-          module: agent.module,
-          name: agent.name,
-        },
-        projectDir,
-      );
+    // Generate agent launchers
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, selectedModules);
+
+    // Process agent launchers with project-specific paths
+    for (const agentArtifact of agentArtifacts) {
+      const content = agentArtifact.content;
 
       artifacts.push({
         type: 'agent',
-        module: agent.module,
-        sourcePath: agent.path,
-        relativePath: path.join(agent.module, 'agents', `${agent.name}.md`),
+        module: agentArtifact.module,
+        sourcePath: agentArtifact.sourcePath,
+        relativePath: agentArtifact.relativePath,
         content,
       });
     }
@@ -131,14 +128,14 @@ class ClineSetup extends BaseIdeSetup {
     }
 
     // Get workflows
-    const workflowGenerator = new WorkflowCommandGenerator();
+    const workflowGenerator = new WorkflowCommandGenerator(this.bmadFolderName);
     const { artifacts: workflowArtifacts, counts: workflowCounts } = await workflowGenerator.collectWorkflowArtifacts(bmadDir);
     artifacts.push(...workflowArtifacts);
 
     return {
       artifacts,
       counts: {
-        agents: agents.length,
+        agents: agentArtifacts.length,
         tasks: tasks.length,
         workflows: workflowCounts.commands,
         workflowLaunchers: workflowCounts.launchers,