Merge branch 'main' into fix/bmad-help-read-project-docs

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [6.0.0-Beta.7]
+
+**Release: February 4, 2026**
+
+### 🌟 Key Highlights
+
+1. **Direct Workflow Invocation** — Agent workflows can now be run directly via slash commands instead of only through agent orchestration
+2. **Installer Workflow Support** — Installer now picks up `workflow-*.md` files, enabling multiple workflow files per directory
+
+### 🎁 Features
+
+* **Slash Command Workflow Access** — Research and PRD workflows now accessible via direct slash commands: `/domain-research`, `/market-research`, `/technical-research`, `/create-prd`, `/edit-prd`, `/validate-prd` (bd620e38, 731bee26)
+* **Version Checking** — CLI now checks npm for newer versions and displays a warning banner when updates are available (d37ee7f2)
+
+### ♻️ Refactoring
+
+* **Workflow File Splitting** — Split monolithic `workflow.md` files into specific `workflow-*.md` files for individual workflow invocation (bd620e38)
+* **Installer Multi-Workflow Support** — Installer manifest generator now supports `workflow-*.md` pattern, allowing multiple workflow files per directory (731bee26)
+* **Internal Skill Renaming** — Renamed internal project skills to use `bmad-os-` prefix for consistent naming (5276d58b)
+
+---
+
 ## [6.0.0-Beta.6]
 
 **Release: February 4, 2026**

docs/_STYLE_GUIDE.md

@@ -147,7 +147,7 @@ your-project/
 | **Concept**       | `what-are-agents.md`         |
 | **Feature**       | `quick-flow.md`              |
 | **Philosophy**    | `why-solutioning-matters.md` |
-| **FAQ**           | `brownfield-faq.md`          |
+| **FAQ**           | `established-projects-faq.md` |
 
 ### General Template
 
@@ -325,7 +325,7 @@ Add italic context at definition start for limited-scope terms:
 - `*BMad Method/Enterprise.*`
 - `*Phase N.*`
 - `*BMGD.*`
-- `*Brownfield.*`
+- `*Established projects.*`
 
 ### Glossary Checklist
 

docs/explanation/brownfield-faq.md

@@ -1,55 +0,0 @@
----
-title: "Brownfield Development FAQ"
-description: Common questions about brownfield development in the BMad Method
----
-Quick answers to common questions about brownfield (existing codebase) development in the BMad Method (BMM).
-
-## Questions
-
-- [Questions](#questions)
-  - [What is brownfield vs greenfield?](#what-is-brownfield-vs-greenfield)
-  - [Do I have to run document-project for brownfield?](#do-i-have-to-run-document-project-for-brownfield)
-  - [What if I forget to run document-project?](#what-if-i-forget-to-run-document-project)
-  - [Can I use Quick Spec Flow for brownfield projects?](#can-i-use-quick-spec-flow-for-brownfield-projects)
-  - [What if my existing code doesn't follow best practices?](#what-if-my-existing-code-doesnt-follow-best-practices)
-
-### What is brownfield vs greenfield?
-
-- **Greenfield** — New project, starting from scratch, clean slate
-- **Brownfield** — Existing project, working with established codebase and patterns
-
-### Do I have to run document-project for brownfield?
-
-Highly recommended, especially if:
-
-- No existing documentation
-- Documentation is outdated
-- AI agents need context about existing code
-
-You can skip it if you have comprehensive, up-to-date documentation including `docs/index.md` or will use other tools or techniques to aid in discovery for the agent to build on an existing system.
-
-### What if I forget to run document-project?
-
-Don't worry about it - you can do it at any time. You can even do it during or after a project to help keep docs up to date.
-
-### Can I use Quick Spec Flow for brownfield projects?
-
-Yes! Quick Spec Flow works great for brownfield. It will:
-
-- Auto-detect your existing stack
-- Analyze brownfield code patterns
-- Detect conventions and ask for confirmation
-- Generate context-rich tech-spec that respects existing code
-
-Perfect for bug fixes and small features in existing codebases.
-
-### What if my existing code doesn't follow best practices?
-
-Quick Spec Flow detects your conventions and asks: "Should I follow these existing conventions?" You decide:
-
-- **Yes** → Maintain consistency with current codebase
-- **No** → Establish new standards (document why in tech-spec)
-
-BMM respects your choice — it won't force modernization, but it will offer it.
-
-**Have a question not answered here?** Please [open an issue](https://github.com/bmad-code-org/BMAD-METHOD/issues) or ask in [Discord](https://discord.gg/gk8jAdXWmj) so we can add it!

docs/explanation/established-projects-faq.md

@@ -0,0 +1,48 @@
+---
+title: "Established Projects FAQ"
+description: Common questions about using BMad Method on established projects
+---
+Quick answers to common questions about working on established projects with the BMad Method (BMM).
+
+## Questions
+
+- [Do I have to run document-project first?](#do-i-have-to-run-document-project-first)
+- [What if I forget to run document-project?](#what-if-i-forget-to-run-document-project)
+- [Can I use Quick Flow for established projects?](#can-i-use-quick-flow-for-established-projects)
+- [What if my existing code doesn't follow best practices?](#what-if-my-existing-code-doesnt-follow-best-practices)
+
+### Do I have to run document-project first?
+
+Highly recommended, especially if:
+
+- No existing documentation
+- Documentation is outdated
+- AI agents need context about existing code
+
+You can skip it if you have comprehensive, up-to-date documentation including `docs/index.md` or will use other tools or techniques to aid in discovery for the agent to build on an existing system.
+
+### What if I forget to run document-project?
+
+Don't worry about it - you can do it at any time. You can even do it during or after a project to help keep docs up to date.
+
+### Can I use Quick Flow for established projects?
+
+Yes! Quick Flow works great for established projects. It will:
+
+- Auto-detect your existing stack
+- Analyze existing code patterns
+- Detect conventions and ask for confirmation
+- Generate context-rich tech-spec that respects existing code
+
+Perfect for bug fixes and small features in existing codebases.
+
+### What if my existing code doesn't follow best practices?
+
+Quick Flow detects your conventions and asks: "Should I follow these existing conventions?" You decide:
+
+- **Yes** → Maintain consistency with current codebase
+- **No** → Establish new standards (document why in tech-spec)
+
+BMM respects your choice — it won't force modernization, but it will offer it.
+
+**Have a question not answered here?** Please [open an issue](https://github.com/bmad-code-org/BMAD-METHOD/issues) or ask in [Discord](https://discord.gg/gk8jAdXWmj) so we can add it!

docs/how-to/established-projects.md

@@ -1,15 +1,11 @@
 ---
-title: "Brownfield Development"
+title: "Established Projects"
 description: How to use BMad Method on existing codebases
 ---
 
 Use BMad Method effectively when working on existing projects and legacy codebases.
 
-## What is Brownfield Development?
+This guide covers the essential workflow for onboarding to existing projects with BMad Method.
-
-**Brownfield** refers to working on existing projects with established codebases and patterns, as opposed to **greenfield** which means starting from scratch with a clean slate.
-
-This guide covers the essential workflow for onboarding to brownfield projects with BMad Method.
 
 :::note[Prerequisites]
 - BMad Method installed (`npx bmad-method install`)
@@ -80,5 +76,5 @@ Pay close attention here to prevent reinventing the wheel or making decisions th
 
 ## More Information
 
-- **[Quick Fix in Brownfield](/docs/how-to/brownfield/quick-fix-in-brownfield.md)** - Bug fixes and ad-hoc changes
+- **[Quick Fixes](/docs/how-to/quick-fixes.md)** - Bug fixes and ad-hoc changes
-- **[Brownfield FAQ](/docs/explanation/brownfield-faq.md)** - Common questions about brownfield development
+- **[Established Projects FAQ](/docs/explanation/established-projects-faq.md)** - Common questions about working on established projects

docs/how-to/quick-fixes.md

@@ -1,6 +1,6 @@
 ---
-title: "How to Make Quick Fixes in Brownfield Projects"
+title: "Quick Fixes"
-description: How to make quick fixes and ad-hoc changes in brownfield projects
+description: How to make quick fixes and ad-hoc changes
 ---
 
 Use the **DEV agent** directly for bug fixes, refactorings, or small targeted changes that don't require the full BMad method or Quick Flow.

docs/reference/workflow-map.md

@@ -73,7 +73,7 @@ Skip phases 1-3 for small, well-understood work.
 
 Each document becomes context for the next phase. The PRD tells the architect what constraints matter. The architecture tells the dev agent which patterns to follow. Story files give focused, complete context for implementation. Without this structure, agents make inconsistent decisions.
 
-For brownfield projects, `document-project` creates or updates `project-context.md` - what exists in the codebase and the rules all implementation workflows must observe. Run it just before Phase 4, and again when something significant changes - structure, architecture, or those rules. You can also edit `project-context.md` by hand.
+For established projects, `document-project` creates or updates `project-context.md` - what exists in the codebase and the rules all implementation workflows must observe. Run it just before Phase 4, and again when something significant changes - structure, architecture, or those rules. You can also edit `project-context.md` by hand.
 
 All implementation workflows load `project-context.md` if it exists. Additional context per workflow:
 

tools/cli/bmad-cli.js

@@ -1,6 +1,48 @@
 const { program } = require('commander');
 const path = require('node:path');
 const fs = require('node:fs');
+const { execSync } = require('node:child_process');
+
+// Check for updates - do this asynchronously so it doesn't block startup
+const packageJson = require('../../package.json');
+const packageName = 'bmad-method';
+checkForUpdate().catch(() => {
+  // Silently ignore errors - version check is best-effort
+});
+
+async function checkForUpdate() {
+  try {
+    // For beta versions, check the beta tag; otherwise check latest
+    const isBeta =
+      packageJson.version.includes('Beta') ||
+      packageJson.version.includes('beta') ||
+      packageJson.version.includes('alpha') ||
+      packageJson.version.includes('rc');
+    const tag = isBeta ? 'beta' : 'latest';
+
+    const result = execSync(`npm view ${packageName}@${tag} version`, {
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 5000,
+    }).trim();
+
+    if (result && result !== packageJson.version) {
+      console.warn('');
+      console.warn('  ╔═══════════════════════════════════════════════════════════════════════════════╗');
+      console.warn('  ║  UPDATE AVAILABLE                                                             ║');
+      console.warn('  ║                                                                               ║');
+      console.warn(`  ║  You are using version ${packageJson.version} but ${result} is available.     ║`);
+      console.warn('  ║                                                                               ║');
+      console.warn('  ║  To update,exir and first run:                                                ║');
+      console.warn(`  ║    npm cache clean --force && npx bmad-method@${tag} install                  ║`);
+      console.warn('  ║                                                                               ║');
+      console.warn('  ╚═══════════════════════════════════════════════════════════════════════════════╝');
+      console.warn('');
+    }
+  } catch {
+    // Silently fail - network issues or npm not available
+  }
+}
 
 // Fix for stdin issues when running through npm on Windows
 // Ensures keyboard interaction works properly with CLI prompts
@@ -20,9 +62,6 @@ if (process.stdin.isTTY) {
   }
 }
 
-// Load package.json from root for version info
-const packageJson = require('../../package.json');
-
 // Load all command modules
 const commandsPath = path.join(__dirname, 'commands');
 const commandFiles = fs.readdirSync(commandsPath).filter((file) => file.endsWith('.js'));

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

@@ -1,7 +1,10 @@
 const path = require('node:path');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
+const yaml = require('yaml');
 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
@@ -22,76 +25,94 @@ class KiloSetup extends BaseIdeSetup {
   async setup(projectDir, bmadDir, options = {}) {
     console.log(chalk.cyan(`Setting up ${this.name}...`));
 
-    // Check for existing .kilocodemodes file
+    // Clean up any old BMAD installation first
+    await this.cleanup(projectDir);
+
+    // Load existing config (may contain non-BMAD modes and other settings)
     const kiloModesPath = path.join(projectDir, this.configFile);
-    let existingModes = [];
+    let config = {};
-    let existingContent = '';
 
     if (await this.pathExists(kiloModesPath)) {
-      existingContent = await this.readFile(kiloModesPath);
+      const existingContent = await this.readFile(kiloModesPath);
-      // Parse existing modes
+      try {
-      const modeMatches = existingContent.matchAll(/- slug: ([\w-]+)/g);
+        config = yaml.parse(existingContent) || {};
-      for (const match of modeMatches) {
+      } catch {
-        existingModes.push(match[1]);
+        // If parsing fails, start fresh but warn user
+        console.log(chalk.yellow('Warning: Could not parse existing .kilocodemodes, starting fresh'));
+        config = {};
       }
-      console.log(chalk.yellow(`Found existing .kilocodemodes file with ${existingModes.length} modes`));
+    }
+
+    // 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 modes content
+    // Create mode objects and add to config
-    let newModesContent = '';
     let addedCount = 0;
-    let skippedCount = 0;
 
     for (const artifact of agentArtifacts) {
-      const slug = `bmad-${artifact.module}-${artifact.name}`;
+      const modeObject = await this.createModeObject(artifact, projectDir);
-
+      config.customModes.push(modeObject);
-      // Skip if already exists
-      if (existingModes.includes(slug)) {
-        console.log(chalk.dim(`  Skipping ${slug} - already exists`));
-        skippedCount++;
-        continue;
-      }
-
-      const modeEntry = await this.createModeEntry(artifact, projectDir);
-
-      newModesContent += modeEntry;
       addedCount++;
     }
 
-    // Build final content
+    // Write .kilocodemodes file with proper YAML structure
-    let finalContent = '';
+    const finalContent = yaml.stringify(config, { lineWidth: 0 });
-    if (existingContent) {
-      finalContent = existingContent.trim() + '\n' + newModesContent;
-    } else {
-      finalContent = 'customModes:\n' + newModesContent;
-    }
-
-    // Write .kilocodemodes file
     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;
+
     console.log(chalk.green(`✓ ${this.name} configured:`));
     console.log(chalk.dim(`  - ${addedCount} modes added`));
-    if (skippedCount > 0) {
+    console.log(chalk.dim(`  - ${workflowCount} workflows exported`));
-      console.log(chalk.dim(`  - ${skippedCount} modes skipped (already exist)`));
+    console.log(chalk.dim(`  - ${taskCount} tasks exported`));
-    }
+    console.log(chalk.dim(`  - ${toolCount} tools exported`));
     console.log(chalk.dim(`  - Configuration file: ${this.configFile}`));
+    console.log(chalk.dim(`  - Workflows directory: .kilocode/workflows/`));
     console.log(chalk.dim('\n  Modes will be available when you open this project in KiloCode'));
 
     return {
       success: true,
       modes: addedCount,
-      skipped: skippedCount,
+      workflows: workflowCount,
+      tasks: taskCount,
+      tools: toolCount,
     };
   }
 
   /**
-   * Create a mode entry for an agent
+   * 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 createModeEntry(artifact, projectDir) {
+  async createModeObject(artifact, projectDir) {
     // Extract metadata from launcher content
     const titleMatch = artifact.content.match(/title="([^"]+)"/);
     const title = titleMatch ? titleMatch[1] : this.formatTitle(artifact.name);
@@ -102,8 +123,8 @@ class KiloSetup extends BaseIdeSetup {
     const whenToUseMatch = artifact.content.match(/whenToUse="([^"]+)"/);
     const whenToUse = whenToUseMatch ? whenToUseMatch[1] : `Use for ${title} tasks`;
 
-    // Get the activation header from central template
+    // Get the activation header from central template (trim to avoid YAML formatting issues)
-    const activationHeader = await this.getAgentCommandHeader();
+    const activationHeader = (await this.getAgentCommandHeader()).trim();
 
     const roleDefinitionMatch = artifact.content.match(/roleDefinition="([^"]+)"/);
     const roleDefinition = roleDefinitionMatch
@@ -113,22 +134,15 @@ class KiloSetup extends BaseIdeSetup {
     // Get relative path
     const relativePath = path.relative(projectDir, artifact.sourcePath).replaceAll('\\', '/');
 
-    // Build mode entry (KiloCode uses same schema as Roo)
+    // Build mode object (KiloCode uses same schema as Roo)
-    const slug = `bmad-${artifact.module}-${artifact.name}`;
+    return {
-    let modeEntry = ` - slug: ${slug}\n`;
+      slug: `bmad-${artifact.module}-${artifact.name}`,
-    modeEntry += `   name: '${icon} ${title}'\n`;
+      name: `${icon} ${title}`,
-    modeEntry += `   roleDefinition: ${roleDefinition}\n`;
+      roleDefinition: roleDefinition,
-    modeEntry += `   whenToUse: ${whenToUse}\n`;
+      whenToUse: whenToUse,
-    modeEntry += `   customInstructions: |\n`;
+      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 += `    ${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'],
-    modeEntry += `   groups:\n`;
+    };
-    modeEntry += `    - read\n`;
-    modeEntry += `    - edit\n`;
-    modeEntry += `    - browser\n`;
-    modeEntry += `    - command\n`;
-    modeEntry += `    - mcp\n`;
-
-    return modeEntry;
   }
 
   /**
@@ -141,6 +155,22 @@ class KiloSetup extends BaseIdeSetup {
       .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
    */
@@ -151,28 +181,29 @@ class KiloSetup extends BaseIdeSetup {
     if (await fs.pathExists(kiloModesPath)) {
       const content = await fs.readFile(kiloModesPath, 'utf8');
 
-      // Remove BMAD modes only
+      try {
-      const lines = content.split('\n');
+        const config = yaml.parse(content) || {};
-      const filteredLines = [];
-      let skipMode = false;
-      let removedCount = 0;
 
-      for (const line of lines) {
+        if (Array.isArray(config.customModes)) {
-        if (/^\s*- slug: bmad-/.test(line)) {
+          const originalCount = config.customModes.length;
-          skipMode = true;
+          // Remove BMAD modes only (keep non-BMAD modes)
-          removedCount++;
+          config.customModes = config.customModes.filter((mode) => !mode.slug || !mode.slug.startsWith('bmad-'));
-        } else if (skipMode && /^\s*- slug: /.test(line)) {
+          const removedCount = originalCount - config.customModes.length;
-          skipMode = false;
-        }
 
-        if (!skipMode) {
+          if (removedCount > 0) {
-          filteredLines.push(line);
+            await fs.writeFile(kiloModesPath, yaml.stringify(config, { lineWidth: 0 }));
+            console.log(chalk.dim(`Removed ${removedCount} BMAD modes from .kilocodemodes`));
+          }
         }
+      } catch {
+        // If parsing fails, leave file as-is
+        console.log(chalk.yellow('Warning: Could not parse .kilocodemodes for cleanup'));
       }
-
-      await fs.writeFile(kiloModesPath, filteredLines.join('\n'));
-      console.log(chalk.dim(`Removed ${removedCount} BMAD modes from .kilocodemodes`));
     }
+
+    // Clean up workflow files
+    const workflowsDir = path.join(projectDir, '.kilocode', 'workflows');
+    await this.clearBmadWorkflows(workflowsDir);
   }
 
   /**
@@ -185,31 +216,28 @@ class KiloSetup extends BaseIdeSetup {
    */
   async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
     const kilocodemodesPath = path.join(projectDir, this.configFile);
-    let existingContent = '';
+    let config = {};
 
     // Read existing .kilocodemodes file
     if (await this.pathExists(kilocodemodesPath)) {
-      existingContent = await this.readFile(kilocodemodesPath);
+      const existingContent = await this.readFile(kilocodemodesPath);
+      try {
+        config = yaml.parse(existingContent) || {};
+      } catch {
+        config = {};
+      }
     }
 
-    // Create custom agent mode entry
+    // Ensure customModes array exists
+    if (!Array.isArray(config.customModes)) {
+      config.customModes = [];
+    }
+
+    // Create custom agent mode object
     const slug = `bmad-custom-${agentName.toLowerCase()}`;
-    const modeEntry = ` - slug: ${slug}
-   name: 'BMAD Custom: ${agentName}'
-   description: |
-    Custom BMAD agent: ${agentName}
-
-    **⚠️ IMPORTANT**: Run @${agentPath} first to load the complete agent!
-
-    This is a launcher for the custom BMAD agent "${agentName}". The agent will follow the persona and instructions from the main agent file.
-   prompt: |
-    @${agentPath}
-   always: false
-   permissions: all
-`;
 
     // Check if mode already exists
-    if (existingContent.includes(slug)) {
+    if (config.customModes.some((mode) => mode.slug === slug)) {
       return {
         ide: 'kilo',
         path: this.configFile,
@@ -219,24 +247,18 @@ class KiloSetup extends BaseIdeSetup {
       };
     }
 
-    // Build final content
+    // Add custom mode object
-    let finalContent = '';
+    config.customModes.push({
-    if (existingContent) {
+      slug: slug,
-      // Find customModes section or add it
+      name: `BMAD Custom: ${agentName}`,
-      if (existingContent.includes('customModes:')) {
+      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`,
-        // Append to existing customModes
+      prompt: `@${agentPath}\n`,
-        finalContent = existingContent + modeEntry;
+      always: false,
-      } else {
+      permissions: 'all',
-        // Add customModes section
+    });
-        finalContent = existingContent.trim() + '\n\ncustomModes:\n' + modeEntry;
-      }
-    } else {
-      // Create new .kilocodemodes file with customModes
-      finalContent = 'customModes:\n' + modeEntry;
-    }
 
-    // Write .kilocodemodes file
+    // Write .kilocodemodes file with proper YAML structure
-    await this.writeFile(kilocodemodesPath, finalContent);
+    await this.writeFile(kilocodemodesPath, yaml.stringify(config, { lineWidth: 0 }));
 
     return {
       ide: 'kilo',

tools/cli/installers/lib/ide/platform-codes.yaml

@@ -124,8 +124,13 @@ platforms:
     category: ide
     description: "OpenCode terminal coding assistant"
     installer:
-      target_dir: .opencode/command
+      targets:
-      template_type: opencode
+        - target_dir: .opencode/agent
+          template_type: opencode
+          artifact_types: [agents]
+        - target_dir: .opencode/command
+          template_type: opencode
+          artifact_types: [workflows, tasks, tools]
 
   qwen:
     name: "QwenCoder"