bmad-method 6.0.3 → 6.0.5-next.0

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

@@ -1,269 +0,0 @@
-const path = require('node:path');
-const { BaseIdeSetup } = require('./_base-ide');
-const yaml = require('yaml');
-const prompts = require('../../../lib/prompts');
-const { AgentCommandGenerator } = require('./shared/agent-command-generator');
-const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');
-const { TaskToolCommandGenerator } = require('./shared/task-tool-command-generator');
-
-/**
- * KiloCode IDE setup handler
- * Creates custom modes in .kilocodemodes file (similar to Roo)
- */
-class KiloSetup extends BaseIdeSetup {
-  constructor() {
-    super('kilo', 'Kilo Code');
-    this.configFile = '.kilocodemodes';
-  }
-
-  /**
-   * Setup KiloCode IDE configuration
-   * @param {string} projectDir - Project directory
-   * @param {string} bmadDir - BMAD installation directory
-   * @param {Object} options - Setup options
-   */
-  async setup(projectDir, bmadDir, options = {}) {
-    if (!options.silent) await prompts.log.info(`Setting up ${this.name}...`);
-
-    // Clean up any old BMAD installation first
-    await this.cleanup(projectDir, options);
-
-    // Load existing config (may contain non-BMAD modes and other settings)
-    const kiloModesPath = path.join(projectDir, this.configFile);
-    let config = {};
-
-    if (await this.pathExists(kiloModesPath)) {
-      const existingContent = await this.readFile(kiloModesPath);
-      try {
-        config = yaml.parse(existingContent) || {};
-      } catch {
-        // If parsing fails, start fresh but warn user
-        await prompts.log.warn('Warning: Could not parse existing .kilocodemodes, starting fresh');
-        config = {};
-      }
-    }
-
-    // Ensure customModes array exists
-    if (!Array.isArray(config.customModes)) {
-      config.customModes = [];
-    }
-
-    // Generate agent launchers
-    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
-    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
-
-    // Create mode objects and add to config
-    let addedCount = 0;
-
-    for (const artifact of agentArtifacts) {
-      const modeObject = await this.createModeObject(artifact, projectDir);
-      config.customModes.push(modeObject);
-      addedCount++;
-    }
-
-    // Write .kilocodemodes file with proper YAML structure
-    const finalContent = yaml.stringify(config, { lineWidth: 0 });
-    await this.writeFile(kiloModesPath, finalContent);
-
-    // Generate workflow commands
-    const workflowGenerator = new WorkflowCommandGenerator(this.bmadFolderName);
-    const { artifacts: workflowArtifacts } = await workflowGenerator.collectWorkflowArtifacts(bmadDir);
-
-    // Write to .kilocode/workflows/ directory
-    const workflowsDir = path.join(projectDir, '.kilocode', 'workflows');
-    await this.ensureDir(workflowsDir);
-
-    // Clear old BMAD workflows before writing new ones
-    await this.clearBmadWorkflows(workflowsDir);
-
-    // Write workflow files
-    const workflowCount = await workflowGenerator.writeDashArtifacts(workflowsDir, workflowArtifacts);
-
-    // Generate task and tool commands
-    const taskToolGen = new TaskToolCommandGenerator(this.bmadFolderName);
-    const { artifacts: taskToolArtifacts, counts: taskToolCounts } = await taskToolGen.collectTaskToolArtifacts(bmadDir);
-
-    // Write task/tool files to workflows directory (same location as workflows)
-    await taskToolGen.writeDashArtifacts(workflowsDir, taskToolArtifacts);
-    const taskCount = taskToolCounts.tasks || 0;
-    const toolCount = taskToolCounts.tools || 0;
-
-    if (!options.silent) {
-      await prompts.log.success(
-        `${this.name} configured: ${addedCount} modes, ${workflowCount} workflows, ${taskCount} tasks, ${toolCount} tools → ${this.configFile}`,
-      );
-    }
-
-    return {
-      success: true,
-      modes: addedCount,
-      workflows: workflowCount,
-      tasks: taskCount,
-      tools: toolCount,
-    };
-  }
-
-  /**
-   * Create a mode object for an agent
-   * @param {Object} artifact - Agent artifact
-   * @param {string} projectDir - Project directory
-   * @returns {Object} Mode object for YAML serialization
-   */
-  async createModeObject(artifact, projectDir) {
-    // Extract metadata from launcher content
-    const titleMatch = artifact.content.match(/title="([^"]+)"/);
-    const title = titleMatch ? titleMatch[1] : this.formatTitle(artifact.name);
-
-    const iconMatch = artifact.content.match(/icon="([^"]+)"/);
-    const icon = iconMatch ? iconMatch[1] : '🤖';
-
-    const whenToUseMatch = artifact.content.match(/whenToUse="([^"]+)"/);
-    const whenToUse = whenToUseMatch ? whenToUseMatch[1] : `Use for ${title} tasks`;
-
-    // Get the activation header from central template (trim to avoid YAML formatting issues)
-    const activationHeader = (await this.getAgentCommandHeader()).trim();
-
-    const roleDefinitionMatch = artifact.content.match(/roleDefinition="([^"]+)"/);
-    const roleDefinition = roleDefinitionMatch
-      ? roleDefinitionMatch[1]
-      : `You are a ${title} specializing in ${title.toLowerCase()} tasks.`;
-
-    // Get relative path
-    const relativePath = path.relative(projectDir, artifact.sourcePath).replaceAll('\\', '/');
-
-    // Build mode object (KiloCode uses same schema as Roo)
-    return {
-      slug: `bmad-${artifact.module}-${artifact.name}`,
-      name: `${icon} ${title}`,
-      roleDefinition: roleDefinition,
-      whenToUse: whenToUse,
-      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`,
-      groups: ['read', 'edit', 'browser', 'command', 'mcp'],
-    };
-  }
-
-  /**
-   * Format name as title
-   */
-  formatTitle(name) {
-    return name
-      .split('-')
-      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-      .join(' ');
-  }
-
-  /**
-   * Clear old BMAD workflow files from workflows directory
-   * @param {string} workflowsDir - Workflows directory path
-   */
-  async clearBmadWorkflows(workflowsDir) {
-    const fs = require('fs-extra');
-    if (!(await fs.pathExists(workflowsDir))) return;
-
-    const entries = await fs.readdir(workflowsDir);
-    for (const entry of entries) {
-      if (entry.startsWith('bmad-') && entry.endsWith('.md')) {
-        await fs.remove(path.join(workflowsDir, entry));
-      }
-    }
-  }
-
-  /**
-   * Cleanup KiloCode configuration
-   */
-  async cleanup(projectDir, options = {}) {
-    const fs = require('fs-extra');
-    const kiloModesPath = path.join(projectDir, this.configFile);
-
-    if (await fs.pathExists(kiloModesPath)) {
-      const content = await fs.readFile(kiloModesPath, 'utf8');
-
-      try {
-        const config = yaml.parse(content) || {};
-
-        if (Array.isArray(config.customModes)) {
-          const originalCount = config.customModes.length;
-          // Remove BMAD modes only (keep non-BMAD modes)
-          config.customModes = config.customModes.filter((mode) => !mode.slug || !mode.slug.startsWith('bmad-'));
-          const removedCount = originalCount - config.customModes.length;
-
-          if (removedCount > 0) {
-            await fs.writeFile(kiloModesPath, yaml.stringify(config, { lineWidth: 0 }));
-            if (!options.silent) await prompts.log.message(`Removed ${removedCount} BMAD modes from .kilocodemodes`);
-          }
-        }
-      } catch {
-        // If parsing fails, leave file as-is
-        if (!options.silent) await prompts.log.warn('Warning: Could not parse .kilocodemodes for cleanup');
-      }
-    }
-
-    // Clean up workflow files
-    const workflowsDir = path.join(projectDir, '.kilocode', 'workflows');
-    await this.clearBmadWorkflows(workflowsDir);
-  }
-
-  /**
-   * Install a custom agent launcher for Kilo
-   * @param {string} projectDir - Project directory
-   * @param {string} agentName - Agent name (e.g., "fred-commit-poet")
-   * @param {string} agentPath - Path to compiled agent (relative to project root)
-   * @param {Object} metadata - Agent metadata
-   * @returns {Object} Installation result
-   */
-  async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
-    const kilocodemodesPath = path.join(projectDir, this.configFile);
-    let config = {};
-
-    // Read existing .kilocodemodes file
-    if (await this.pathExists(kilocodemodesPath)) {
-      const existingContent = await this.readFile(kilocodemodesPath);
-      try {
-        config = yaml.parse(existingContent) || {};
-      } catch {
-        config = {};
-      }
-    }
-
-    // Ensure customModes array exists
-    if (!Array.isArray(config.customModes)) {
-      config.customModes = [];
-    }
-
-    // Create custom agent mode object
-    const slug = `bmad-custom-${agentName.toLowerCase()}`;
-
-    // Check if mode already exists
-    if (config.customModes.some((mode) => mode.slug === slug)) {
-      return {
-        ide: 'kilo',
-        path: this.configFile,
-        command: agentName,
-        type: 'custom-agent-launcher',
-        alreadyExists: true,
-      };
-    }
-
-    // Add custom mode object
-    config.customModes.push({
-      slug: slug,
-      name: `BMAD Custom: ${agentName}`,
-      description: `Custom BMAD agent: ${agentName}\n\n**⚠️ IMPORTANT**: Run @${agentPath} first to load the complete agent!\n\nThis is a launcher for the custom BMAD agent "${agentName}". The agent will follow the persona and instructions from the main agent file.\n`,
-      prompt: `@${agentPath}\n`,
-      always: false,
-      permissions: 'all',
-    });
-
-    // Write .kilocodemodes file with proper YAML structure
-    await this.writeFile(kilocodemodesPath, yaml.stringify(config, { lineWidth: 0 }));
-
-    return {
-      ide: 'kilo',
-      path: this.configFile,
-      command: slug,
-      type: 'custom-agent-launcher',
-    };
-  }
-}
-
-module.exports = { KiloSetup };

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

@@ -1,257 +0,0 @@
-const path = require('node:path');
-const fs = require('fs-extra');
-const yaml = require('yaml');
-const { BaseIdeSetup } = require('./_base-ide');
-const prompts = require('../../../lib/prompts');
-const { AgentCommandGenerator } = require('./shared/agent-command-generator');
-const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');
-const { TaskToolCommandGenerator } = require('./shared/task-tool-command-generator');
-const { toDashPath } = require('./shared/path-utils');
-
-/**
- * Rovo Dev IDE setup handler
- *
- * Custom installer that writes .md workflow files to .rovodev/workflows/
- * and generates .rovodev/prompts.yml to register them with Rovo Dev's /prompts feature.
- *
- * prompts.yml format (per Rovo Dev docs):
- *   prompts:
- *     - name: bmad-bmm-create-prd
- *       description: "PRD workflow..."
- *       content_file: workflows/bmad-bmm-create-prd.md
- */
-class RovoDevSetup extends BaseIdeSetup {
-  constructor() {
-    super('rovo-dev', 'Rovo Dev', false);
-    this.rovoDir = '.rovodev';
-    this.workflowsDir = 'workflows';
-    this.promptsFile = 'prompts.yml';
-  }
-
-  /**
-   * Setup Rovo Dev configuration
-   * @param {string} projectDir - Project directory
-   * @param {string} bmadDir - BMAD installation directory
-   * @param {Object} options - Setup options
-   * @returns {Promise<Object>} Setup result with { success, results: { agents, workflows, tasks, tools } }
-   */
-  async setup(projectDir, bmadDir, options = {}) {
-    if (!options.silent) await prompts.log.info(`Setting up ${this.name}...`);
-
-    // Clean up any old BMAD installation first
-    await this.cleanup(projectDir, options);
-
-    const workflowsPath = path.join(projectDir, this.rovoDir, this.workflowsDir);
-    await this.ensureDir(workflowsPath);
-
-    const selectedModules = options.selectedModules || [];
-    const writtenFiles = [];
-
-    // Generate and write agent launchers
-    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
-    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, selectedModules);
-    const agentCount = await agentGen.writeDashArtifacts(workflowsPath, agentArtifacts);
-    this._collectPromptEntries(writtenFiles, agentArtifacts, ['agent-launcher'], 'agent');
-
-    // Generate and write workflow commands
-    const workflowGen = new WorkflowCommandGenerator(this.bmadFolderName);
-    const { artifacts: workflowArtifacts } = await workflowGen.collectWorkflowArtifacts(bmadDir);
-    const workflowCount = await workflowGen.writeDashArtifacts(workflowsPath, workflowArtifacts);
-    this._collectPromptEntries(writtenFiles, workflowArtifacts, ['workflow-command'], 'workflow');
-
-    // Generate and write task/tool commands
-    const taskToolGen = new TaskToolCommandGenerator(this.bmadFolderName);
-    const { artifacts: taskToolArtifacts, counts: taskToolCounts } = await taskToolGen.collectTaskToolArtifacts(bmadDir);
-    await taskToolGen.writeDashArtifacts(workflowsPath, taskToolArtifacts);
-    const taskCount = taskToolCounts.tasks || 0;
-    const toolCount = taskToolCounts.tools || 0;
-    this._collectPromptEntries(writtenFiles, taskToolArtifacts, ['task', 'tool']);
-
-    // Generate prompts.yml manifest (only if we have entries to write)
-    if (writtenFiles.length > 0) {
-      await this.generatePromptsYml(projectDir, writtenFiles);
-    }
-
-    if (!options.silent) {
-      await prompts.log.success(
-        `${this.name} configured: ${agentCount} agents, ${workflowCount} workflows, ${taskCount} tasks, ${toolCount} tools`,
-      );
-    }
-
-    return {
-      success: true,
-      results: {
-        agents: agentCount,
-        workflows: workflowCount,
-        tasks: taskCount,
-        tools: toolCount,
-      },
-    };
-  }
-
-  /**
-   * Collect prompt entries from artifacts into writtenFiles array
-   * @param {Array} writtenFiles - Target array to push entries into
-   * @param {Array} artifacts - Artifacts from a generator's collect method
-   * @param {string[]} acceptedTypes - Artifact types to include (e.g., ['agent-launcher'])
-   * @param {string} [fallbackSuffix] - Suffix for fallback description; defaults to artifact.type
-   */
-  _collectPromptEntries(writtenFiles, artifacts, acceptedTypes, fallbackSuffix) {
-    for (const artifact of artifacts) {
-      if (!acceptedTypes.includes(artifact.type)) continue;
-      const flatName = toDashPath(artifact.relativePath);
-      writtenFiles.push({
-        name: path.basename(flatName, '.md'),
-        description: artifact.description || `${artifact.name} ${fallbackSuffix || artifact.type}`,
-        contentFile: `${this.workflowsDir}/${flatName}`,
-      });
-    }
-  }
-
-  /**
-   * Generate .rovodev/prompts.yml manifest
-   * Merges with existing user entries -- strips entries with names starting 'bmad-',
-   * appends new BMAD entries, and writes back.
-   *
-   * @param {string} projectDir - Project directory
-   * @param {Array<Object>} writtenFiles - Array of { name, description, contentFile }
-   */
-  async generatePromptsYml(projectDir, writtenFiles) {
-    const promptsPath = path.join(projectDir, this.rovoDir, this.promptsFile);
-    let existingPrompts = [];
-
-    // Read existing prompts.yml and preserve non-BMAD entries
-    if (await this.pathExists(promptsPath)) {
-      try {
-        const content = await this.readFile(promptsPath);
-        const parsed = yaml.parse(content);
-        if (parsed && Array.isArray(parsed.prompts)) {
-          // Keep only non-BMAD entries (entries whose name does NOT start with bmad-)
-          existingPrompts = parsed.prompts.filter((entry) => !entry.name || !entry.name.startsWith('bmad-'));
-        }
-      } catch {
-        // If parsing fails, start fresh but preserve file safety
-        existingPrompts = [];
-      }
-    }
-
-    // Build new BMAD entries (prefix description with name so /prompts list is scannable)
-    const bmadEntries = writtenFiles.map((file) => ({
-      name: file.name,
-      description: `${file.name} - ${file.description}`,
-      content_file: file.contentFile,
-    }));
-
-    // Merge: user entries first, then BMAD entries
-    const allPrompts = [...existingPrompts, ...bmadEntries];
-
-    const config = { prompts: allPrompts };
-    const yamlContent = yaml.stringify(config, { lineWidth: 0 });
-    await this.writeFile(promptsPath, yamlContent);
-  }
-
-  /**
-   * Cleanup Rovo Dev configuration
-   * Removes bmad-* files from .rovodev/workflows/ and strips BMAD entries from prompts.yml
-   * @param {string} projectDir - Project directory
-   * @param {Object} options - Cleanup options
-   */
-  async cleanup(projectDir, options = {}) {
-    const workflowsPath = path.join(projectDir, this.rovoDir, this.workflowsDir);
-
-    // Remove all bmad-* entries from workflows dir (aligned with detect() predicate)
-    if (await this.pathExists(workflowsPath)) {
-      const entries = await fs.readdir(workflowsPath);
-      for (const entry of entries) {
-        if (entry.startsWith('bmad-')) {
-          await fs.remove(path.join(workflowsPath, entry));
-        }
-      }
-    }
-
-    // Clean BMAD entries from prompts.yml (preserve user entries)
-    const promptsPath = path.join(projectDir, this.rovoDir, this.promptsFile);
-    if (await this.pathExists(promptsPath)) {
-      try {
-        const content = await this.readFile(promptsPath);
-        const parsed = yaml.parse(content) || {};
-
-        if (Array.isArray(parsed.prompts)) {
-          const originalCount = parsed.prompts.length;
-          parsed.prompts = parsed.prompts.filter((entry) => !entry.name || !entry.name.startsWith('bmad-'));
-          const removedCount = originalCount - parsed.prompts.length;
-
-          if (removedCount > 0) {
-            if (parsed.prompts.length === 0) {
-              // If no entries remain, remove the file entirely
-              await fs.remove(promptsPath);
-            } else {
-              await this.writeFile(promptsPath, yaml.stringify(parsed, { lineWidth: 0 }));
-            }
-            if (!options.silent) {
-              await prompts.log.message(`Removed ${removedCount} BMAD entries from ${this.promptsFile}`);
-            }
-          }
-        }
-      } catch {
-        // If parsing fails, leave file as-is
-        if (!options.silent) {
-          await prompts.log.warn(`Warning: Could not parse ${this.promptsFile} for cleanup`);
-        }
-      }
-    }
-
-    // Remove empty .rovodev directories
-    if (await this.pathExists(workflowsPath)) {
-      const remaining = await fs.readdir(workflowsPath);
-      if (remaining.length === 0) {
-        await fs.remove(workflowsPath);
-      }
-    }
-
-    const rovoDirPath = path.join(projectDir, this.rovoDir);
-    if (await this.pathExists(rovoDirPath)) {
-      const remaining = await fs.readdir(rovoDirPath);
-      if (remaining.length === 0) {
-        await fs.remove(rovoDirPath);
-      }
-    }
-  }
-
-  /**
-   * Detect whether Rovo Dev configuration exists in the project
-   * Checks for .rovodev/ dir with bmad files or bmad entries in prompts.yml
-   * @param {string} projectDir - Project directory
-   * @returns {boolean}
-   */
-  async detect(projectDir) {
-    const workflowsPath = path.join(projectDir, this.rovoDir, this.workflowsDir);
-
-    // Check for bmad files in workflows dir
-    if (await fs.pathExists(workflowsPath)) {
-      const entries = await fs.readdir(workflowsPath);
-      if (entries.some((entry) => entry.startsWith('bmad-'))) {
-        return true;
-      }
-    }
-
-    // Check for bmad entries in prompts.yml
-    const promptsPath = path.join(projectDir, this.rovoDir, this.promptsFile);
-    if (await fs.pathExists(promptsPath)) {
-      try {
-        const content = await fs.readFile(promptsPath, 'utf8');
-        const parsed = yaml.parse(content);
-        if (parsed && Array.isArray(parsed.prompts)) {
-          return parsed.prompts.some((entry) => entry.name && entry.name.startsWith('bmad-'));
-        }
-      } catch {
-        // If parsing fails, check raw content
-        return false;
-      }
-    }
-
-    return false;
-  }
-}
-
-module.exports = { RovoDevSetup };

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

@@ -1,14 +0,0 @@
----
-name: '{{name}}'
-description: '{{description}}'
----
-
-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}/{{bmadFolderName}}/core/tasks/workflow.xml
-2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/{{bmadFolderName}}/{{path}}
-3. Pass the yaml path @{project-root}/{{bmadFolderName}}/{{path}} as 'workflow-config' parameter to the workflow.xml instructions
-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>

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

@@ -1,15 +0,0 @@
----
-inclusion: manual
----
-
-# {{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 #[[file:{{bmadFolderName}}/core/tasks/workflow.xml]]
-2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config #[[file:{{bmadFolderName}}/{{path}}]]
-3. Pass the yaml path {{bmadFolderName}}/{{path}} as 'workflow-config' parameter to the workflow.xml instructions
-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>

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

@@ -1,13 +0,0 @@
----
-description: '{{description}}'
----
-
-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 @_bmad/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 to process and follow the specific workflow config and its instructions
-5. Save outputs after EACH section when generating any documents from templates
-</steps>

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

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