bmad-method 4.23.0 → 4.24.1

package/tools/installer/lib/config-loader.js

@@ -1,10 +1,11 @@
 const fs = require('fs-extra');
 const path = require('path');
 const yaml = require('js-yaml');
+const { extractYamlFromAgent } = require('../../lib/yaml-utils');
 
 class ConfigLoader {
   constructor() {
-    this.configPath = path.join(__dirname, '..', 'config', 'install.config.yml');
+    this.configPath = path.join(__dirname, '..', 'config', 'install.config.yaml');
     this.config = null;
   }
 
@@ -41,9 +42,9 @@ class ConfigLoader {
             const agentContent = await fs.readFile(agentPath, 'utf8');
             
             // Extract YAML block from agent file
-            const yamlMatch = agentContent.match(/```yml\n([\s\S]*?)\n```/);
-            if (yamlMatch) {
-              const yamlContent = yaml.load(yamlMatch[1]);
+            const yamlContentText = extractYamlFromAgent(agentContent);
+            if (yamlContentText) {
+              const yamlContent = yaml.load(yamlContentText);
               const agentConfig = yamlContent.agent || {};
               
               agents.push({
@@ -79,10 +80,10 @@ class ConfigLoader {
       for (const entry of entries) {
         if (entry.isDirectory() && !entry.name.startsWith('.')) {
           const packPath = path.join(expansionPacksDir, entry.name);
-          const configPath = path.join(packPath, 'config.yml');
+          const configPath = path.join(packPath, 'config.yaml');
           
           try {
-            // Read config.yml
+            // Read config.yaml
             const configContent = await fs.readFile(configPath, 'utf8');
             const config = yaml.load(configContent);
             
@@ -97,7 +98,7 @@ class ConfigLoader {
               dependencies: config.dependencies?.agents || []
             });
           } catch (error) {
-            // Fallback if config.yml doesn't exist or can't be read
+            // Fallback if config.yaml doesn't exist or can't be read
             console.warn(`Failed to read config for expansion pack ${entry.name}: ${error.message}`);
             
             // Try to derive info from directory name as fallback
@@ -180,7 +181,7 @@ class ConfigLoader {
       const teams = [];
       
       for (const entry of entries) {
-        if (entry.isFile() && entry.name.endsWith('.yml')) {
+        if (entry.isFile() && entry.name.endsWith('.yaml')) {
           const teamPath = path.join(teamsDir, entry.name);
           
           try {
@@ -189,7 +190,7 @@ class ConfigLoader {
             
             if (teamConfig.bundle) {
               teams.push({
-                id: path.basename(entry.name, '.yml'),
+                id: path.basename(entry.name, '.yaml'),
                 name: teamConfig.bundle.name || entry.name,
                 description: teamConfig.bundle.description || 'Team configuration',
                 icon: teamConfig.bundle.icon || '📋'
@@ -209,7 +210,7 @@ class ConfigLoader {
   }
 
   getTeamPath(teamId) {
-    return path.join(this.getBmadCorePath(), 'agent-teams', `${teamId}.yml`);
+    return path.join(this.getBmadCorePath(), 'agent-teams', `${teamId}.yaml`);
   }
 
   async getTeamDependencies(teamId) {
@@ -224,7 +225,7 @@ class ConfigLoader {
       const depPaths = [];
       
       // Add team config file
-      depPaths.push(`.bmad-core/agent-teams/${teamId}.yml`);
+      depPaths.push(`.bmad-core/agent-teams/${teamId}.yaml`);
       
       // Add all agents
       for (const agent of teamDeps.agents) {
@@ -236,7 +237,7 @@ class ConfigLoader {
       
       // Add all resolved resources
       for (const resource of teamDeps.resources) {
-        const filePath = `.bmad-core/${resource.type}/${resource.id}.${resource.type === 'workflows' ? 'yml' : 'md'}`;
+        const filePath = `.bmad-core/${resource.type}/${resource.id}.${resource.type === 'workflows' ? 'yaml' : 'md'}`;
         if (!depPaths.includes(filePath)) {
           depPaths.push(filePath);
         }

package/tools/installer/lib/file-manager.js

@@ -17,7 +17,7 @@ async function initializeModules() {
 class FileManager {
   constructor() {
     this.manifestDir = ".bmad-core";
-    this.manifestFile = "install-manifest.yml";
+    this.manifestFile = "install-manifest.yaml";
   }
 
   async copyFile(source, destination) {
@@ -83,15 +83,15 @@ class FileManager {
       this.manifestFile
     );
 
-    // Read version from core-config.yml
-    const coreConfigPath = path.join(__dirname, "../../../bmad-core/core-config.yml");
+    // Read version from core-config.yaml
+    const coreConfigPath = path.join(__dirname, "../../../bmad-core/core-config.yaml");
     let coreVersion = "unknown";
     try {
       const coreConfigContent = await fs.readFile(coreConfigPath, "utf8");
       const coreConfig = yaml.load(coreConfigContent);
       coreVersion = coreConfig.version || "unknown";
     } catch (error) {
-      console.warn("Could not read version from core-config.yml, using 'unknown'");
+      console.warn("Could not read version from core-config.yaml, using 'unknown'");
     }
 
     const manifest = {
@@ -178,7 +178,7 @@ class FileManager {
       const filePath = path.join(installDir, file.path);
       
       // Skip checking the manifest file itself - it will always be different due to timestamps
-      if (file.path.endsWith('install-manifest.yml')) {
+      if (file.path.endsWith('install-manifest.yaml')) {
         continue;
       }
       

package/tools/installer/lib/ide-setup.js

@@ -3,6 +3,7 @@ const fs = require("fs-extra");
 const yaml = require("js-yaml");
 const fileManager = require("./file-manager");
 const configLoader = require("./config-loader");
+const { extractYamlFromAgent } = require("../../lib/yaml-utils");
 
 // Dynamic import for ES module
 let chalk;
@@ -27,7 +28,7 @@ class IdeSetup {
     if (this.ideAgentConfig) return this.ideAgentConfig;
     
     try {
-      const configPath = path.join(__dirname, '..', 'config', 'ide-agent-config.yml');
+      const configPath = path.join(__dirname, '..', 'config', 'ide-agent-config.yaml');
       const configContent = await fs.readFile(configPath, 'utf8');
       this.ideAgentConfig = yaml.load(configContent);
       return this.ideAgentConfig;
@@ -98,11 +99,11 @@ class IdeSetup {
         mdcContent += "## Agent Activation\n\n";
         mdcContent +=
           "CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n";
-        mdcContent += "```yml\n";
+        mdcContent += "```yaml\n";
         // Extract just the YAML content from the agent file
-        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
-        if (yamlMatch) {
-          mdcContent += yamlMatch[1].trim();
+        const yamlContent = extractYamlFromAgent(agentContent);
+        if (yamlContent) {
+          mdcContent += yamlContent;
         } else {
           // If no YAML found, include the whole content minus the header
           mdcContent += agentContent.replace(/^#.*$/m, "").trim();
@@ -180,11 +181,11 @@ class IdeSetup {
         mdContent += "## Agent Activation\n\n";
         mdContent +=
           "CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n";
-        mdContent += "```yml\n";
+        mdContent += "```yaml\n";
         // Extract just the YAML content from the agent file
-        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
-        if (yamlMatch) {
-          mdContent += yamlMatch[1].trim();
+        const yamlContent = extractYamlFromAgent(agentContent);
+        if (yamlContent) {
+          mdContent += yamlContent;
         } else {
           // If no YAML found, include the whole content minus the header
           mdContent += agentContent.replace(/^#.*$/m, "").trim();
@@ -428,11 +429,11 @@ class IdeSetup {
         mdContent += "## Role Definition\n\n";
         mdContent +=
           "When the user types `@" + agentId + "`, adopt this persona and follow these guidelines:\n\n";
-        mdContent += "```yml\n";
+        mdContent += "```yaml\n";
         // Extract just the YAML content from the agent file
-        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
-        if (yamlMatch) {
-          mdContent += yamlMatch[1].trim();
+        const yamlContent = extractYamlFromAgent(agentContent);
+        if (yamlContent) {
+          mdContent += yamlContent;
         } else {
           // If no YAML found, include the whole content minus the header
           mdContent += agentContent.replace(/^#.*$/m, "").trim();

package/tools/installer/lib/installer.js

@@ -2,6 +2,7 @@ const path = require("node:path");
 const fileManager = require("./file-manager");
 const configLoader = require("./config-loader");
 const ideSetup = require("./ide-setup");
+const { extractYamlFromAgent } = require("../../lib/yaml-utils");
 
 // Dynamic imports for ES modules
 let chalk, ora, inquirer;
@@ -19,13 +20,13 @@ class Installer {
   async getCoreVersion() {
     const yaml = require("js-yaml");
     const fs = require("fs-extra");
-    const coreConfigPath = path.join(__dirname, "../../../bmad-core/core-config.yml");
+    const coreConfigPath = path.join(__dirname, "../../../bmad-core/core-config.yaml");
     try {
       const coreConfigContent = await fs.readFile(coreConfigPath, "utf8");
       const coreConfig = yaml.load(coreConfigContent);
       return coreConfig.version || "unknown";
     } catch (error) {
-      console.warn("Could not read version from core-config.yml, using 'unknown'");
+      console.warn("Could not read version from core-config.yaml, using 'unknown'");
       return "unknown";
     }
   }
@@ -185,7 +186,7 @@ class Installer {
 
     // Check for V4 installation (has .bmad-core with manifest)
     const bmadCorePath = path.join(installDir, ".bmad-core");
-    const manifestPath = path.join(bmadCorePath, "install-manifest.yml");
+    const manifestPath = path.join(bmadCorePath, "install-manifest.yaml");
 
     if (await fileManager.pathExists(manifestPath)) {
       state.type = "v4_existing";
@@ -713,7 +714,7 @@ class Installer {
       
       for (const file of filesToRestore) {
         // Skip the manifest file itself
-        if (file.endsWith('install-manifest.yml')) continue;
+        if (file.endsWith('install-manifest.yaml')) continue;
         
         const relativePath = file.replace('.bmad-core/', '');
         const destPath = path.join(installDir, file);
@@ -757,12 +758,7 @@ class Installer {
       const ides = manifest.ides_setup || [];
       if (ides.includes('cursor')) {
         console.log(chalk.yellow.bold("\n⚠️  IMPORTANT: Cursor Custom Modes Update Required"));
-        console.log(chalk.yellow("Since agent files have been repaired, you need to manually update your Cursor custom modes:"));
-        console.log(chalk.yellow("1. Open Cursor Settings (Cmd/Ctrl + ,)"));
-        console.log(chalk.yellow("2. Go to: Features > Cursor Tab > Custom Modes"));
-        console.log(chalk.yellow("3. Update each custom mode with the latest agent templates from:"));
-        console.log(chalk.yellow(`   ${path.join(installDir, '.bmad-core', 'agents')}`));
-        console.log(chalk.yellow("4. Copy the full content of each agent file into the corresponding custom mode"));
+        console.log(chalk.yellow("Since agent files have been repaired, you need to update any custom agent modes configured in the Cursor custom agent GUI per the Cursor docs."));
       }
       
     } catch (error) {
@@ -861,12 +857,7 @@ class Installer {
     // Warning for Cursor custom modes if agents were updated
     if (options.isUpdate && ides.includes('cursor')) {
       console.log(chalk.yellow.bold("\n⚠️  IMPORTANT: Cursor Custom Modes Update Required"));
-      console.log(chalk.yellow("Since agents have been updated, you need to manually update your Cursor custom modes:"));
-      console.log(chalk.yellow("1. Open Cursor Settings (Cmd/Ctrl + ,)"));
-      console.log(chalk.yellow("2. Go to: Features > Cursor Tab > Custom Modes"));
-      console.log(chalk.yellow("3. Update each custom mode with the latest agent templates from:"));
-      console.log(chalk.yellow(`   ${path.join(installDir, '.bmad-core', 'agents')}`));
-      console.log(chalk.yellow("4. Copy the full content of each agent file into the corresponding custom mode"));
+      console.log(chalk.yellow("Since agents have been updated, you need to update any custom agent modes configured in the Cursor custom agent GUI per the Cursor docs."));
     }
   }
 
@@ -1019,7 +1010,7 @@ class Installer {
         
         // Check if expansion pack already exists
         let expansionDotFolder = path.join(installDir, `.${packId}`);
-        const existingManifestPath = path.join(expansionDotFolder, 'install-manifest.yml');
+        const existingManifestPath = path.join(expansionDotFolder, 'install-manifest.yaml');
         
         if (await fileManager.pathExists(existingManifestPath)) {
           spinner.stop();
@@ -1161,12 +1152,12 @@ class Installer {
           }
         }
 
-        // Copy config.yml
-        const configPath = path.join(expansionPackDir, 'config.yml');
+        // Copy config.yaml
+        const configPath = path.join(expansionPackDir, 'config.yaml');
         if (await fileManager.pathExists(configPath)) {
-          const configDestPath = path.join(expansionDotFolder, 'config.yml');
+          const configDestPath = path.join(expansionDotFolder, 'config.yaml');
           if (await fileManager.copyFile(configPath, configDestPath)) {
-            installedFiles.push(path.join(`.${packId}`, 'config.yml'));
+            installedFiles.push(path.join(`.${packId}`, 'config.yaml'));
           }
         }
         
@@ -1232,10 +1223,10 @@ class Installer {
       const agentContent = await fs.readFile(agentPath, 'utf8');
       
       // Extract YAML frontmatter to check dependencies
-      const yamlMatch = agentContent.match(/```yaml\n([\s\S]*?)```/);
-      if (yamlMatch) {
+      const yamlContent = extractYamlFromAgent(agentContent);
+      if (yamlContent) {
         try {
-          const agentConfig = yaml.parse(yamlMatch[1]);
+          const agentConfig = yaml.parse(yamlContent);
           const dependencies = agentConfig.dependencies || {};
           
           // Check for core dependencies (those that don't exist in the expansion pack)
@@ -1278,7 +1269,7 @@ class Installer {
     const fs = require('fs').promises;
     
     // Find all team files in the expansion pack
-    const teamFiles = glob.sync('agent-teams/*.yml', {
+    const teamFiles = glob.sync('agent-teams/*.yaml', {
       cwd: expansionDotFolder
     });
 
@@ -1324,13 +1315,10 @@ class Installer {
               
               // Now resolve this agent's dependencies too
               const agentContent = await fs.readFile(coreAgentPath, 'utf8');
-              const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
+              const yamlContent = extractYamlFromAgent(agentContent, true);
               
-              if (yamlMatch) {
+              if (yamlContent) {
                 try {
-                  // Clean up the YAML to handle command descriptions
-                  let yamlContent = yamlMatch[1];
-                  yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
                   
                   const agentConfig = yaml.parse(yamlContent);
                   const dependencies = agentConfig.dependencies || {};
@@ -1340,7 +1328,7 @@ class Installer {
                     const deps = dependencies[depType] || [];
                     
                     for (const dep of deps) {
-                      const depFileName = dep.endsWith('.md') || dep.endsWith('.yml') ? dep : `${dep}.md`;
+                      const depFileName = dep.endsWith('.md') || dep.endsWith('.yaml') ? dep : `${dep}.md`;
                       const expansionDepPath = path.join(expansionDotFolder, depType, depFileName);
                       
                       // Check if dependency exists in expansion pack
@@ -1370,7 +1358,7 @@ class Installer {
                 }
               }
             } else {
-              console.warn(chalk.yellow(`  Warning: Core agent ${agentId} not found for team ${path.basename(teamFile, '.yml')}`));
+              console.warn(chalk.yellow(`  Warning: Core agent ${agentId} not found for team ${path.basename(teamFile, '.yaml')}`));
             }
           }
         }
@@ -1538,7 +1526,7 @@ class Installer {
       
       if (stats) {
         // Check if it has a manifest
-        const manifestPath = path.join(folderPath, "install-manifest.yml");
+        const manifestPath = path.join(folderPath, "install-manifest.yaml");
         if (await fileManager.pathExists(manifestPath)) {
           const manifest = await fileManager.readExpansionPackManifest(installDir, folder.substring(1));
           if (manifest) {
@@ -1549,8 +1537,8 @@ class Installer {
             };
           }
         } else {
-          // Check if it has a config.yml (expansion pack without manifest)
-          const configPath = path.join(folderPath, "config.yml");
+          // Check if it has a config.yaml (expansion pack without manifest)
+          const configPath = path.join(folderPath, "config.yaml");
           if (await fileManager.pathExists(configPath)) {
             expansionPacks[folder.substring(1)] = {
               path: folderPath,
@@ -1589,7 +1577,7 @@ class Installer {
       
       for (const file of filesToRestore) {
         // Skip the manifest file itself
-        if (file.endsWith('install-manifest.yml')) continue;
+        if (file.endsWith('install-manifest.yaml')) continue;
         
         const relativePath = file.replace(`.${packId}/`, '');
         const sourcePath = path.join(pack.packPath, relativePath);
@@ -1655,7 +1643,7 @@ class Installer {
 
     while (currentDir !== path.dirname(currentDir)) {
       const bmadDir = path.join(currentDir, ".bmad-core");
-      const manifestPath = path.join(bmadDir, "install-manifest.yml");
+      const manifestPath = path.join(bmadDir, "install-manifest.yaml");
 
       if (await fileManager.pathExists(manifestPath)) {
         return bmadDir;
@@ -1666,7 +1654,7 @@ class Installer {
 
     // Also check if we're inside a .bmad-core directory
     if (path.basename(process.cwd()) === ".bmad-core") {
-      const manifestPath = path.join(process.cwd(), "install-manifest.yml");
+      const manifestPath = path.join(process.cwd(), "install-manifest.yaml");
       if (await fileManager.pathExists(manifestPath)) {
         return process.cwd();
       }

package/tools/installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.23.0",
+  "version": "4.24.1",
   "description": "BMAD Method installer - AI-powered Agile development framework",
   "main": "lib/installer.js",
   "bin": {

package/tools/lib/dependency-resolver.js

@@ -1,6 +1,7 @@
 const fs = require('fs').promises;
 const path = require('path');
 const yaml = require('js-yaml');
+const { extractYamlFromAgent } = require('./yaml-utils');
 
 class DependencyResolver {
   constructor(rootDir) {
@@ -14,17 +15,12 @@ class DependencyResolver {
     const agentPath = path.join(this.bmadCore, 'agents', `${agentId}.md`);
     const agentContent = await fs.readFile(agentPath, 'utf8');
     
-    // Extract YAML from markdown content
-    const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)\n```/);
-    if (!yamlMatch) {
+    // Extract YAML from markdown content with command cleaning
+    const yamlContent = extractYamlFromAgent(agentContent, true);
+    if (!yamlContent) {
       throw new Error(`No YAML configuration found in agent ${agentId}`);
     }
     
-    // Clean up the YAML to handle command descriptions after dashes
-    let yamlContent = yamlMatch[1];
-    // Fix commands section: convert "- command - description" to just "- command"
-    yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
-    
     const agentConfig = yaml.load(yamlContent);
     
     const dependencies = {
@@ -53,7 +49,7 @@ class DependencyResolver {
   }
 
   async resolveTeamDependencies(teamId) {
-    const teamPath = path.join(this.bmadCore, 'agent-teams', `${teamId}.yml`);
+    const teamPath = path.join(this.bmadCore, 'agent-teams', `${teamId}.yaml`);
     const teamContent = await fs.readFile(teamPath, 'utf8');
     const teamConfig = yaml.load(teamContent);
     
@@ -120,7 +116,7 @@ class DependencyResolver {
     }
 
     try {
-      const extensions = ['.md', '.yml', '.yaml'];
+      const extensions = ['.md', '.yaml'];
       let content = null;
       let filePath = null;
 
@@ -183,12 +179,12 @@ class DependencyResolver {
     try {
       const files = await fs.readdir(path.join(this.bmadCore, 'agent-teams'));
       return files
-        .filter(f => f.endsWith('.yml'))
-        .map(f => f.replace('.yml', ''));
+        .filter(f => f.endsWith('.yaml'))
+        .map(f => f.replace('.yaml', ''));
     } catch (error) {
       return [];
     }
   }
 }
 
-module.exports = DependencyResolver;
+module.exports = DependencyResolver;

package/tools/lib/yaml-utils.js

@@ -0,0 +1,29 @@
+/**
+ * Utility functions for YAML extraction from agent files
+ */
+
+/**
+ * Extract YAML content from agent markdown files
+ * @param {string} agentContent - The full content of the agent file
+ * @param {boolean} cleanCommands - Whether to clean command descriptions (default: false)
+ * @returns {string|null} - The extracted YAML content or null if not found
+ */
+function extractYamlFromAgent(agentContent, cleanCommands = false) {
+  // Remove carriage returns and match YAML block
+  const yamlMatch = agentContent.replace(/\r/g, "").match(/```ya?ml\n([\s\S]*?)\n```/);
+  if (!yamlMatch) return null;
+  
+  let yamlContent = yamlMatch[1].trim();
+  
+  // Clean up command descriptions if requested
+  // Converts "- command - description" to just "- command"
+  if (cleanCommands) {
+    yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
+  }
+  
+  return yamlContent;
+}
+
+module.exports = {
+  extractYamlFromAgent
+};

package/tools/update-expansion-version.js

@@ -22,8 +22,8 @@ if (!/^\d+\.\d+\.\d+$/.test(newVersion)) {
 
 async function updateVersion() {
   try {
-    // Update in config.yml
-    const configPath = path.join(__dirname, '..', 'expansion-packs', packId, 'config.yml');
+    // Update in config.yaml
+    const configPath = path.join(__dirname, '..', 'expansion-packs', packId, 'config.yaml');
     
     if (!fs.existsSync(configPath)) {
       console.error(`Error: Expansion pack '${packId}' not found`);
@@ -39,7 +39,7 @@ async function updateVersion() {
     const updatedYaml = yaml.dump(config, { indent: 2 });
     fs.writeFileSync(configPath, updatedYaml);
     
-    console.log(`✓ Updated ${packId}/config.yml: ${oldVersion} → ${newVersion}`);
+    console.log(`✓ Updated ${packId}/config.yaml: ${oldVersion} → ${newVersion}`);
     console.log(`\n✓ Successfully updated ${packId} to version ${newVersion}`);
     console.log('\nNext steps:');
     console.log('1. Test the changes');

package/tools/yaml-format.js

@@ -197,7 +197,7 @@ async function main() {
       let changed = false;
       if (ext === '.md') {
         changed = await processMarkdownFile(filePath);
-      } else if (ext === '.yml' || ext === '.yaml' || basename.includes('roomodes') || basename.includes('.yml') || basename.includes('.yaml')) {
+      } else if (ext === '.yaml' || ext === '.yml' || basename.includes('roomodes') || basename.includes('.yaml') || basename.includes('.yml')) {
         // Handle YAML files and special cases like .roomodes
         changed = await processYamlFile(filePath);
         

package/bmad-core/workflows/brownfield-fullstack.yml

@@ -1,112 +0,0 @@
-workflow:
-  id: brownfield-fullstack
-  name: Brownfield Full-Stack Enhancement
-  description: >-
-    Agent workflow for enhancing existing full-stack applications with new features,
-    modernization, or significant changes. Handles existing system analysis and safe integration.
-  type: brownfield
-  project_types:
-    - feature-addition
-    - refactoring
-    - modernization
-    - integration-enhancement
-
-  sequence:
-    - step: project_analysis
-      agent: architect
-      action: analyze existing project and use task document-project
-      creates: multiple documents per the document-project template
-      notes: "Review existing documentation, codebase structure, and identify integration points. Document current system understanding before proceeding."
-
-    - agent: pm
-      creates: prd.md
-      uses: brownfield-prd-tmpl
-      requires: existing_project_analysis
-      notes: "Creates comprehensive PRD with existing system analysis and enhancement planning. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
-
-    - agent: architect
-      creates: architecture.md
-      uses: brownfield-architecture-tmpl
-      requires: prd.md
-      notes: "Creates architecture with integration strategy and existing system constraints. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
-
-    - agent: po
-      validates: all_artifacts
-      uses: po-master-checklist
-      notes: "Validates all documents for integration safety and completeness. May require updates to any document."
-
-    - agent: various
-      updates: any_flagged_documents
-      condition: po_checklist_issues
-      notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
-
-    - workflow_end:
-      action: move_to_ide
-      notes: |
-        Planning phase complete! Now transition to IDE Development:
-        
-        1. ENSURE DOCUMENTS ARE IN PROJECT:
-           - Copy final prd.md to project's docs/prd.md
-           - Copy final architecture.md to project's docs/architecture.md
-           - All documents must be in the project before proceeding
-        
-        2. SHARD DOCUMENTS (in IDE):
-           - Option A: Use PO agent to shard: @po then ask to shard docs/prd.md
-           - Option B: Manual: Drag shard-doc task + docs/prd.md into chat
-           - This creates docs/prd/ and docs/architecture/ folders with sharded content
-        
-        3. START DEVELOPMENT CYCLE:
-           a. SM Agent (New Chat): @sm → *create
-              - Creates next story from sharded docs
-              - Review and approve story (Draft → Approved)
-           
-           b. Dev Agent (New Chat): @dev
-              - Implements approved story
-              - Updates File List with all changes
-              - Marks story as "Review" when complete
-           
-           c. QA Agent (New Chat): @qa → review-story
-              - Senior dev review with refactoring ability
-              - Fixes small issues directly
-              - Leaves checklist for remaining items
-              - Updates story status (Review → Done or stays Review)
-           
-           d. If QA left unchecked items:
-              - Dev Agent (New Chat): Address remaining items
-              - Return to QA for final approval
-        
-        4. REPEAT: Continue cycle for all epic stories
-        
-        Reference: data#bmad-kb:IDE Development Workflow
-
-  flow_diagram: |
-    ```mermaid
-    graph TD
-        A[Start: Brownfield Enhancement] --> B[analyst: analyze existing project]
-        B --> C[pm: prd.md]
-        C --> D[architect: architecture.md]
-        D --> E[po: validate with po-master-checklist]
-        E --> F{PO finds issues?}
-        F -->|Yes| G[Return to relevant agent for fixes]
-        F -->|No| H[Move to IDE Environment]
-        G --> E
-
-        style H fill:#90EE90
-        style C fill:#FFE4B5
-        style D fill:#FFE4B5
-    ```
-
-  decision_guidance:
-    when_to_use:
-      - Enhancement requires coordinated stories
-      - Architectural changes are needed
-      - Significant integration work required
-      - Risk assessment and mitigation planning necessary
-      - Multiple team members will work on related changes
-
-  handoff_prompts:
-    analyst_to_pm: "Existing project analysis complete. Create comprehensive PRD with integration strategy."
-    pm_to_architect: "PRD ready. Save it as docs/prd.md, then create the integration architecture."
-    architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for integration safety."
-    po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
-    complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."