bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.20

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

@@ -1,70 +1,20 @@
 const path = require('node:path');
-const os = require('node:os');
+const fs = require('fs-extra');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
-const inquirer = require('inquirer');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
+const { WorkflowCommandGenerator } = require('./shared/workflow-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,172 +24,93 @@ 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 });
+    // Always use project directory
+    const location = path.join(projectDir, '.augment', 'commands');
 
-    if (locations.length === 0) {
-      console.log(chalk.yellow('No locations selected. Skipping Auggie CLI setup.'));
-      return { success: false, reason: 'no-locations' };
-    }
+    // 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 (ALL workflows now generate commands)
     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`),
-      );
-    }
-
-    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`));
 
-    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;
+    // Get ALL workflows using the new workflow command generator
+    const workflowGenerator = new WorkflowCommandGenerator(this.bmadFolderName);
+    const { artifacts: workflowArtifacts, counts: workflowCounts } = await workflowGenerator.collectWorkflowArtifacts(bmadDir);
+
+    // Convert workflow artifacts to expected format
+    const workflows = workflowArtifacts
+      .filter((artifact) => artifact.type === 'workflow-command')
+      .map((artifact) => ({
+        module: artifact.module,
+        name: path.basename(artifact.relativePath, '.md'),
+        path: artifact.sourcePath,
+        content: artifact.content,
+      }));
+
+    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);
     }
 
-    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 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);
     }
 
-    return locations;
-  }
+    // Install tools
+    for (const tool of tools) {
+      const content = await this.readFile(tool.path);
+      const commandContent = this.createToolCommand(tool, content);
 
-  /**
-   * Create agent command content
-   */
-  createAgentCommand(agent, content) {
-    const titleMatch = content.match(/title="([^"]+)"/);
-    const title = titleMatch ? titleMatch[1] : this.formatTitle(agent.name);
+      const targetPath = path.join(toolsDir, `${tool.module}-${tool.name}.md`);
+      await this.writeFile(targetPath, commandContent);
+    }
 
-    return `# ${title} Agent
+    // Install workflows (already generated commands)
+    for (const workflow of workflows) {
+      // Use the pre-generated workflow command content
+      const targetPath = path.join(workflowsDir, `${workflow.module}-${workflow.name}.md`);
+      await this.writeFile(targetPath, workflow.content);
+    }
 
-## 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,
+    };
   }
 
   /**
@@ -249,10 +120,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}
 
@@ -268,10 +140,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}
 
@@ -284,13 +157,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}
 
@@ -305,31 +178,66 @@ BMAD ${workflow.module.toUpperCase()} module
   async cleanup(projectDir) {
     const fs = require('fs-extra');
 
-    // Check common locations
-    const locations = [path.join(os.homedir(), '.augment', 'commands'), path.join(projectDir, '.augment', 'commands')];
-
-    for (const location of locations) {
-      const agentsDir = path.join(location, 'agents');
-      const tasksDir = path.join(location, 'tasks');
-      const toolsDir = path.join(location, 'tools');
-      const workflowsDir = path.join(location, 'workflows');
-
-      const dirs = [agentsDir, tasksDir, toolsDir, workflowsDir];
-
-      for (const dir of dirs) {
-        if (await fs.pathExists(dir)) {
-          // Remove only BMAD files (those with module prefix)
-          const files = await fs.readdir(dir);
-          for (const file of files) {
-            if (file.includes('-') && file.endsWith('.md')) {
-              await fs.remove(path.join(dir, file));
-            }
-          }
-        }
-      }
+    // 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`));
     }
+  }
+
+  /**
+   * Install a custom agent launcher for Auggie
+   * @param {string} projectDir - Project directory
+   * @param {string} agentName - Agent name (e.g., "fred-commit-poet")
+   * @param {string} agentPath - Path to compiled agent (relative to project root)
+   * @param {Object} metadata - Agent metadata
+   * @returns {Object} Installation result
+   */
+  async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
+    // Auggie uses .augment/commands directory
+    const location = path.join(projectDir, '.augment', 'commands');
+    const bmadCommandsDir = path.join(location, 'bmad');
+    const agentsDir = path.join(bmadCommandsDir, 'agents');
+
+    // Create .augment/commands/bmad/agents directory if it doesn't exist
+    await fs.ensureDir(agentsDir);
+
+    // Create custom agent launcher
+    const launcherContent = `---
+description: "Use the ${agentName} custom agent"
+---
 
-    console.log(chalk.dim('Cleaned up Auggie CLI configurations'));
+# ${agentName} Custom Agent
+
+**⚠️ IMPORTANT**: Run @${agentPath} first to load the complete agent!
+
+This is a launcher for the custom BMAD agent "${agentName}".
+
+## Usage
+1. First run: \`${agentPath}\` to load the complete agent
+2. Then use this command to activate ${agentName}
+
+The agent will follow the persona and instructions from the main agent file.
+
+## Module
+BMAD Custom agent
+`;
+
+    const fileName = `custom-${agentName.toLowerCase()}.md`;
+    const launcherPath = path.join(agentsDir, fileName);
+
+    // Write the launcher file
+    await fs.writeFile(launcherPath, launcherContent, 'utf8');
+
+    return {
+      ide: 'auggie',
+      path: path.relative(projectDir, launcherPath),
+      command: agentName,
+      type: 'custom-agent-launcher',
+    };
   }
 }
 

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

@@ -1,9 +1,11 @@
 const path = require('node:path');
+const fs = require('fs-extra');
 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,
@@ -42,13 +44,12 @@ class ClaudeCodeSetup extends BaseIdeSetup {
       const injectionConfigPath = path.join(sourceModulesPath, moduleName, 'sub-modules', 'claude-code', 'injections.yaml');
 
       if (await this.exists(injectionConfigPath)) {
-        const fs = require('fs-extra');
-        const yaml = require('js-yaml');
+        const yaml = require('yaml');
 
         try {
           // Load injection configuration
           const configContent = await fs.readFile(injectionConfigPath, 'utf8');
-          const injectionConfig = yaml.load(configContent);
+          const injectionConfig = yaml.parse(configContent);
 
           // Ask about subagents if they exist and we haven't asked yet
           if (injectionConfig.subagents && !config.subagentChoices) {
@@ -81,6 +82,19 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     return config;
   }
 
+  /**
+   * Cleanup old BMAD installation before reinstalling
+   * @param {string} projectDir - Project directory
+   */
+  async cleanup(projectDir) {
+    const bmadCommandsDir = path.join(projectDir, this.configDir, this.commandsDir, 'bmad');
+
+    if (await fs.pathExists(bmadCommandsDir)) {
+      await fs.remove(bmadCommandsDir);
+      console.log(chalk.dim(`  Removed old BMAD commands from ${this.name}`));
+    }
+  }
+
   /**
    * Setup Claude Code IDE configuration
    * @param {string} projectDir - Project directory
@@ -93,6 +107,9 @@ class ClaudeCodeSetup extends BaseIdeSetup {
 
     console.log(chalk.cyan(`Setting up ${this.name}...`));
 
+    // Clean up old BMAD installation first
+    await this.cleanup(projectDir);
+
     // Create .claude/commands directory structure
     const claudeDir = path.join(projectDir, this.configDir);
     const commandsDir = path.join(claudeDir, this.commandsDir);
@@ -100,33 +117,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
@@ -144,8 +152,21 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     // await this.createClaudeConfig(projectDir, modules);
 
     // Generate workflow commands from manifest (if it exists)
-    const workflowGen = new WorkflowCommandGenerator();
-    const workflowResult = await workflowGen.generateWorkflowCommands(projectDir, bmadDir);
+    const workflowGen = new WorkflowCommandGenerator(this.bmadFolderName);
+    const { artifacts: workflowArtifacts } = await workflowGen.collectWorkflowArtifacts(bmadDir);
+
+    // Write only workflow-command artifacts, skip workflow-launcher READMEs
+    let workflowCommandCount = 0;
+    for (const artifact of workflowArtifacts) {
+      if (artifact.type === 'workflow-command') {
+        const moduleWorkflowsDir = path.join(bmadCommandsDir, artifact.module, 'workflows');
+        await this.ensureDir(moduleWorkflowsDir);
+        const commandPath = path.join(moduleWorkflowsDir, path.basename(artifact.relativePath));
+        await this.writeFile(commandPath, artifact.content);
+        workflowCommandCount++;
+      }
+      // Skip workflow-launcher READMEs as they would be treated as slash commands
+    }
 
     // Generate task and tool commands from manifests (if they exist)
     const taskToolGen = new TaskToolCommandGenerator();
@@ -153,8 +174,8 @@ class ClaudeCodeSetup extends BaseIdeSetup {
 
     console.log(chalk.green(`✓ ${this.name} configured:`));
     console.log(chalk.dim(`  - ${agentCount} agents installed`));
-    if (workflowResult.generated > 0) {
-      console.log(chalk.dim(`  - ${workflowResult.generated} workflow commands generated`));
+    if (workflowCommandCount > 0) {
+      console.log(chalk.dim(`  - ${workflowCommandCount} workflow commands generated`));
     }
     if (taskToolResult.generated > 0) {
       console.log(
@@ -177,7 +198,6 @@ class ClaudeCodeSetup extends BaseIdeSetup {
    * Read and process file content
    */
   async readAndProcess(filePath, metadata) {
-    const fs = require('fs-extra');
     const content = await fs.readFile(filePath, 'utf8');
     return this.processContent(content, metadata);
   }
@@ -194,7 +214,6 @@ class ClaudeCodeSetup extends BaseIdeSetup {
    * Get agents from source modules (not installed location)
    */
   async getAgentsFromSource(sourceDir, selectedModules) {
-    const fs = require('fs-extra');
     const agents = [];
 
     // Add core agents
@@ -373,7 +392,6 @@ class ClaudeCodeSetup extends BaseIdeSetup {
    * Inject content at specified point in file
    */
   async injectContent(projectDir, injection, subagentChoices = null) {
-    const fs = require('fs-extra');
     const targetPath = path.join(projectDir, injection.file);
 
     if (await this.exists(targetPath)) {
@@ -399,7 +417,6 @@ class ClaudeCodeSetup extends BaseIdeSetup {
    * Copy selected subagents to appropriate Claude agents directory
    */
   async copySelectedSubagents(projectDir, handlerBaseDir, subagentConfig, choices, location) {
-    const fs = require('fs-extra');
     const os = require('node:os');
 
     // Determine target directory based on user choice
@@ -444,6 +461,49 @@ class ClaudeCodeSetup extends BaseIdeSetup {
       console.log(chalk.dim(`  Total subagents installed: ${copiedCount}`));
     }
   }
+
+  /**
+   * Install a custom agent launcher for Claude Code
+   * @param {string} projectDir - Project directory
+   * @param {string} agentName - Agent name (e.g., "fred-commit-poet")
+   * @param {string} agentPath - Path to compiled agent (relative to project root)
+   * @param {Object} metadata - Agent metadata
+   * @returns {Object|null} Info about created command
+   */
+  async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
+    const customAgentsDir = path.join(projectDir, this.configDir, this.commandsDir, 'bmad', 'custom', 'agents');
+
+    if (!(await this.exists(path.join(projectDir, this.configDir)))) {
+      return null; // IDE not configured for this project
+    }
+
+    await this.ensureDir(customAgentsDir);
+
+    const launcherContent = `---
+name: '${agentName}'
+description: '${agentName} agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from @${agentPath}
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
+`;
+
+    const launcherPath = path.join(customAgentsDir, `${agentName}.md`);
+    await this.writeFile(launcherPath, launcherContent);
+
+    return {
+      path: launcherPath,
+      command: `/bmad:custom:agents:${agentName}`,
+    };
+  }
 }
 
 module.exports = { ClaudeCodeSetup };