bmad-method 6.0.0-alpha.1 → 6.0.0-alpha.11

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

@@ -4,10 +4,9 @@ const os = require('node:os');
 const chalk = require('chalk');
 const yaml = require('js-yaml');
 const { BaseIdeSetup } = require('./_base-ide');
-const { WorkflowCommandGenerator } = require('./workflow-command-generator');
-const { TaskToolCommandGenerator } = require('./task-tool-command-generator');
-
-const { getAgentsFromBmad } = require('./shared/bmad-artifacts');
+const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');
+const { TaskToolCommandGenerator } = require('./shared/task-tool-command-generator');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * OpenCode IDE setup handler
@@ -33,26 +32,23 @@ class OpenCodeSetup extends BaseIdeSetup {
     // Clean up any existing BMAD files before reinstalling
     await this.cleanup(projectDir);
 
+    // Generate agent launchers
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
+
     // Install primary agents with flat naming: bmad-agent-{module}-{name}.md
     // OpenCode agents go in the agent folder (not command folder)
-    const agents = await getAgentsFromBmad(bmadDir, options.selectedModules || []);
-
     let agentCount = 0;
-    for (const agent of agents) {
-      const processed = await this.readAndProcess(agent.path, {
-        module: agent.module,
-        name: agent.name,
-      });
-
-      const agentContent = this.createAgentContent(processed, agent);
+    for (const artifact of agentArtifacts) {
+      const agentContent = artifact.content;
       // Flat structure in agent folder: bmad-agent-{module}-{name}.md
-      const targetPath = path.join(agentsBaseDir, `bmad-agent-${agent.module}-${agent.name}.md`);
+      const targetPath = path.join(agentsBaseDir, `bmad-agent-${artifact.module}-${artifact.name}.md`);
       await this.writeFile(targetPath, agentContent);
       agentCount++;
     }
 
     // Install workflow commands with flat naming: bmad-workflow-{module}-{name}.md
-    const workflowGenerator = new WorkflowCommandGenerator();
+    const workflowGenerator = new WorkflowCommandGenerator(this.bmadFolderName);
     const { artifacts: workflowArtifacts, counts: workflowCounts } = await workflowGenerator.collectWorkflowArtifacts(bmadDir);
 
     let workflowCommandCount = 0;
@@ -127,7 +123,7 @@ class OpenCodeSetup extends BaseIdeSetup {
     return this.processContent(content, metadata);
   }
 
-  createAgentContent(content, metadata) {
+  async createAgentContent(content, metadata) {
     const { frontmatter = {}, body } = this.parseFrontmatter(content);
 
     frontmatter.description =
@@ -140,7 +136,10 @@ class OpenCodeSetup extends BaseIdeSetup {
 
     const frontmatterString = this.stringifyFrontmatter(frontmatter);
 
-    return `${frontmatterString}\n${body}`;
+    // Get the activation header from central template
+    const activationHeader = await this.getAgentCommandHeader();
+
+    return `${frontmatterString}\n\n${activationHeader}\n\n${body}`;
   }
 
   parseFrontmatter(content) {
@@ -208,6 +207,51 @@ class OpenCodeSetup extends BaseIdeSetup {
       console.log(chalk.dim(`  Cleaned up ${removed} existing BMAD files`));
     }
   }
+
+  /**
+   * Install a custom agent launcher for OpenCode
+   * @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 agentsDir = path.join(projectDir, this.configDir, this.agentsDir);
+
+    if (!(await this.exists(path.join(projectDir, this.configDir)))) {
+      return null; // IDE not configured for this project
+    }
+
+    await this.ensureDir(agentsDir);
+
+    const launcherContent = `---
+name: '${agentName}'
+description: '${metadata.title || agentName} agent'
+mode: 'primary'
+---
+
+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>
+`;
+
+    // OpenCode uses flat naming: bmad-agent-custom-{name}.md
+    const launcherPath = path.join(agentsDir, `bmad-agent-custom-${agentName}.md`);
+    await this.writeFile(launcherPath, launcherContent);
+
+    return {
+      path: launcherPath,
+      command: `bmad-agent-custom-${agentName}`,
+    };
+  }
 }
 
 module.exports = { OpenCodeSetup };

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

@@ -2,6 +2,7 @@ const path = require('node:path');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
 const { getAgentsFromBmad, getTasksFromBmad } = require('./shared/bmad-artifacts');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * Qwen Code setup handler
@@ -37,15 +38,18 @@ class QwenSetup extends BaseIdeSetup {
     // Clean up old configuration if exists
     await this.cleanupOldConfig(qwenDir);
 
-    // Get agents, tasks, tools, and workflows (standalone only for tools/workflows)
-    const agents = await getAgentsFromBmad(bmadDir, options.selectedModules || []);
+    // 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 for tools/workflows)
     const tasks = await getTasksFromBmad(bmadDir, options.selectedModules || []);
     const tools = await this.getTools(bmadDir, true);
     const workflows = await this.getWorkflows(bmadDir, true);
 
     // Create directories for each module (including standalone)
     const modules = new Set();
-    for (const item of [...agents, ...tasks, ...tools, ...workflows]) modules.add(item.module);
+    for (const item of [...agentArtifacts, ...tasks, ...tools, ...workflows]) modules.add(item.module);
 
     for (const module of modules) {
       await this.ensureDir(path.join(bmadCommandsDir, module));
@@ -55,20 +59,21 @@ class QwenSetup extends BaseIdeSetup {
       await this.ensureDir(path.join(bmadCommandsDir, module, 'workflows'));
     }
 
-    // Create TOML files for each agent
+    // Create TOML files for each agent launcher
     let agentCount = 0;
-    for (const agent of agents) {
-      const content = await this.readAndProcess(agent.path, {
-        module: agent.module,
-        name: agent.name,
+    for (const artifact of agentArtifacts) {
+      // Convert markdown launcher content to TOML format
+      const tomlContent = this.processAgentLauncherContent(artifact.content, {
+        module: artifact.module,
+        name: artifact.name,
       });
 
-      const targetPath = path.join(bmadCommandsDir, agent.module, 'agents', `${agent.name}.toml`);
+      const targetPath = path.join(bmadCommandsDir, artifact.module, 'agents', `${artifact.name}.toml`);
 
-      await this.writeFile(targetPath, content);
+      await this.writeFile(targetPath, tomlContent);
 
       agentCount++;
-      console.log(chalk.green(`  ✓ Added agent: /bmad:${agent.module}:agents:${agent.name}`));
+      console.log(chalk.green(`  ✓ Added agent: /bmad:${artifact.module}:agents:${artifact.name}`));
     }
 
     // Create TOML files for each task
@@ -204,6 +209,29 @@ class QwenSetup extends BaseIdeSetup {
     return this.processContent(content, metadata);
   }
 
+  /**
+   * Process agent launcher content and convert to TOML format
+   * @param {string} launcherContent - Launcher markdown content
+   * @param {Object} metadata - File metadata
+   * @returns {string} TOML formatted content
+   */
+  processAgentLauncherContent(launcherContent, metadata = {}) {
+    // Strip frontmatter from launcher content
+    const frontmatterRegex = /^---\s*\n[\s\S]*?\n---\s*\n/;
+    const contentWithoutFrontmatter = launcherContent.replace(frontmatterRegex, '');
+
+    // Extract title for TOML description
+    const titleMatch = launcherContent.match(/description:\s*"([^"]+)"/);
+    const title = titleMatch ? titleMatch[1] : metadata.name;
+
+    // Create TOML with launcher content (without frontmatter)
+    return `description = "BMAD ${metadata.module.toUpperCase()} Agent: ${title}"
+prompt = """
+${contentWithoutFrontmatter.trim()}
+"""
+`;
+  }
+
   /**
    * Override processContent to add TOML metadata header for Qwen
    * @param {string} content - File content

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

@@ -1,7 +1,7 @@
 const path = require('node:path');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
-const inquirer = require('inquirer');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * Roo IDE setup handler
@@ -35,31 +35,6 @@ class RooSetup extends BaseIdeSetup {
     };
   }
 
-  /**
-   * Collect configuration choices before installation
-   * @param {Object} options - Configuration options
-   * @returns {Object} Collected configuration
-   */
-  async collectConfiguration(options = {}) {
-    const response = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'permissions',
-        message: 'Select default file edit permissions for BMAD agents:',
-        choices: [
-          { name: 'Development files only (js, ts, py, etc.)', value: 'dev' },
-          { name: 'Configuration files only (json, yaml, xml, etc.)', value: 'config' },
-          { name: 'Documentation files only (md, txt, doc, etc.)', value: 'docs' },
-          { name: 'All files (unrestricted access)', value: 'all' },
-          { name: 'Custom per agent (will be configured individually)', value: 'custom' },
-        ],
-        default: 'dev',
-      },
-    ]);
-
-    return { permissions: response.permissions };
-  }
-
   /**
    * Setup Roo IDE configuration
    * @param {string} projectDir - Project directory
@@ -84,20 +59,20 @@ class RooSetup extends BaseIdeSetup {
       console.log(chalk.yellow(`Found existing .roomodes file with ${existingModes.length} modes`));
     }
 
-    // Get agents
-    const agents = await this.getAgents(bmadDir);
+    // Generate agent launchers (though Roo will reference the actual .bmad agents)
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
 
-    // Use pre-collected configuration if available
-    const config = options.preCollectedConfig || {};
-    let permissionChoice = config.permissions || options.permissions || 'dev';
+    // 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 agent of agents) {
-      const slug = `bmad-${agent.module}-${agent.name}`;
+    for (const artifact of agentArtifacts) {
+      const slug = `bmad-${artifact.module}-${artifact.name}`;
 
       // Skip if already exists
       if (existingModes.includes(slug)) {
@@ -106,8 +81,17 @@ class RooSetup extends BaseIdeSetup {
         continue;
       }
 
-      const content = await this.readFile(agent.path);
-      const modeEntry = this.createModeEntry(agent, content, permissionChoice, projectDir);
+      // Read the actual agent file from .bmad for metadata extraction
+      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,
+      );
 
       newModesContent += modeEntry;
       addedCount++;
@@ -133,8 +117,9 @@ class RooSetup extends BaseIdeSetup {
       console.log(chalk.dim(`  - ${skippedCount} modes skipped (already exist)`));
     }
     console.log(chalk.dim(`  - Configuration file: ${this.configFile}`));
-    console.log(chalk.dim(`  - Permission level: ${permissionChoice}`));
-    console.log(chalk.dim('\n  Modes will be available when you open this project in Roo Code'));
+    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`));
 
     return {
       success: true,
@@ -143,33 +128,10 @@ class RooSetup extends BaseIdeSetup {
     };
   }
 
-  /**
-   * Ask user about permission configuration
-   */
-  async askPermissions() {
-    const response = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'permissions',
-        message: 'Select default file edit permissions for BMAD agents:',
-        choices: [
-          { name: 'Development files only (js, ts, py, etc.)', value: 'dev' },
-          { name: 'Configuration files only (json, yaml, xml, etc.)', value: 'config' },
-          { name: 'Documentation files only (md, txt, doc, etc.)', value: 'docs' },
-          { name: 'All files (unrestricted access)', value: 'all' },
-          { name: 'Custom per agent (will be configured individually)', value: 'custom' },
-        ],
-        default: 'dev',
-      },
-    ]);
-
-    return response.permissions;
-  }
-
   /**
    * Create a mode entry for an agent
    */
-  createModeEntry(agent, content, permissionChoice, projectDir) {
+  async createModeEntry(agent, content, permissionChoice, projectDir) {
     // Extract metadata from agent content
     const titleMatch = content.match(/title="([^"]+)"/);
     const title = titleMatch ? titleMatch[1] : this.formatTitle(agent.name);
@@ -180,6 +142,9 @@ 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]
@@ -202,7 +167,7 @@ class RooSetup extends BaseIdeSetup {
 
     modeEntry += `   roleDefinition: ${roleDefinition}\n`;
     modeEntry += `   whenToUse: ${whenToUse}\n`;
-    modeEntry += `   customInstructions: CRITICAL 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 += `   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`;
 

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

@@ -0,0 +1,90 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const chalk = require('chalk');
+
+/**
+ * Generates launcher command files for each agent
+ * Similar to WorkflowCommandGenerator but for agents
+ */
+class AgentCommandGenerator {
+  constructor(bmadFolderName = 'bmad') {
+    this.templatePath = path.join(__dirname, '../templates/agent-command-template.md');
+    this.bmadFolderName = bmadFolderName;
+  }
+
+  /**
+   * Collect agent artifacts for IDE installation
+   * @param {string} bmadDir - BMAD installation directory
+   * @param {Array} selectedModules - Modules to include
+   * @returns {Object} Artifacts array with metadata
+   */
+  async collectAgentArtifacts(bmadDir, selectedModules = []) {
+    const { getAgentsFromBmad } = require('./bmad-artifacts');
+
+    // Get agents from INSTALLED bmad/ directory
+    const agents = await getAgentsFromBmad(bmadDir, selectedModules);
+
+    const artifacts = [];
+
+    for (const agent of agents) {
+      const launcherContent = await this.generateLauncherContent(agent);
+      artifacts.push({
+        type: 'agent-launcher',
+        module: agent.module,
+        name: agent.name,
+        relativePath: path.join(agent.module, 'agents', `${agent.name}.md`),
+        content: launcherContent,
+        sourcePath: agent.path,
+      });
+    }
+
+    return {
+      artifacts,
+      counts: {
+        agents: agents.length,
+      },
+    };
+  }
+
+  /**
+   * Generate launcher content for an agent
+   * @param {Object} agent - Agent metadata
+   * @returns {string} Launcher file content
+   */
+  async generateLauncherContent(agent) {
+    // Load the template
+    const template = await fs.readFile(this.templatePath, 'utf8');
+
+    // Replace template variables
+    return template
+      .replaceAll('{{name}}', agent.name)
+      .replaceAll('{{module}}', agent.module)
+      .replaceAll('{{description}}', agent.description || `${agent.name} agent`)
+      .replaceAll('{bmad_folder}', this.bmadFolderName);
+  }
+
+  /**
+   * Write agent launcher artifacts to IDE commands directory
+   * @param {string} baseCommandsDir - Base commands directory for the IDE
+   * @param {Array} artifacts - Agent launcher artifacts
+   * @returns {number} Count of launchers written
+   */
+  async writeAgentLaunchers(baseCommandsDir, artifacts) {
+    let writtenCount = 0;
+
+    for (const artifact of artifacts) {
+      if (artifact.type === 'agent-launcher') {
+        const moduleAgentsDir = path.join(baseCommandsDir, artifact.module, 'agents');
+        await fs.ensureDir(moduleAgentsDir);
+
+        const launcherPath = path.join(moduleAgentsDir, `${artifact.name}.md`);
+        await fs.writeFile(launcherPath, artifact.content);
+        writtenCount++;
+      }
+    }
+
+    return writtenCount;
+  }
+}
+
+module.exports = { AgentCommandGenerator };

package/tools/cli/installers/lib/ide/{task-tool-command-generator.js → shared/task-tool-command-generator.js}

@@ -4,7 +4,7 @@ const csv = require('csv-parse/sync');
 const chalk = require('chalk');
 
 /**
- * Generates Claude Code command files for standalone tasks and tools
+ * Generates command files for standalone tasks and tools
  */
 class TaskToolCommandGenerator {
   /**

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

@@ -4,11 +4,12 @@ const csv = require('csv-parse/sync');
 const chalk = require('chalk');
 
 /**
- * Generates Claude Code command files for each workflow in the manifest
+ * Generates command files for each workflow in the manifest
  */
 class WorkflowCommandGenerator {
-  constructor() {
-    this.templatePath = path.join(__dirname, 'workflow-command-template.md');
+  constructor(bmadFolderName = 'bmad') {
+    this.templatePath = path.join(__dirname, '../templates/workflow-command-template.md');
+    this.bmadFolderName = bmadFolderName;
   }
 
   /**
@@ -103,19 +104,19 @@ class WorkflowCommandGenerator {
 
     // Convert source path to installed path
     // From: /Users/.../src/modules/bmm/workflows/.../workflow.yaml
-    // To: {project-root}/bmad/bmm/workflows/.../workflow.yaml
+    // To: {project-root}/{bmad_folder}/bmm/workflows/.../workflow.yaml
     let workflowPath = workflow.path;
 
     // Extract the relative path from source
     if (workflowPath.includes('/src/modules/')) {
       const match = workflowPath.match(/\/src\/modules\/(.+)/);
       if (match) {
-        workflowPath = `{project-root}/bmad/${match[1]}`;
+        workflowPath = `${this.bmadFolderName}/${match[1]}`;
       }
     } else if (workflowPath.includes('/src/core/')) {
       const match = workflowPath.match(/\/src\/core\/(.+)/);
       if (match) {
-        workflowPath = `{project-root}/bmad/core/${match[1]}`;
+        workflowPath = `${this.bmadFolderName}/core/${match[1]}`;
       }
     }
 
@@ -125,6 +126,7 @@ class WorkflowCommandGenerator {
       .replaceAll('{{module}}', workflow.module)
       .replaceAll('{{description}}', workflow.description)
       .replaceAll('{{workflow_path}}', workflowPath)
+      .replaceAll('{bmad_folder}', this.bmadFolderName)
       .replaceAll('{{interactive}}', workflow.interactive)
       .replaceAll('{{author}}', workflow.author || 'BMAD');
   }
@@ -186,7 +188,7 @@ class WorkflowCommandGenerator {
 ## Execution
 
 When running any workflow:
-1. LOAD {project-root}/bmad/core/tasks/workflow.xml
+1. LOAD {project-root}/${this.bmadFolderName}/core/tasks/workflow.xml
 2. Pass the workflow path as 'workflow-config' parameter
 3. Follow workflow.xml instructions EXACTLY
 4. Save outputs after EACH section
@@ -205,12 +207,12 @@ When running any workflow:
     if (workflowPath.includes('/src/modules/')) {
       const match = workflowPath.match(/\/src\/modules\/(.+)/);
       if (match) {
-        transformed = `{project-root}/bmad/${match[1]}`;
+        transformed = `{project-root}/${this.bmadFolderName}/${match[1]}`;
       }
     } else if (workflowPath.includes('/src/core/')) {
       const match = workflowPath.match(/\/src\/core\/(.+)/);
       if (match) {
-        transformed = `{project-root}/bmad/core/${match[1]}`;
+        transformed = `{project-root}/${this.bmadFolderName}/core/${match[1]}`;
       }
     }
 

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

@@ -0,0 +1,14 @@
+---
+name: '{{name}}'
+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
+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
+5. Stay in character throughout the session
+</agent-activation>

package/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml

@@ -0,0 +1,14 @@
+description = "Activates the {{title}} agent from the BMad Method."
+prompt = """
+CRITICAL: You are now the BMad '{{title}}' agent.
+
+PRE-FLIGHT CHECKLIST:
+1.  [ ] IMMEDIATE ACTION: Load and parse @{{bmad_folder}}/{{module}}/config.yaml - store ALL config values in memory for use throughout the session.
+2.  [ ] IMMEDIATE ACTION: Read and internalize the full agent definition at @{{bmad_folder}}/{{module}}/agents/{{name}}.md.
+3.  [ ] CONFIRM: The user's name from config is {user_name}.
+
+Only after all checks are complete, greet the user by name and display the menu.
+Acknowledge this checklist is complete in your first response.
+
+AGENT DEFINITION: @{{bmad_folder}}/{{module}}/agents/{{name}}.md
+"""

package/tools/cli/installers/lib/ide/templates/gemini-task-command.toml

@@ -0,0 +1,12 @@
+description = "Executes the {{taskName}} task from the BMad Method."
+prompt = """
+Execute the following BMad Method task workflow:
+
+PRE-FLIGHT CHECKLIST:
+1.  [ ] IMMEDIATE ACTION: Load and parse @{{bmad_folder}}/{{module}}/config.yaml.
+2.  [ ] IMMEDIATE ACTION: Read and load the task definition at @{{bmad_folder}}/{{module}}/tasks/{{filename}}.
+
+Follow all instructions and complete the task as defined.
+
+TASK DEFINITION: @{{bmad_folder}}/{{module}}/tasks/{{filename}}
+"""

package/tools/cli/installers/lib/ide/{workflow-command-template.md → templates/workflow-command-template.md}

@@ -2,14 +2,12 @@
 description: '{{description}}'
 ---
 
-# {{name}}
-
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
 
 <steps CRITICAL="TRUE">
-1. Always LOAD the FULL {project-root}/bmad/core/tasks/workflow.xml
-2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config {{workflow_path}}
+1. Always LOAD the FULL @{bmad_folder}/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{{workflow_path}}
 3. Pass the yaml path {{workflow_path}} as 'workflow-config' parameter to the workflow.xml instructions
-4. Follow workflow.xml instructions EXACTLY as written
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
 5. Save outputs after EACH section when generating any documents from templates
 </steps>