bmad-method 6.0.0-alpha.13 → 6.0.0-alpha.14

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

@@ -5,34 +5,13 @@ const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * Roo IDE setup handler
- * Creates custom modes in .roomodes file
+ * Creates custom commands in .roo/commands directory
  */
 class RooSetup extends BaseIdeSetup {
   constructor() {
     super('roo', 'Roo Code');
-    this.configFile = '.roomodes';
-    this.defaultPermissions = {
-      dev: {
-        description: 'Development files',
-        fileRegex: String.raw`.*\.(js|jsx|ts|tsx|py|java|cpp|c|h|cs|go|rs|php|rb|swift)$`,
-      },
-      config: {
-        description: 'Configuration files',
-        fileRegex: String.raw`.*\.(json|yaml|yml|toml|xml|ini|env|config)$`,
-      },
-      docs: {
-        description: 'Documentation files',
-        fileRegex: String.raw`.*\.(md|mdx|rst|txt|doc|docx)$`,
-      },
-      styles: {
-        description: 'Style and design files',
-        fileRegex: String.raw`.*\.(css|scss|sass|less|stylus)$`,
-      },
-      all: {
-        description: 'All files',
-        fileRegex: '.*',
-      },
-    };
+    this.configDir = '.roo';
+    this.commandsDir = 'commands';
   }
 
   /**
@@ -44,94 +23,96 @@ class RooSetup extends BaseIdeSetup {
   async setup(projectDir, bmadDir, options = {}) {
     console.log(chalk.cyan(`Setting up ${this.name}...`));
 
-    // Check for existing .roomodes file
-    const roomodesPath = path.join(projectDir, this.configFile);
-    let existingModes = [];
-    let existingContent = '';
-
-    if (await this.pathExists(roomodesPath)) {
-      existingContent = await this.readFile(roomodesPath);
-      // Parse existing modes to avoid duplicates
-      const modeMatches = existingContent.matchAll(/- slug: ([\w-]+)/g);
-      for (const match of modeMatches) {
-        existingModes.push(match[1]);
-      }
-      console.log(chalk.yellow(`Found existing .roomodes file with ${existingModes.length} modes`));
-    }
+    // Create .roo/commands directory
+    const rooCommandsDir = path.join(projectDir, this.configDir, this.commandsDir);
+    await this.ensureDir(rooCommandsDir);
 
-    // Generate agent launchers (though Roo will reference the actual .bmad agents)
+    // Generate agent launchers
     const agentGen = new AgentCommandGenerator(this.bmadFolderName);
     const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
 
-    // Always use 'all' permissions - users can customize in .roomodes file
-    const permissionChoice = 'all';
-
-    // Create modes content
-    let newModesContent = '';
     let addedCount = 0;
     let skippedCount = 0;
 
     for (const artifact of agentArtifacts) {
-      const slug = `bmad-${artifact.module}-${artifact.name}`;
+      const commandName = `bmad-${artifact.module}-agent-${artifact.name}`;
+      const commandPath = path.join(rooCommandsDir, `${commandName}.md`);
 
       // Skip if already exists
-      if (existingModes.includes(slug)) {
-        console.log(chalk.dim(`  Skipping ${slug} - already exists`));
+      if (await this.pathExists(commandPath)) {
+        console.log(chalk.dim(`  Skipping ${commandName} - already exists`));
         skippedCount++;
         continue;
       }
 
-      // Read the actual agent file from .bmad for metadata extraction
+      // Read the actual agent file from .bmad for metadata extraction (installed agents are .md files)
       const agentPath = path.join(bmadDir, artifact.module, 'agents', `${artifact.name}.md`);
       const content = await this.readFile(agentPath);
 
-      // Create mode entry that references the actual .bmad agent
-      const modeEntry = await this.createModeEntry(
-        { module: artifact.module, name: artifact.name, path: agentPath },
-        content,
-        permissionChoice,
-        projectDir,
-      );
+      // Create command file that references the actual .bmad agent
+      await this.createCommandFile({ module: artifact.module, name: artifact.name, path: agentPath }, content, commandPath, projectDir);
 
-      newModesContent += modeEntry;
       addedCount++;
-      console.log(chalk.green(`  ✓ Added mode: ${slug}`));
+      console.log(chalk.green(`  ✓ Added command: ${commandName}`));
     }
 
-    // Build final content
-    let finalContent = '';
-    if (existingContent) {
-      // Append to existing content
-      finalContent = existingContent.trim() + '\n' + newModesContent;
-    } else {
-      // Create new .roomodes file
-      finalContent = 'customModes:\n' + newModesContent;
-    }
-
-    // Write .roomodes file
-    await this.writeFile(roomodesPath, finalContent);
-
     console.log(chalk.green(`✓ ${this.name} configured:`));
-    console.log(chalk.dim(`  - ${addedCount} modes added`));
+    console.log(chalk.dim(`  - ${addedCount} commands added`));
     if (skippedCount > 0) {
-      console.log(chalk.dim(`  - ${skippedCount} modes skipped (already exist)`));
+      console.log(chalk.dim(`  - ${skippedCount} commands skipped (already exist)`));
     }
-    console.log(chalk.dim(`  - Configuration file: ${this.configFile}`));
-    console.log(chalk.dim(`  - Permission level: all (unrestricted)`));
-    console.log(chalk.yellow(`\n  💡 Tip: Edit ${this.configFile} to customize file permissions per agent`));
-    console.log(chalk.dim(`  Modes will be available when you open this project in Roo Code`));
+    console.log(chalk.dim(`  - Commands directory: ${this.configDir}/${this.commandsDir}/bmad/`));
+    console.log(chalk.dim(`  Commands will be available when you open this project in Roo Code`));
 
     return {
       success: true,
-      modes: addedCount,
+      commands: addedCount,
       skipped: skippedCount,
     };
   }
 
   /**
-   * Create a mode entry for an agent
+   * Create a unified command file for agents
+   * @param {string} commandPath - Path where to write the command file
+   * @param {Object} options - Command options
+   * @param {string} options.name - Display name for the command
+   * @param {string} options.description - Description for the command
+   * @param {string} options.agentPath - Path to the agent file (relative to project root)
+   * @param {string} [options.icon] - Icon emoji (defaults to 🤖)
+   * @param {string} [options.extraContent] - Additional content to include before activation
    */
-  async createModeEntry(agent, content, permissionChoice, projectDir) {
+  async createAgentCommandFile(commandPath, options) {
+    const { name, description, agentPath, icon = '🤖', extraContent = '' } = options;
+
+    // Build command content with YAML frontmatter
+    let commandContent = `---\n`;
+    commandContent += `name: '${icon} ${name}'\n`;
+    commandContent += `description: '${description}'\n`;
+    commandContent += `---\n\n`;
+
+    commandContent += `You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.\n\n`;
+
+    // Add any extra content (e.g., warnings for custom agents)
+    if (extraContent) {
+      commandContent += `${extraContent}\n\n`;
+    }
+
+    commandContent += `<agent-activation CRITICAL="TRUE">\n`;
+    commandContent += `1. LOAD the FULL agent file from @${agentPath}\n`;
+    commandContent += `2. READ its entire contents - this contains the complete agent persona, menu, and instructions\n`;
+    commandContent += `3. Execute ALL activation steps exactly as written in the agent file\n`;
+    commandContent += `4. Follow the agent's persona and menu system precisely\n`;
+    commandContent += `5. Stay in character throughout the session\n`;
+    commandContent += `</agent-activation>\n`;
+
+    // Write command file
+    await this.writeFile(commandPath, commandContent);
+  }
+
+  /**
+   * Create a command file for an agent
+   */
+  async createCommandFile(agent, content, commandPath, projectDir) {
     // Extract metadata from agent content
     const titleMatch = content.match(/title="([^"]+)"/);
     const title = titleMatch ? titleMatch[1] : this.formatTitle(agent.name);
@@ -142,66 +123,16 @@ class RooSetup extends BaseIdeSetup {
     const whenToUseMatch = content.match(/whenToUse="([^"]+)"/);
     const whenToUse = whenToUseMatch ? whenToUseMatch[1] : `Use for ${title} tasks`;
 
-    // Get the activation header from central template
-    const activationHeader = await this.getAgentCommandHeader();
-
-    const roleDefinitionMatch = content.match(/roleDefinition="([^"]+)"/);
-    const roleDefinition = roleDefinitionMatch
-      ? roleDefinitionMatch[1]
-      : `You are a ${title} specializing in ${title.toLowerCase()} tasks and responsibilities.`;
-
     // Get relative path
     const relativePath = path.relative(projectDir, agent.path).replaceAll('\\', '/');
 
-    // Determine permissions
-    const permissions = this.getPermissionsForAgent(agent, permissionChoice);
-
-    // Build mode entry
-    const slug = `bmad-${agent.module}-${agent.name}`;
-    let modeEntry = ` - slug: ${slug}\n`;
-    modeEntry += `   name: '${icon} ${title}'\n`;
-
-    if (permissions && permissions.description) {
-      modeEntry += `   description: '${permissions.description}'\n`;
-    }
-
-    modeEntry += `   roleDefinition: ${roleDefinition}\n`;
-    modeEntry += `   whenToUse: ${whenToUse}\n`;
-    modeEntry += `   customInstructions: ${activationHeader} Read the full YAML from ${relativePath} start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode\n`;
-    modeEntry += `   groups:\n`;
-    modeEntry += `    - read\n`;
-
-    if (permissions && permissions.fileRegex) {
-      modeEntry += `    - - edit\n`;
-      modeEntry += `      - fileRegex: ${permissions.fileRegex}\n`;
-      modeEntry += `        description: ${permissions.description}\n`;
-    } else {
-      modeEntry += `    - edit\n`;
-    }
-
-    return modeEntry;
-  }
-
-  /**
-   * Get permissions configuration for an agent
-   */
-  getPermissionsForAgent(agent, permissionChoice) {
-    if (permissionChoice === 'custom') {
-      // Custom logic based on agent name/module
-      if (agent.name.includes('dev') || agent.name.includes('code')) {
-        return this.defaultPermissions.dev;
-      } else if (agent.name.includes('doc') || agent.name.includes('write')) {
-        return this.defaultPermissions.docs;
-      } else if (agent.name.includes('config') || agent.name.includes('setup')) {
-        return this.defaultPermissions.config;
-      } else if (agent.name.includes('style') || agent.name.includes('css')) {
-        return this.defaultPermissions.styles;
-      }
-      // Default to all for custom agents
-      return this.defaultPermissions.all;
-    }
-
-    return this.defaultPermissions[permissionChoice] || null;
+    // Use unified method
+    await this.createAgentCommandFile(commandPath, {
+      name: title,
+      description: whenToUse,
+      agentPath: relativePath,
+      icon: icon,
+    });
   }
 
   /**
@@ -219,8 +150,26 @@ class RooSetup extends BaseIdeSetup {
    */
   async cleanup(projectDir) {
     const fs = require('fs-extra');
-    const roomodesPath = path.join(projectDir, this.configFile);
+    const rooCommandsDir = path.join(projectDir, this.configDir, this.commandsDir);
+
+    if (await fs.pathExists(rooCommandsDir)) {
+      const files = await fs.readdir(rooCommandsDir);
+      let removedCount = 0;
+
+      for (const file of files) {
+        if (file.startsWith('bmad-') && file.endsWith('.md')) {
+          await fs.remove(path.join(rooCommandsDir, file));
+          removedCount++;
+        }
+      }
 
+      if (removedCount > 0) {
+        console.log(chalk.dim(`Removed ${removedCount} BMAD commands from .roo/commands/`));
+      }
+    }
+
+    // Also clean up old .roomodes file if it exists
+    const roomodesPath = path.join(projectDir, '.roomodes');
     if (await fs.pathExists(roomodesPath)) {
       const content = await fs.readFile(roomodesPath, 'utf8');
 
@@ -245,7 +194,9 @@ class RooSetup extends BaseIdeSetup {
 
       // Write back filtered content
       await fs.writeFile(roomodesPath, filteredLines.join('\n'));
-      console.log(chalk.dim(`Removed ${removedCount} BMAD modes from .roomodes`));
+      if (removedCount > 0) {
+        console.log(chalk.dim(`Removed ${removedCount} BMAD modes from legacy .roomodes file`));
+      }
     }
   }
 
@@ -254,68 +205,53 @@ class RooSetup extends BaseIdeSetup {
    * @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
+   * @param {Object} metadata - Agent metadata (unused, kept for compatibility)
    * @returns {Object} Installation result
    */
   async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
-    const roomodesPath = path.join(projectDir, this.configFile);
-    let existingContent = '';
-
-    // Read existing .roomodes file
-    if (await this.pathExists(roomodesPath)) {
-      existingContent = await this.readFile(roomodesPath);
-    }
-
-    // Create custom agent mode entry
-    const slug = `bmad-custom-${agentName.toLowerCase()}`;
-    const modeEntry = ` - slug: ${slug}
-   name: 'BMAD Custom: ${agentName}'
-   description: |
-    Custom BMAD agent: ${agentName}
+    const rooCommandsDir = path.join(projectDir, this.configDir, this.commandsDir);
+    await this.ensureDir(rooCommandsDir);
 
-    **⚠️ IMPORTANT**: Run @${agentPath} first to load the complete agent!
+    const commandName = `bmad-custom-agent-${agentName.toLowerCase()}`;
+    const commandPath = path.join(rooCommandsDir, `${commandName}.md`);
 
-    This is a launcher for the custom BMAD agent "${agentName}". The agent will follow the persona and instructions from the main agent file.
-   prompt: |
-    @${agentPath}
-   always: false
-   permissions: all
-`;
-
-    // Check if mode already exists
-    if (existingContent.includes(slug)) {
+    // Check if command already exists
+    if (await this.pathExists(commandPath)) {
       return {
         ide: 'roo',
-        path: this.configFile,
-        command: agentName,
+        path: path.join(this.configDir, this.commandsDir, `${commandName}.md`),
+        command: commandName,
         type: 'custom-agent-launcher',
         alreadyExists: true,
       };
     }
 
-    // Build final content
-    let finalContent = '';
-    if (existingContent) {
-      // Find customModes section or add it
-      if (existingContent.includes('customModes:')) {
-        // Append to existing customModes
-        finalContent = existingContent + modeEntry;
-      } else {
-        // Add customModes section
-        finalContent = existingContent.trim() + '\n\ncustomModes:\n' + modeEntry;
-      }
-    } else {
-      // Create new .roomodes file with customModes
-      finalContent = 'customModes:\n' + modeEntry;
-    }
+    // Read the custom agent file to extract metadata (same as regular agents)
+    const fullAgentPath = path.join(projectDir, agentPath);
+    const content = await this.readFile(fullAgentPath);
+
+    // Extract metadata from agent content
+    const titleMatch = content.match(/title="([^"]+)"/);
+    const title = titleMatch ? titleMatch[1] : this.formatTitle(agentName);
+
+    const iconMatch = content.match(/icon="([^"]+)"/);
+    const icon = iconMatch ? iconMatch[1] : '🤖';
+
+    const whenToUseMatch = content.match(/whenToUse="([^"]+)"/);
+    const whenToUse = whenToUseMatch ? whenToUseMatch[1] : `Use for ${title} tasks`;
 
-    // Write .roomodes file
-    await this.writeFile(roomodesPath, finalContent);
+    // Use unified method without extra content (clean)
+    await this.createAgentCommandFile(commandPath, {
+      name: title,
+      description: whenToUse,
+      agentPath: agentPath,
+      icon: icon,
+    });
 
     return {
       ide: 'roo',
-      path: this.configFile,
-      command: slug,
+      path: path.join(this.configDir, this.commandsDir, `${commandName}.md`),
+      command: commandName,
       type: 'custom-agent-launcher',
     };
   }

package/tools/cli/installers/lib/ide/rovo-dev.js

@@ -15,7 +15,7 @@ const { TaskToolCommandGenerator } = require('./shared/task-tool-command-generat
  */
 class RovoDevSetup extends BaseIdeSetup {
   constructor() {
-    super('rovo-dev', 'Atlassian Rovo Dev', true); // preferred IDE
+    super('rovo-dev', 'Atlassian Rovo Dev', false);
     this.configDir = '.rovodev';
     this.subagentsDir = 'subagents';
     this.workflowsDir = 'workflows';

package/tools/cli/installers/lib/ide/shared/agent-command-generator.js

@@ -28,11 +28,13 @@ class AgentCommandGenerator {
 
     for (const agent of agents) {
       const launcherContent = await this.generateLauncherContent(agent);
+      // Use relativePath if available (for nested agents), otherwise just name with .md
+      const agentPathInModule = agent.relativePath || `${agent.name}.md`;
       artifacts.push({
         type: 'agent-launcher',
         module: agent.module,
         name: agent.name,
-        relativePath: path.join(agent.module, 'agents', `${agent.name}.md`),
+        relativePath: path.join(agent.module, 'agents', agentPathInModule),
         content: launcherContent,
         sourcePath: agent.path,
       });
@@ -56,11 +58,15 @@ class AgentCommandGenerator {
     const template = await fs.readFile(this.templatePath, 'utf8');
 
     // Replace template variables
+    // Use relativePath if available (for nested agents), otherwise just name with .md
+    const agentPathInModule = agent.relativePath || `${agent.name}.md`;
     return template
       .replaceAll('{{name}}', agent.name)
       .replaceAll('{{module}}', agent.module)
+      .replaceAll('{{path}}', agentPathInModule)
       .replaceAll('{{description}}', agent.description || `${agent.name} agent`)
-      .replaceAll('{bmad_folder}', this.bmadFolderName);
+      .replaceAll('{bmad_folder}', this.bmadFolderName)
+      .replaceAll('{*bmad_folder*}', '{bmad_folder}');
   }
 
   /**

package/tools/cli/installers/lib/ide/shared/bmad-artifacts.js

@@ -76,36 +76,51 @@ async function getTasksFromBmad(bmadDir, selectedModules = []) {
   return tasks;
 }
 
-async function getAgentsFromDir(dirPath, moduleName) {
+async function getAgentsFromDir(dirPath, moduleName, relativePath = '') {
   const agents = [];
 
   if (!(await fs.pathExists(dirPath))) {
     return agents;
   }
 
-  const files = await fs.readdir(dirPath);
+  const entries = await fs.readdir(dirPath, { withFileTypes: true });
 
-  for (const file of files) {
-    if (!file.endsWith('.md')) {
-      continue;
-    }
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    const newRelativePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
 
-    if (file.includes('.customize.')) {
-      continue;
-    }
+    if (entry.isDirectory()) {
+      // Recurse into subdirectories
+      const subDirAgents = await getAgentsFromDir(fullPath, moduleName, newRelativePath);
+      agents.push(...subDirAgents);
+    } else if (entry.name.endsWith('.md')) {
+      // Skip README files and other non-agent files
+      if (entry.name.toLowerCase() === 'readme.md' || entry.name.toLowerCase().startsWith('readme-')) {
+        continue;
+      }
 
-    const filePath = path.join(dirPath, file);
-    const content = await fs.readFile(filePath, 'utf8');
+      if (entry.name.includes('.customize.')) {
+        continue;
+      }
 
-    if (content.includes('localskip="true"')) {
-      continue;
-    }
+      const content = await fs.readFile(fullPath, 'utf8');
 
-    agents.push({
-      path: filePath,
-      name: file.replace('.md', ''),
-      module: moduleName,
-    });
+      if (content.includes('localskip="true"')) {
+        continue;
+      }
+
+      // Only include files that have agent-specific content (compiled agents have <agent> tag)
+      if (!content.includes('<agent')) {
+        continue;
+      }
+
+      agents.push({
+        path: fullPath,
+        name: entry.name.replace('.md', ''),
+        module: moduleName,
+        relativePath: newRelativePath, // Keep the .md extension for the full path
+      });
+    }
   }
 
   return agents;

package/tools/cli/installers/lib/ide/shared/workflow-command-generator.js

@@ -25,16 +25,16 @@ class WorkflowCommandGenerator {
       return { generated: 0 };
     }
 
-    // Filter to only standalone workflows
-    const standaloneWorkflows = workflows.filter((w) => w.standalone === 'true' || w.standalone === true);
+    // ALL workflows now generate commands - no standalone filtering
+    const allWorkflows = workflows;
 
     // Base commands directory
     const baseCommandsDir = path.join(projectDir, '.claude', 'commands', 'bmad');
 
     let generatedCount = 0;
 
-    // Generate a command file for each standalone workflow, organized by module
-    for (const workflow of standaloneWorkflows) {
+    // Generate a command file for each workflow, organized by module
+    for (const workflow of allWorkflows) {
       const moduleWorkflowsDir = path.join(baseCommandsDir, workflow.module, 'workflows');
       await fs.ensureDir(moduleWorkflowsDir);
 
@@ -46,7 +46,7 @@ class WorkflowCommandGenerator {
     }
 
     // Also create a workflow launcher README in each module
-    const groupedWorkflows = this.groupWorkflowsByModule(standaloneWorkflows);
+    const groupedWorkflows = this.groupWorkflowsByModule(allWorkflows);
     await this.createModuleWorkflowLaunchers(baseCommandsDir, groupedWorkflows);
 
     return { generated: generatedCount };
@@ -59,12 +59,12 @@ class WorkflowCommandGenerator {
       return { artifacts: [], counts: { commands: 0, launchers: 0 } };
     }
 
-    // Filter to only standalone workflows
-    const standaloneWorkflows = workflows.filter((w) => w.standalone === 'true' || w.standalone === true);
+    // ALL workflows now generate commands - no standalone filtering
+    const allWorkflows = workflows;
 
     const artifacts = [];
 
-    for (const workflow of standaloneWorkflows) {
+    for (const workflow of allWorkflows) {
       const commandContent = await this.generateCommandContent(workflow, bmadDir);
       artifacts.push({
         type: 'workflow-command',
@@ -75,7 +75,7 @@ class WorkflowCommandGenerator {
       });
     }
 
-    const groupedWorkflows = this.groupWorkflowsByModule(standaloneWorkflows);
+    const groupedWorkflows = this.groupWorkflowsByModule(allWorkflows);
     for (const [module, launcherContent] of Object.entries(this.buildModuleWorkflowLaunchers(groupedWorkflows))) {
       artifacts.push({
         type: 'workflow-launcher',
@@ -89,7 +89,7 @@ class WorkflowCommandGenerator {
     return {
       artifacts,
       counts: {
-        commands: standaloneWorkflows.length,
+        commands: allWorkflows.length,
         launchers: Object.keys(groupedWorkflows).length,
       },
     };
@@ -99,8 +99,13 @@ class WorkflowCommandGenerator {
    * Generate command content for a workflow
    */
   async generateCommandContent(workflow, bmadDir) {
-    // Load the template
-    const template = await fs.readFile(this.templatePath, 'utf8');
+    // Determine template based on workflow file type
+    const isMarkdownWorkflow = workflow.path.endsWith('workflow.md');
+    const templateName = isMarkdownWorkflow ? 'workflow-commander.md' : 'workflow-command-template.md';
+    const templatePath = path.join(path.dirname(this.templatePath), templateName);
+
+    // Load the appropriate template
+    const template = await fs.readFile(templatePath, 'utf8');
 
     // Convert source path to installed path
     // From: /Users/.../src/modules/bmm/workflows/.../workflow.yaml
@@ -127,8 +132,7 @@ class WorkflowCommandGenerator {
       .replaceAll('{{description}}', workflow.description)
       .replaceAll('{{workflow_path}}', workflowPath)
       .replaceAll('{bmad_folder}', this.bmadFolderName)
-      .replaceAll('{{interactive}}', workflow.interactive)
-      .replaceAll('{{author}}', workflow.author || 'BMAD');
+      .replaceAll('{*bmad_folder*}', '{bmad_folder}');
   }
 
   /**

package/tools/cli/installers/lib/ide/templates/agent-command-template.md

@@ -6,7 +6,7 @@ description: '{{description}}'
 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 @{bmad_folder}/{{module}}/agents/{{name}}.md
+1. LOAD the FULL agent file from @{bmad_folder}/{{module}}/agents/{{path}}
 2. READ its entire contents - this contains the complete agent persona, menu, and instructions
 3. Execute ALL activation steps exactly as written in the agent file
 4. Follow the agent's persona and menu system precisely

package/tools/cli/installers/lib/ide/templates/workflow-commander.md

@@ -0,0 +1,5 @@
+---
+description: '{{description}}'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{{workflow_path}}, READ its entire contents and follow its directions exactly!