bmad-method 6.3.1-next.2 → 6.3.1-next.4

package/tools/installer/ide/shared/bmad-artifacts.js

@@ -1,208 +0,0 @@
-const path = require('node:path');
-const fs = require('fs-extra');
-const { loadSkillManifest, getCanonicalId } = require('./skill-manifest');
-
-/**
- * Helpers for gathering BMAD agents/tasks from the installed tree.
- * Shared by installers that need Claude-style exports.
- *
- * TODO: Dead code cleanup — compiled XML agents are retired.
- *
- * All agents now use the SKILL.md directory format with bmad-skill-manifest.yaml
- * (type: agent). The legacy pipeline below only discovers compiled .md files
- * containing <agent> XML tags, which no longer exist. The following are dead:
- *
- *   - getAgentsFromBmad()      — scans {module}/agents/ for .md files with <agent> tags
- *   - getAgentsFromDir()       — recursive helper for the above
- *   - AgentCommandGenerator    — (agent-command-generator.js) generates launcher .md files
- *                                 that tell the LLM to load a compiled agent .md file
- *   - agent-command-template.md — (templates/) the launcher template with hardcoded
- *                                 {module}/agents/{{path}} reference
- *
- * Agent metadata for agent-manifest.csv is now handled entirely by
- * ManifestGenerator.getAgentsFromDirRecursive() in manifest-generator.js,
- * which walks the full module tree and finds type:agent directories.
- *
- * IDE installation of agents is handled by the native skill pipeline —
- * each agent's SKILL.md directory is installed directly to the IDE's
- * skills path, so no launcher intermediary is needed.
- *
- * Cleanup: remove getAgentsFromBmad, getAgentsFromDir, their exports,
- * AgentCommandGenerator, agent-command-template.md, and all call sites
- * in IDE installers that invoke collectAgentArtifacts / writeAgentLaunchers /
- * writeColonArtifacts / writeDashArtifacts.
- * getTasksFromBmad and getTasksFromDir may still be live — verify before removing.
- */
-async function getAgentsFromBmad(bmadDir, selectedModules = []) {
-  const agents = [];
-
-  // Get core agents
-  if (await fs.pathExists(path.join(bmadDir, 'core', 'agents'))) {
-    const coreAgents = await getAgentsFromDir(path.join(bmadDir, 'core', 'agents'), 'core');
-    agents.push(...coreAgents);
-  }
-
-  // Get module agents
-  for (const moduleName of selectedModules) {
-    const agentsPath = path.join(bmadDir, moduleName, 'agents');
-
-    if (await fs.pathExists(agentsPath)) {
-      const moduleAgents = await getAgentsFromDir(agentsPath, moduleName);
-      agents.push(...moduleAgents);
-    }
-  }
-
-  // Get standalone agents from bmad/agents/ directory
-  const standaloneAgentsDir = path.join(bmadDir, 'agents');
-  if (await fs.pathExists(standaloneAgentsDir)) {
-    const agentDirs = await fs.readdir(standaloneAgentsDir, { withFileTypes: true });
-
-    for (const agentDir of agentDirs) {
-      if (!agentDir.isDirectory()) continue;
-
-      const agentDirPath = path.join(standaloneAgentsDir, agentDir.name);
-      const agentFiles = await fs.readdir(agentDirPath);
-      const skillManifest = await loadSkillManifest(agentDirPath);
-
-      for (const file of agentFiles) {
-        if (!file.endsWith('.md')) continue;
-        if (file.includes('.customize.')) continue;
-
-        const filePath = path.join(agentDirPath, file);
-        const content = await fs.readFile(filePath, 'utf8');
-
-        if (content.includes('localskip="true"')) continue;
-
-        agents.push({
-          path: filePath,
-          name: file.replace('.md', ''),
-          module: 'standalone', // Mark as standalone agent
-          canonicalId: getCanonicalId(skillManifest, file),
-        });
-      }
-    }
-  }
-
-  return agents;
-}
-
-async function getTasksFromBmad(bmadDir, selectedModules = []) {
-  const tasks = [];
-
-  if (await fs.pathExists(path.join(bmadDir, 'core', 'tasks'))) {
-    const coreTasks = await getTasksFromDir(path.join(bmadDir, 'core', 'tasks'), 'core');
-    tasks.push(...coreTasks);
-  }
-
-  for (const moduleName of selectedModules) {
-    const tasksPath = path.join(bmadDir, moduleName, 'tasks');
-
-    if (await fs.pathExists(tasksPath)) {
-      const moduleTasks = await getTasksFromDir(tasksPath, moduleName);
-      tasks.push(...moduleTasks);
-    }
-  }
-
-  return tasks;
-}
-
-async function getAgentsFromDir(dirPath, moduleName, relativePath = '') {
-  const agents = [];
-
-  if (!(await fs.pathExists(dirPath))) {
-    return agents;
-  }
-
-  const entries = await fs.readdir(dirPath, { withFileTypes: true });
-  const skillManifest = await loadSkillManifest(dirPath);
-
-  for (const entry of entries) {
-    // Skip if entry.name is undefined or not a string
-    if (!entry.name || typeof entry.name !== 'string') {
-      continue;
-    }
-
-    const fullPath = path.join(dirPath, entry.name);
-    const newRelativePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
-
-    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;
-      }
-
-      if (entry.name.includes('.customize.')) {
-        continue;
-      }
-
-      const content = await fs.readFile(fullPath, 'utf8');
-
-      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
-        canonicalId: getCanonicalId(skillManifest, entry.name),
-      });
-    }
-  }
-
-  return agents;
-}
-
-async function getTasksFromDir(dirPath, moduleName) {
-  const tasks = [];
-
-  if (!(await fs.pathExists(dirPath))) {
-    return tasks;
-  }
-
-  const files = await fs.readdir(dirPath);
-  const skillManifest = await loadSkillManifest(dirPath);
-
-  for (const file of files) {
-    // Include both .md and .xml task files
-    if (!file.endsWith('.md') && !file.endsWith('.xml')) {
-      continue;
-    }
-
-    const filePath = path.join(dirPath, file);
-    const content = await fs.readFile(filePath, 'utf8');
-
-    // Skip internal/engine files (not user-facing tasks)
-    if (content.includes('internal="true"')) {
-      continue;
-    }
-
-    // Remove extension to get task name
-    const ext = file.endsWith('.xml') ? '.xml' : '.md';
-    tasks.push({
-      path: filePath,
-      name: file.replace(ext, ''),
-      module: moduleName,
-      canonicalId: getCanonicalId(skillManifest, file),
-    });
-  }
-
-  return tasks;
-}
-
-module.exports = {
-  getAgentsFromBmad,
-  getTasksFromBmad,
-  getAgentsFromDir,
-  getTasksFromDir,
-};

package/tools/installer/ide/shared/module-injections.js

@@ -1,136 +0,0 @@
-const path = require('node:path');
-const fs = require('fs-extra');
-const yaml = require('yaml');
-const { glob } = require('glob');
-const { getSourcePath } = require('../../project-root');
-
-async function loadModuleInjectionConfig(handler, moduleName) {
-  const sourceModulesPath = getSourcePath('modules');
-  const handlerBaseDir = path.join(sourceModulesPath, moduleName, 'sub-modules', handler);
-  const configPath = path.join(handlerBaseDir, 'injections.yaml');
-
-  if (!(await fs.pathExists(configPath))) {
-    return null;
-  }
-
-  const configContent = await fs.readFile(configPath, 'utf8');
-  const config = yaml.parse(configContent) || {};
-
-  return {
-    config,
-    handlerBaseDir,
-    configPath,
-  };
-}
-
-function shouldApplyInjection(injection, subagentChoices) {
-  if (!subagentChoices || subagentChoices.install === 'none') {
-    return false;
-  }
-
-  if (subagentChoices.install === 'all') {
-    return true;
-  }
-
-  if (subagentChoices.install === 'selective') {
-    const selected = subagentChoices.selected || [];
-
-    if (injection.requires === 'any' && selected.length > 0) {
-      return true;
-    }
-
-    if (injection.requires) {
-      const required = `${injection.requires}.md`;
-      return selected.includes(required);
-    }
-
-    if (injection.point) {
-      const selectedNames = selected.map((file) => file.replace('.md', ''));
-      return selectedNames.some((name) => injection.point.includes(name));
-    }
-  }
-
-  return false;
-}
-
-function filterAgentInstructions(content, selectedFiles) {
-  if (!selectedFiles || selectedFiles.length === 0) {
-    return '';
-  }
-
-  const selectedAgents = selectedFiles.map((file) => file.replace('.md', ''));
-  const lines = content.split('\n');
-  const filteredLines = [];
-
-  for (const line of lines) {
-    if (line.includes('<llm') || line.includes('</llm>')) {
-      filteredLines.push(line);
-    } else if (line.includes('subagent')) {
-      let shouldInclude = false;
-      for (const agent of selectedAgents) {
-        if (line.includes(agent)) {
-          shouldInclude = true;
-          break;
-        }
-      }
-
-      if (shouldInclude) {
-        filteredLines.push(line);
-      }
-    } else if (line.includes('When creating PRDs') || line.includes('ACTIVELY delegate')) {
-      filteredLines.push(line);
-    }
-  }
-
-  if (filteredLines.length > 2) {
-    return filteredLines.join('\n');
-  }
-
-  return '';
-}
-
-async function resolveSubagentFiles(handlerBaseDir, subagentConfig, subagentChoices) {
-  if (!subagentConfig || !subagentConfig.files) {
-    return [];
-  }
-
-  if (!subagentChoices || subagentChoices.install === 'none') {
-    return [];
-  }
-
-  let filesToCopy = subagentConfig.files;
-
-  if (subagentChoices.install === 'selective') {
-    filesToCopy = subagentChoices.selected || [];
-  }
-
-  const sourceDir = path.join(handlerBaseDir, subagentConfig.source || '');
-  const resolved = [];
-
-  for (const file of filesToCopy) {
-    // Use forward slashes for glob pattern (works on both Windows and Unix)
-    // Convert backslashes to forward slashes for glob compatibility
-    const normalizedSourceDir = sourceDir.replaceAll('\\', '/');
-    const pattern = `${normalizedSourceDir}/**/${file}`;
-    const matches = await glob(pattern);
-
-    if (matches.length > 0) {
-      const absolutePath = matches[0];
-      resolved.push({
-        file,
-        absolutePath,
-        relativePath: path.relative(sourceDir, absolutePath),
-        sourceDir,
-      });
-    }
-  }
-
-  return resolved;
-}
-
-module.exports = {
-  loadModuleInjectionConfig,
-  shouldApplyInjection,
-  filterAgentInstructions,
-  resolveSubagentFiles,
-};

package/tools/installer/ide/templates/agent-command-template.md

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

package/tools/installer/ide/templates/combined/antigravity.md

@@ -1,8 +0,0 @@
----
-name: '{{name}}'
-description: '{{description}}'
----
-
-Read the entire workflow file at: {project-root}/_bmad/{{workflow_path}}
-
-Follow all instructions in the workflow file exactly as written.

package/tools/installer/ide/templates/combined/default-agent.md

@@ -1,15 +0,0 @@
----
-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 {project-root}/_bmad/{{path}}
-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>

package/tools/installer/ide/templates/combined/default-task.md

@@ -1,10 +0,0 @@
----
-name: '{{name}}'
-description: '{{description}}'
----
-
-# {{name}}
-
-Read the entire task file at: {project-root}/{{bmadFolderName}}/{{path}}
-
-Follow all instructions in the task file exactly as written.

package/tools/installer/ide/templates/combined/default-tool.md

@@ -1,10 +0,0 @@
----
-name: '{{name}}'
-description: '{{description}}'
----
-
-# {{name}}
-
-Read the entire tool file at: {project-root}/{{bmadFolderName}}/{{path}}
-
-Follow all instructions in the tool file exactly as written.

package/tools/installer/ide/templates/combined/default-workflow.md

@@ -1,6 +0,0 @@
----
-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!

package/tools/installer/ide/templates/combined/gemini-agent.toml

@@ -1,14 +0,0 @@
-description = "Activates the {{name}} agent from the BMad Method."
-prompt = """
-CRITICAL: You are now the BMad '{{name}}' agent.
-
-PRE-FLIGHT CHECKLIST:
-1.  [ ] IMMEDIATE ACTION: Load and parse {project-root}/{{bmadFolderName}}/{{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 {project-root}/{{bmadFolderName}}/{{path}}.
-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: {project-root}/{{bmadFolderName}}/{{path}}
-"""

package/tools/installer/ide/templates/combined/gemini-task.toml

@@ -1,11 +0,0 @@
-description = "Executes the {{name}} task from the BMAD Method."
-prompt = """
-Execute the BMAD '{{name}}' task.
-
-TASK INSTRUCTIONS:
-1. LOAD the task file from {project-root}/{{bmadFolderName}}/{{path}}
-2. READ its entire contents
-3. FOLLOW every instruction precisely as specified
-
-TASK FILE: {project-root}/{{bmadFolderName}}/{{path}}
-"""

package/tools/installer/ide/templates/combined/gemini-tool.toml

@@ -1,11 +0,0 @@
-description = "Executes the {{name}} tool from the BMAD Method."
-prompt = """
-Execute the BMAD '{{name}}' tool.
-
-TOOL INSTRUCTIONS:
-1. LOAD the tool file from {project-root}/{{bmadFolderName}}/{{path}}
-2. READ its entire contents
-3. FOLLOW every instruction precisely as specified
-
-TOOL FILE: {project-root}/{{bmadFolderName}}/{{path}}
-"""

package/tools/installer/ide/templates/combined/gemini-workflow-yaml.toml

@@ -1,16 +0,0 @@
-description = '{{description}}'
-prompt = """
-Execute the BMAD '{{name}}' workflow.
-
-CRITICAL: This is a structured YAML workflow. Follow these steps precisely:
-
-1. LOAD the workflow definition from {project-root}/{{bmadFolderName}}/{{workflow_path}}
-2. PARSE the YAML structure to understand:
-   - Workflow phases and steps
-   - Required inputs and outputs
-   - Dependencies between steps
-3. EXECUTE each step in order
-4. VALIDATE outputs before proceeding to next step
-
-WORKFLOW FILE: {project-root}/{{bmadFolderName}}/{{workflow_path}}
-"""

package/tools/installer/ide/templates/combined/gemini-workflow.toml

@@ -1,14 +0,0 @@
-description = '{{description}}'
-prompt = """
-Execute the BMAD '{{name}}' workflow.
-
-CRITICAL: You must load and follow the workflow definition exactly.
-
-WORKFLOW INSTRUCTIONS:
-1. LOAD the workflow file from {project-root}/{{bmadFolderName}}/{{workflow_path}}
-2. READ its entire contents
-3. FOLLOW every step precisely as specified
-4. DO NOT skip or modify any steps
-
-WORKFLOW FILE: {project-root}/{{bmadFolderName}}/{{workflow_path}}
-"""

package/tools/installer/ide/templates/combined/kiro-agent.md

@@ -1,16 +0,0 @@
----
-inclusion: manual
----
-
-# {{name}}
-
-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 #[[file:{{bmadFolderName}}/{{path}}]]
-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>

package/tools/installer/ide/templates/combined/kiro-task.md

@@ -1,9 +0,0 @@
----
-inclusion: manual
----
-
-# {{name}}
-
-Read the entire task file at: #[[file:{{bmadFolderName}}/{{path}}]]
-
-Follow all instructions in the task file exactly as written.

package/tools/installer/ide/templates/combined/kiro-tool.md

@@ -1,9 +0,0 @@
----
-inclusion: manual
----
-
-# {{name}}
-
-Read the entire tool file at: #[[file:{{bmadFolderName}}/{{path}}]]
-
-Follow all instructions in the tool file exactly as written.

package/tools/installer/ide/templates/combined/kiro-workflow.md

@@ -1,7 +0,0 @@
----
-inclusion: manual
----
-
-# {{name}}
-
-IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL #[[file:{{bmadFolderName}}/{{path}}]], READ its entire contents and follow its directions exactly!

package/tools/installer/ide/templates/combined/opencode-agent.md

@@ -1,15 +0,0 @@
----
-mode: all
-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 {project-root}/{{bmadFolderName}}/{{path}}
-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>

package/tools/installer/ide/templates/combined/opencode-task.md

@@ -1,13 +0,0 @@
----
-description: '{{description}}'
----
-
-Execute the BMAD '{{name}}' task.
-
-TASK INSTRUCTIONS:
-
-1. LOAD the task file from {project-root}/{{bmadFolderName}}/{{path}}
-2. READ its entire contents
-3. FOLLOW every instruction precisely as specified
-
-TASK FILE: {project-root}/{{bmadFolderName}}/{{path}}

package/tools/installer/ide/templates/combined/opencode-tool.md

@@ -1,13 +0,0 @@
----
-description: '{{description}}'
----
-
-Execute the BMAD '{{name}}' tool.
-
-TOOL INSTRUCTIONS:
-
-1. LOAD the tool file from {project-root}/{{bmadFolderName}}/{{path}}
-2. READ its entire contents
-3. FOLLOW every instruction precisely as specified
-
-TOOL FILE: {project-root}/{{bmadFolderName}}/{{path}}

package/tools/installer/ide/templates/combined/opencode-workflow-yaml.md

@@ -1,16 +0,0 @@
----
-description: '{{description}}'
----
-
-Execute the BMAD '{{name}}' workflow.
-
-CRITICAL: You must load and follow the workflow definition exactly.
-
-WORKFLOW INSTRUCTIONS:
-
-1. LOAD the workflow file from {project-root}/{{bmadFolderName}}/{{path}}
-2. READ its entire contents
-3. FOLLOW every step precisely as specified
-4. DO NOT skip or modify any steps
-
-WORKFLOW FILE: {project-root}/{{bmadFolderName}}/{{path}}

package/tools/installer/ide/templates/combined/opencode-workflow.md

@@ -1,16 +0,0 @@
----
-description: '{{description}}'
----
-
-Execute the BMAD '{{name}}' workflow.
-
-CRITICAL: You must load and follow the workflow definition exactly.
-
-WORKFLOW INSTRUCTIONS:
-
-1. LOAD the workflow file from {project-root}/{{bmadFolderName}}/{{path}}
-2. READ its entire contents
-3. FOLLOW every step precisely as specified
-4. DO NOT skip or modify any steps
-
-WORKFLOW FILE: {project-root}/{{bmadFolderName}}/{{path}}

package/tools/installer/ide/templates/combined/rovodev.md

@@ -1,9 +0,0 @@
-# {{name}}
-
-{{description}}
-
----
-
-Read the entire workflow file at: {project-root}/_bmad/{{workflow_path}}
-
-Follow all instructions in the workflow file exactly as written.

package/tools/installer/ide/templates/combined/trae.md

@@ -1,9 +0,0 @@
-# {{name}}
-
-{{description}}
-
-## Instructions
-
-Read the entire workflow file at: {project-root}/_bmad/{{workflow_path}}
-
-Follow all instructions in the workflow file exactly as written.

package/tools/installer/ide/templates/combined/windsurf-workflow.md

@@ -1,10 +0,0 @@
----
-description: '{{description}}'
-auto_execution_mode: "iterate"
----
-
-# {{name}}
-
-Read the entire workflow file at {project-root}/_bmad/{{workflow_path}}
-
-Follow all instructions in the workflow file exactly as written.