bmad-method 6.0.3 → 6.0.5-next.0

package/tools/cli/installers/lib/ide/shared/skill-manifest.js

@@ -0,0 +1,90 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const yaml = require('yaml');
+
+/**
+ * Load bmad-skill-manifest.yaml from a directory.
+ * Single-entry manifests (canonicalId at top level) apply to all files in the directory.
+ * Multi-entry manifests are keyed by source filename.
+ * @param {string} dirPath - Directory to check for bmad-skill-manifest.yaml
+ * @returns {Object|null} Parsed manifest or null
+ */
+async function loadSkillManifest(dirPath) {
+  const manifestPath = path.join(dirPath, 'bmad-skill-manifest.yaml');
+  try {
+    if (!(await fs.pathExists(manifestPath))) return null;
+    const content = await fs.readFile(manifestPath, 'utf8');
+    const parsed = yaml.parse(content);
+    if (!parsed || typeof parsed !== 'object') return null;
+    if (parsed.canonicalId || parsed.type) return { __single: parsed };
+    return parsed;
+  } catch (error) {
+    console.warn(`Warning: Failed to parse bmad-skill-manifest.yaml in ${dirPath}: ${error.message}`);
+    return null;
+  }
+}
+
+/**
+ * Get the canonicalId for a specific file from a loaded skill manifest.
+ * @param {Object|null} manifest - Loaded manifest (from loadSkillManifest)
+ * @param {string} filename - Source filename to look up (e.g., 'pm.md', 'help.md', 'pm.agent.yaml')
+ * @returns {string} canonicalId or empty string
+ */
+function getCanonicalId(manifest, filename) {
+  if (!manifest) return '';
+  // Single-entry manifest applies to all files in the directory
+  if (manifest.__single) return manifest.__single.canonicalId || '';
+  // Multi-entry: look up by filename directly
+  if (manifest[filename]) return manifest[filename].canonicalId || '';
+  // Fallback: try alternate extensions for compiled files
+  const baseName = filename.replace(/\.(md|xml)$/i, '');
+  const agentKey = `${baseName}.agent.yaml`;
+  if (manifest[agentKey]) return manifest[agentKey].canonicalId || '';
+  const xmlKey = `${baseName}.xml`;
+  if (manifest[xmlKey]) return manifest[xmlKey].canonicalId || '';
+  return '';
+}
+
+/**
+ * Get the artifact type for a specific file from a loaded skill manifest.
+ * @param {Object|null} manifest - Loaded manifest (from loadSkillManifest)
+ * @param {string} filename - Source filename to look up
+ * @returns {string|null} type or null
+ */
+function getArtifactType(manifest, filename) {
+  if (!manifest) return null;
+  // Single-entry manifest applies to all files in the directory
+  if (manifest.__single) return manifest.__single.type || null;
+  // Multi-entry: look up by filename directly
+  if (manifest[filename]) return manifest[filename].type || null;
+  // Fallback: try alternate extensions for compiled files
+  const baseName = filename.replace(/\.(md|xml)$/i, '');
+  const agentKey = `${baseName}.agent.yaml`;
+  if (manifest[agentKey]) return manifest[agentKey].type || null;
+  const xmlKey = `${baseName}.xml`;
+  if (manifest[xmlKey]) return manifest[xmlKey].type || null;
+  return null;
+}
+
+/**
+ * Get the install_to_bmad flag for a specific file from a loaded skill manifest.
+ * @param {Object|null} manifest - Loaded manifest (from loadSkillManifest)
+ * @param {string} filename - Source filename to look up
+ * @returns {boolean} install_to_bmad value (defaults to true)
+ */
+function getInstallToBmad(manifest, filename) {
+  if (!manifest) return true;
+  // Single-entry manifest applies to all files in the directory
+  if (manifest.__single) return manifest.__single.install_to_bmad !== false;
+  // Multi-entry: look up by filename directly
+  if (manifest[filename]) return manifest[filename].install_to_bmad !== false;
+  // Fallback: try alternate extensions for compiled files
+  const baseName = filename.replace(/\.(md|xml)$/i, '');
+  const agentKey = `${baseName}.agent.yaml`;
+  if (manifest[agentKey]) return manifest[agentKey].install_to_bmad !== false;
+  const xmlKey = `${baseName}.xml`;
+  if (manifest[xmlKey]) return manifest[xmlKey].install_to_bmad !== false;
+  return true;
+}
+
+module.exports = { loadSkillManifest, getCanonicalId, getArtifactType, getInstallToBmad };

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

@@ -50,6 +50,7 @@ class TaskToolCommandGenerator {
         displayName: task.displayName || task.name,
         description: task.description || `Execute ${task.displayName || task.name}`,
         module: task.module,
+        canonicalId: task.canonicalId || '',
         // Use forward slashes for cross-platform consistency (not path.join which uses backslashes on Windows)
         relativePath: `${task.module}/tasks/${task.name}${taskExt}`,
         path: taskPath,
@@ -75,6 +76,7 @@ class TaskToolCommandGenerator {
         displayName: tool.displayName || tool.name,
         description: tool.description || `Execute ${tool.displayName || tool.name}`,
         module: tool.module,
+        canonicalId: tool.canonicalId || '',
         // Use forward slashes for cross-platform consistency (not path.join which uses backslashes on Windows)
         relativePath: `${tool.module}/tools/${tool.name}${toolExt}`,
         path: toolPath,

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

@@ -1,58 +1,16 @@
 const path = require('node:path');
 const fs = require('fs-extra');
 const csv = require('csv-parse/sync');
-const prompts = require('../../../../lib/prompts');
-const { toColonPath, toDashPath, customAgentColonName, customAgentDashName, BMAD_FOLDER_NAME } = require('./path-utils');
+const { BMAD_FOLDER_NAME } = require('./path-utils');
 
 /**
  * Generates command files for each workflow in the manifest
  */
 class WorkflowCommandGenerator {
   constructor(bmadFolderName = BMAD_FOLDER_NAME) {
-    this.templatePath = path.join(__dirname, '../templates/workflow-command-template.md');
     this.bmadFolderName = bmadFolderName;
   }
 
-  /**
-   * Generate workflow commands from the manifest CSV
-   * @param {string} projectDir - Project directory
-   * @param {string} bmadDir - BMAD installation directory
-   */
-  async generateWorkflowCommands(projectDir, bmadDir) {
-    const workflows = await this.loadWorkflowManifest(bmadDir);
-
-    if (!workflows) {
-      await prompts.log.warn('Workflow manifest not found. Skipping command generation.');
-      return { generated: 0 };
-    }
-
-    // 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 workflow, organized by module
-    for (const workflow of allWorkflows) {
-      const moduleWorkflowsDir = path.join(baseCommandsDir, workflow.module, 'workflows');
-      await fs.ensureDir(moduleWorkflowsDir);
-
-      const commandContent = await this.generateCommandContent(workflow, bmadDir);
-      const commandPath = path.join(moduleWorkflowsDir, `${workflow.name}.md`);
-
-      await fs.writeFile(commandPath, commandContent);
-      generatedCount++;
-    }
-
-    // Also create a workflow launcher README in each module
-    const groupedWorkflows = this.groupWorkflowsByModule(allWorkflows);
-    await this.createModuleWorkflowLaunchers(baseCommandsDir, groupedWorkflows);
-
-    return { generated: generatedCount };
-  }
-
   async collectWorkflowArtifacts(bmadDir) {
     const workflows = await this.loadWorkflowManifest(bmadDir);
 
@@ -66,8 +24,7 @@ class WorkflowCommandGenerator {
     const artifacts = [];
 
     for (const workflow of allWorkflows) {
-      const commandContent = await this.generateCommandContent(workflow, bmadDir);
-      // Calculate the relative workflow path (e.g., bmm/workflows/4-implementation/sprint-planning/workflow.yaml)
+      // Calculate the relative workflow path (e.g., bmm/workflows/4-implementation/sprint-planning/workflow.md)
       let workflowRelPath = workflow.path || '';
       // Normalize path separators for cross-platform compatibility
       workflowRelPath = workflowRelPath.replaceAll('\\', '/');
@@ -85,17 +42,14 @@ class WorkflowCommandGenerator {
           workflowRelPath = `${match[1]}/${match[2]}`;
         }
       }
-      // Determine if this is a YAML workflow (use normalized path which is guaranteed to be a string)
-      const isYamlWorkflow = workflowRelPath.endsWith('.yaml') || workflowRelPath.endsWith('.yml');
       artifacts.push({
         type: 'workflow-command',
-        isYamlWorkflow: isYamlWorkflow, // For template selection
         name: workflow.name,
         description: workflow.description || `${workflow.name} workflow`,
         module: workflow.module,
+        canonicalId: workflow.canonicalId || '',
         relativePath: path.join(workflow.module, 'workflows', `${workflow.name}.md`),
         workflowPath: workflowRelPath, // Relative path to actual workflow file
-        content: commandContent,
         sourcePath: workflow.path,
       });
     }
@@ -120,46 +74,6 @@ class WorkflowCommandGenerator {
     };
   }
 
-  /**
-   * Generate command content for a workflow
-   */
-  async generateCommandContent(workflow, bmadDir) {
-    // 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/bmm/workflows/.../workflow.yaml
-    // To: {project-root}/_bmad/bmm/workflows/.../workflow.yaml
-    let workflowPath = workflow.path;
-
-    // Extract the relative path from source
-    if (workflowPath.includes('/src/bmm/')) {
-      // bmm is directly under src/
-      const match = workflowPath.match(/\/src\/bmm\/(.+)/);
-      if (match) {
-        workflowPath = `${this.bmadFolderName}/bmm/${match[1]}`;
-      }
-    } else if (workflowPath.includes('/src/core/')) {
-      const match = workflowPath.match(/\/src\/core\/(.+)/);
-      if (match) {
-        workflowPath = `${this.bmadFolderName}/core/${match[1]}`;
-      }
-    }
-
-    // Replace template variables
-    return template
-      .replaceAll('{{name}}', workflow.name)
-      .replaceAll('{{module}}', workflow.module)
-      .replaceAll('{{description}}', workflow.description)
-      .replaceAll('{{workflow_path}}', workflowPath)
-      .replaceAll('_bmad', this.bmadFolderName);
-  }
-
   /**
    * Create workflow launcher files for each module
    */
@@ -217,10 +131,9 @@ class WorkflowCommandGenerator {
 ## Execution
 
 When running any workflow:
-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
+1. LOAD the workflow.md file at the path shown above
+2. READ its entire contents and follow its directions exactly
+3. Save outputs after EACH section
 
 ## Modes
 - Normal: Full interaction
@@ -261,58 +174,6 @@ When running any workflow:
       skip_empty_lines: true,
     });
   }
-
-  /**
-   * Write workflow command artifacts using underscore format (Windows-compatible)
-   * Creates flat files like: bmad_bmm_correct-course.md
-   *
-   * @param {string} baseCommandsDir - Base commands directory for the IDE
-   * @param {Array} artifacts - Workflow artifacts
-   * @returns {number} Count of commands written
-   */
-  async writeColonArtifacts(baseCommandsDir, artifacts) {
-    let writtenCount = 0;
-
-    for (const artifact of artifacts) {
-      if (artifact.type === 'workflow-command') {
-        // Convert relativePath to underscore format: bmm/workflows/correct-course.md → bmad_bmm_correct-course.md
-        const flatName = toColonPath(artifact.relativePath);
-        const commandPath = path.join(baseCommandsDir, flatName);
-        await fs.ensureDir(path.dirname(commandPath));
-        await fs.writeFile(commandPath, artifact.content);
-        writtenCount++;
-      }
-    }
-
-    return writtenCount;
-  }
-
-  /**
-   * Write workflow command artifacts using dash format (NEW STANDARD)
-   * Creates flat files like: bmad-bmm-correct-course.md
-   *
-   * Note: Workflows do NOT have bmad-agent- prefix - only agents do.
-   *
-   * @param {string} baseCommandsDir - Base commands directory for the IDE
-   * @param {Array} artifacts - Workflow artifacts
-   * @returns {number} Count of commands written
-   */
-  async writeDashArtifacts(baseCommandsDir, artifacts) {
-    let writtenCount = 0;
-
-    for (const artifact of artifacts) {
-      if (artifact.type === 'workflow-command') {
-        // Convert relativePath to dash format: bmm/workflows/correct-course.md → bmad-bmm-correct-course.md
-        const flatName = toDashPath(artifact.relativePath);
-        const commandPath = path.join(baseCommandsDir, flatName);
-        await fs.ensureDir(path.dirname(commandPath));
-        await fs.writeFile(commandPath, artifact.content);
-        writtenCount++;
-      }
-    }
-
-    return writtenCount;
-  }
 }
 
 module.exports = { WorkflowCommandGenerator };

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/{{module}}/agents/{{path}}
+1. LOAD the FULL agent file from {project-root}/_bmad/{{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/combined/default-workflow.md

@@ -3,4 +3,4 @@ name: '{{name}}'
 description: '{{description}}'
 ---
 
-IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/{{bmadFolderName}}/{{path}}, READ its entire contents and follow its directions exactly!
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/{{bmadFolderName}}/{{path}}, READ its entire contents and follow its directions exactly!

package/tools/cli/installers/lib/ide/templates/combined/gemini-workflow-yaml.toml

@@ -1,4 +1,4 @@
-description = """{{description}}"""
+description = '{{description}}'
 prompt = """
 Execute the BMAD '{{name}}' workflow.
 

package/tools/cli/installers/lib/ide/templates/combined/gemini-workflow.toml

@@ -1,4 +1,4 @@
-description = """{{description}}"""
+description = '{{description}}'
 prompt = """
 Execute the BMAD '{{name}}' workflow.
 

package/tools/cli/installers/lib/ide/templates/combined/opencode-agent.md

@@ -1,5 +1,5 @@
 ---
-name: '{{name}}'
+mode: all
 description: '{{description}}'
 ---
 

package/tools/cli/installers/lib/ide/templates/combined/opencode-task.md

@@ -1,5 +1,4 @@
 ---
-name: '{{name}}'
 description: '{{description}}'
 ---
 

package/tools/cli/installers/lib/ide/templates/combined/opencode-tool.md

@@ -1,5 +1,4 @@
 ---
-name: '{{name}}'
 description: '{{description}}'
 ---
 

package/tools/cli/installers/lib/ide/templates/combined/opencode-workflow-yaml.md

@@ -1,5 +1,4 @@
 ---
-name: '{{name}}'
 description: '{{description}}'
 ---
 

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

@@ -1,5 +1,4 @@
 ---
-name: '{{name}}'
 description: '{{description}}'
 ---
 

package/tools/cli/installers/lib/modules/manager.js

@@ -762,14 +762,8 @@ class ModuleManager {
         }
       }
 
-      // Check if this is a workflow.yaml file
-      if (file.endsWith('workflow.yaml')) {
-        await fs.ensureDir(path.dirname(targetFile));
-        await this.copyWorkflowYamlStripped(sourceFile, targetFile);
-      } else {
-        // Copy the file with placeholder replacement
-        await this.copyFileWithPlaceholderReplacement(sourceFile, targetFile);
-      }
+      // Copy the file with placeholder replacement
+      await this.copyFileWithPlaceholderReplacement(sourceFile, targetFile);
 
       // Track the file if callback provided
       if (fileTrackingCallback) {
@@ -778,92 +772,6 @@ class ModuleManager {
     }
   }
 
-  /**
-   * Copy workflow.yaml file with web_bundle section stripped
-   * Preserves comments, formatting, and line breaks
-   * @param {string} sourceFile - Source workflow.yaml file path
-   * @param {string} targetFile - Target workflow.yaml file path
-   */
-  async copyWorkflowYamlStripped(sourceFile, targetFile) {
-    // Read the source YAML file
-    let yamlContent = await fs.readFile(sourceFile, 'utf8');
-
-    // IMPORTANT: Replace escape sequence and placeholder BEFORE parsing YAML
-    // Otherwise parsing will fail on the placeholder
-    yamlContent = yamlContent.replaceAll('_bmad', this.bmadFolderName);
-
-    try {
-      // First check if web_bundle exists by parsing
-      const workflowConfig = yaml.parse(yamlContent);
-
-      if (workflowConfig.web_bundle === undefined) {
-        // No web_bundle section, just write (placeholders already replaced above)
-        await fs.writeFile(targetFile, yamlContent, 'utf8');
-        return;
-      }
-
-      // Find the line that starts web_bundle
-      const lines = yamlContent.split('\n');
-      let startIdx = -1;
-      let endIdx = -1;
-      let baseIndent = 0;
-
-      // Find the start of web_bundle section
-      for (const [i, line] of lines.entries()) {
-        const match = line.match(/^(\s*)web_bundle:/);
-        if (match) {
-          startIdx = i;
-          baseIndent = match[1].length;
-          break;
-        }
-      }
-
-      if (startIdx === -1) {
-        // web_bundle not found in text (shouldn't happen), copy as-is
-        await fs.writeFile(targetFile, yamlContent, 'utf8');
-        return;
-      }
-
-      // Find the end of web_bundle section
-      // It ends when we find a line with same or less indentation that's not empty/comment
-      endIdx = startIdx;
-      for (let i = startIdx + 1; i < lines.length; i++) {
-        const line = lines[i];
-
-        // Skip empty lines and comments
-        if (line.trim() === '' || line.trim().startsWith('#')) {
-          continue;
-        }
-
-        // Check indentation
-        const indent = line.match(/^(\s*)/)[1].length;
-        if (indent <= baseIndent) {
-          // Found next section at same or lower indentation
-          endIdx = i - 1;
-          break;
-        }
-      }
-
-      // If we didn't find an end, it goes to end of file
-      if (endIdx === startIdx) {
-        endIdx = lines.length - 1;
-      }
-
-      // Remove the web_bundle section (including the line before if it's just a blank line)
-      const newLines = [...lines.slice(0, startIdx), ...lines.slice(endIdx + 1)];
-
-      // Clean up any double blank lines that might result
-      const strippedYaml = newLines.join('\n').replaceAll(/\n\n\n+/g, '\n\n');
-
-      // Placeholders already replaced at the beginning of this function
-      await fs.writeFile(targetFile, strippedYaml, 'utf8');
-    } catch {
-      // If anything fails, just copy the file as-is
-      await prompts.log.warn(`  Could not process ${path.basename(sourceFile)}, copying as-is`);
-      await fs.copy(sourceFile, targetFile, { overwrite: true });
-    }
-  }
-
   /**
    * Compile .agent.yaml files to .md format in modules
    * @param {string} sourcePath - Source module path
@@ -1165,13 +1073,11 @@ class ModuleManager {
       await prompts.log.message(`    Processing: ${agentFile}`);
 
       for (const item of workflowInstallItems) {
-        const sourceWorkflowPath = item.workflow; // Where to copy FROM
+        const sourceWorkflowPath = item.exec; // Where to copy FROM
         const installWorkflowPath = item['workflow-install']; // Where to copy TO
 
         // Parse SOURCE workflow path
-        // Handle both _bmad placeholder and hardcoded 'bmad'
-        // Example: {project-root}/_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml
-        // Or: {project-root}/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml
+        // Example: {project-root}/_bmad/bmm/workflows/4-implementation/create-story/workflow.md
         const sourceMatch = sourceWorkflowPath.match(/\{project-root\}\/(?:_bmad)\/([^/]+)\/workflows\/(.+)/);
         if (!sourceMatch) {
           await prompts.log.warn(`      Could not parse workflow path: ${sourceWorkflowPath}`);
@@ -1181,9 +1087,8 @@ class ModuleManager {
         const [, sourceModule, sourceWorkflowSubPath] = sourceMatch;
 
         // Parse INSTALL workflow path
-        // Handle_bmad
-        // Example: {project-root}/_bmad/bmgd/workflows/4-production/create-story/workflow.yaml
-        const installMatch = installWorkflowPath.match(/\{project-root\}\/(_bmad)\/([^/]+)\/workflows\/(.+)/);
+        // Example: {project-root}/_bmad/bmgd/workflows/4-production/create-story/workflow.md
+        const installMatch = installWorkflowPath.match(/\{project-root\}\/(?:_bmad)\/([^/]+)\/workflows\/(.+)/);
         if (!installMatch) {
           await prompts.log.warn(`      Could not parse workflow-install path: ${installWorkflowPath}`);
           continue;
@@ -1192,9 +1097,9 @@ class ModuleManager {
         const installWorkflowSubPath = installMatch[2];
 
         const sourceModulePath = getModulePath(sourceModule);
-        const actualSourceWorkflowPath = path.join(sourceModulePath, 'workflows', sourceWorkflowSubPath.replace(/\/workflow\.yaml$/, ''));
+        const actualSourceWorkflowPath = path.join(sourceModulePath, 'workflows', sourceWorkflowSubPath.replace(/\/workflow\.md$/, ''));
 
-        const actualDestWorkflowPath = path.join(targetPath, 'workflows', installWorkflowSubPath.replace(/\/workflow\.yaml$/, ''));
+        const actualDestWorkflowPath = path.join(targetPath, 'workflows', installWorkflowSubPath.replace(/\/workflow\.md$/, ''));
 
         // Check if source workflow exists
         if (!(await fs.pathExists(actualSourceWorkflowPath))) {
@@ -1204,18 +1109,12 @@ class ModuleManager {
 
         // Copy the entire workflow folder
         await prompts.log.message(
-          `      Vendoring: ${sourceModule}/workflows/${sourceWorkflowSubPath.replace(/\/workflow\.yaml$/, '')} → ${moduleName}/workflows/${installWorkflowSubPath.replace(/\/workflow\.yaml$/, '')}`,
+          `      Vendoring: ${sourceModule}/workflows/${sourceWorkflowSubPath.replace(/\/workflow\.md$/, '')} → ${moduleName}/workflows/${installWorkflowSubPath.replace(/\/workflow\.md$/, '')}`,
         );
 
         await fs.ensureDir(path.dirname(actualDestWorkflowPath));
         // Copy the workflow directory recursively with placeholder replacement
         await this.copyDirectoryWithPlaceholderReplacement(actualSourceWorkflowPath, actualDestWorkflowPath);
-
-        // Update the workflow.yaml config_source reference
-        const workflowYamlPath = path.join(actualDestWorkflowPath, 'workflow.yaml');
-        if (await fs.pathExists(workflowYamlPath)) {
-          await this.updateWorkflowConfigSource(workflowYamlPath, moduleName);
-        }
       }
     }
 
@@ -1224,28 +1123,6 @@ class ModuleManager {
     }
   }
 
-  /**
-   * Update workflow.yaml config_source to point to new module
-   * @param {string} workflowYamlPath - Path to workflow.yaml file
-   * @param {string} newModuleName - New module name to reference
-   */
-  async updateWorkflowConfigSource(workflowYamlPath, newModuleName) {
-    let yamlContent = await fs.readFile(workflowYamlPath, 'utf8');
-
-    // Replace config_source: "{project-root}/_bmad/OLD_MODULE/config.yaml"
-    // with config_source: "{project-root}/_bmad/NEW_MODULE/config.yaml"
-    // Note: At this point _bmad has already been replaced with actual folder name
-    const configSourcePattern = /config_source:\s*["']?\{project-root\}\/[^/]+\/[^/]+\/config\.yaml["']?/g;
-    const newConfigSource = `config_source: "{project-root}/${this.bmadFolderName}/${newModuleName}/config.yaml"`;
-
-    const updatedYaml = yamlContent.replaceAll(configSourcePattern, newConfigSource);
-
-    if (updatedYaml !== yamlContent) {
-      await fs.writeFile(workflowYamlPath, updatedYaml, 'utf8');
-      await prompts.log.message(`      Updated config_source to: ${this.bmadFolderName}/${newModuleName}/config.yaml`);
-    }
-  }
-
   /**
    * Create directories declared in module.yaml's `directories` key
    * This replaces the security-risky module installer pattern with declarative config

package/tools/cli/lib/agent/compiler.js

@@ -147,7 +147,6 @@ function buildMenuXml(menuItems) {
         const attrs = [`cmd="${trigger}"`];
 
         // Add handler attributes
-        if (item.workflow) attrs.push(`workflow="${item.workflow}"`);
         if (item.exec) attrs.push(`exec="${item.exec}"`);
         if (item.tmpl) attrs.push(`tmpl="${item.tmpl}"`);
         if (item.data) attrs.push(`data="${item.data}"`);
@@ -187,8 +186,6 @@ function buildNestedHandlers(triggers) {
 
       // Add handler attributes based on exec data
       if (execData.route) attrs.push(`exec="${execData.route}"`);
-      if (execData.workflow) attrs.push(`workflow="${execData.workflow}"`);
-      if (execData['validate-workflow']) attrs.push(`validate-workflow="${execData['validate-workflow']}"`);
       if (execData.action) attrs.push(`action="${execData.action}"`);
       if (execData.data) attrs.push(`data="${execData.data}"`);
       if (execData.tmpl) attrs.push(`tmpl="${execData.tmpl}"`);
@@ -212,7 +209,6 @@ function processExecArray(execArray) {
   const result = {
     description: '',
     route: null,
-    workflow: null,
     data: null,
     action: null,
     type: null,
@@ -229,12 +225,7 @@ function processExecArray(execArray) {
     }
 
     if (exec.route) {
-      // Determine if it's a workflow or exec based on file extension or context
-      if (exec.route.endsWith('.yaml') || exec.route.endsWith('.yml')) {
-        result.workflow = exec.route;
-      } else {
-        result.route = exec.route;
-      }
+      result.route = exec.route;
     }
 
     if (exec.data !== null && exec.data !== undefined) {

package/tools/cli/lib/agent-analyzer.js

@@ -39,16 +39,10 @@ class AgentAnalyzer {
             if (Array.isArray(execArray)) {
               for (const exec of execArray) {
                 if (exec.route) {
-                  // Check if route is a workflow or exec
-                  if (exec.route.endsWith('.yaml') || exec.route.endsWith('.yml')) {
-                    profile.usedAttributes.add('workflow');
-                  } else {
-                    profile.usedAttributes.add('exec');
-                  }
+                  profile.usedAttributes.add('exec');
                 }
-                if (exec.workflow) profile.usedAttributes.add('workflow');
                 if (exec.action) profile.usedAttributes.add('action');
-                if (exec.type && ['exec', 'action', 'workflow'].includes(exec.type)) {
+                if (exec.type && ['exec', 'action'].includes(exec.type)) {
                   profile.usedAttributes.add(exec.type);
                 }
               }
@@ -57,12 +51,6 @@ class AgentAnalyzer {
         }
       } else {
         // Check for each possible attribute in legacy items
-        if (item.workflow) {
-          profile.usedAttributes.add('workflow');
-        }
-        if (item['validate-workflow']) {
-          profile.usedAttributes.add('validate-workflow');
-        }
         if (item.exec) {
           profile.usedAttributes.add('exec');
         }