bmad-method 4.24.0 → 4.24.2

package/expansion-packs/bmad-2d-phaser-game-dev/{config.yml → config.yaml}

@@ -1,5 +1,5 @@
 name: bmad-2d-phaser-game-dev
-version: 1.2.0
+version: 1.3.0
 short-title: 2D game development with Phaser 3 & TypeScript
 description: >-
   2D Game Development expansion pack for BMAD Method - Phaser 3 & TypeScript

package/expansion-packs/bmad-creator-tools/{config.yml → config.yaml}

@@ -1,5 +1,5 @@
 name: bmad-creator-tools
-version: 1.1.0
+version: 1.2.0
 short-title: Tools for creating BMAD framework components
 description: Tools for creating and extending BMAD framework components.
 author: Brian (BMad)

package/expansion-packs/bmad-creator-tools/tasks/generate-expansion-pack.md

@@ -286,7 +286,7 @@ IMPORTANT: Only proceed after plan.md is approved
 expansion-packs/
 └── {pack-name}/
 ├── plan.md (ALREADY CREATED)
-├── manifest.yml
+├── manifest.yaml
 ├── README.md
 ├── agents/
 │ ├── {pack-name}-orchestrator.md (REQUIRED - Custom themed orchestrator)
@@ -309,13 +309,13 @@ expansion-packs/
 ├── workflows/
 │ └── {domain}-workflow.md (REQUIRED if multiple agents)
 └── agent-teams/
-└── {domain}-team.yml (REQUIRED if multiple agents)
+└── {domain}-team.yaml (REQUIRED if multiple agents)
 
 ```
 
 #### 3.2 Create Manifest
 
-Create `manifest.yml`:
+Create `manifest.yaml`:
 
 ```yaml
 name: {pack-name}
@@ -358,7 +358,7 @@ files:
     - {domain}-workflow.md        # REQUIRED if multiple agents - decision trees
 
   agent-teams:
-    - {domain}-team.yml           # REQUIRED if multiple agents - team config
+    - {domain}-team.yaml          # REQUIRED if multiple agents - team config
 
 # Data files users must provide (in their bmad-core/data/ directory)
 required_user_data:
@@ -494,7 +494,7 @@ cp common/utils/workflow-management.md expansion-packs/{pack-name}/utils/
 1. Design decision trees for workflow branching
 2. Create handoff protocols to specialist agents
 3. Implement validation loops and quality checkpoints
-4. **If multiple agents**: Create team configuration in `agent-teams/{domain}-team.yml`
+4. **If multiple agents**: Create team configuration in `agent-teams/{domain}-team.yaml`
 5. **If multiple agents**: Create workflow in `workflows/{domain}-workflow.md`
 6. Ensure orchestrator references workflow-management utility
 7. Verify ALL referenced tasks exist (including core utilities)
@@ -665,7 +665,7 @@ Before declaring complete:
 
 1. [ ] Decision trees and workflow orchestration complete
 2. [ ] Knowledge base files embedded (best practices, terminology, standards)
-3. [ ] Manifest.yml reflects all components and dependencies
+3. [ ] Manifest.yaml reflects all components and dependencies
 4. [ ] All items in plan.md marked complete
 5. [ ] No orphaned tasks or templates
 
@@ -772,7 +772,7 @@ These files are automatically available to all agents and don't require user set
 ```text
 healthcare/
 ├── plan.md (Created first for approval)
-├── manifest.yml (with dependency mapping and character descriptions)
+├── manifest.yaml (with dependency mapping and character descriptions)
 ├── README.md (featuring character introductions and numbered options)
 ├── agents/
 │   ├── healthcare-orchestrator.md (Dr. Sarah Chen - YAML-in-Markdown)
@@ -798,7 +798,7 @@ healthcare/
 │   ├── clinical-trial-workflow.md (decision trees with Mermaid diagrams)
 │   └── compliance-audit-workflow.md (handoff protocols and quality gates)
 └── agent-teams/
-    └── healthcare-team.yml (coordinated team configurations)
+    └── healthcare-team.yaml (coordinated team configurations)
 
 Required user data files (bmad-core/data/):
 - medical-terminology.md (institution-specific terms and abbreviations)
@@ -1009,7 +1009,7 @@ Embedded knowledge (automatic):
 - [ ] All agent references verified (tasks, templates, data, checklists)
 - [ ] Data requirements documented with validation criteria and examples
 - [ ] README includes character introductions and numbered options explanation
-- [ ] manifest.yml reflects actual files with dependency mapping and character descriptions
+- [ ] manifest.yaml reflects actual files with dependency mapping and character descriptions
 
 **Advanced Quality Gates:**
 

package/expansion-packs/bmad-creator-tools/templates/agent-teams-tmpl.md

@@ -150,5 +150,5 @@ workflows: null
 3. Replace all placeholders with actual values
 4. Ensure agent names match available agents in the system
 5. Verify workflow names match available workflows
-6. Save as team-[descriptor].yml or [domain]-team.yml
+6. Save as team-[descriptor].yaml or [domain]-team.yaml
 7. Place in the agent-teams directory of the appropriate location]]

package/expansion-packs/bmad-creator-tools/templates/agent-tmpl.md

@@ -10,7 +10,7 @@
 
 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:
 
-```yml
+```yaml
 activation-instructions:
     - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
     - Only read the files/tasks listed here when user selects them for execution to minimize context usage

package/expansion-packs/bmad-infrastructure-devops/README.md

@@ -28,7 +28,7 @@ Install this expansion pack when your project requires:
 
 ### Agents
 
-- `devops.yml` - DevOps and Platform Engineering agent configuration
+- `devops.yaml` - DevOps and Platform Engineering agent configuration
 
 ### Personas
 
@@ -116,8 +116,8 @@ Before deployment:
 
 The DevOps agent can be added to team configurations:
 
-- `team-technical.yml` - For technical implementation teams
-- `team-full-org.yml` - For complete organizational teams
+- `team-technical.yaml` - For technical implementation teams
+- `team-full-org.yaml` - For complete organizational teams
 
 ## Dependencies
 

package/expansion-packs/bmad-infrastructure-devops/{config.yml → config.yaml}

@@ -1,5 +1,5 @@
 name: bmad-infrastructure-devops
-version: 1.1.0
+version: 1.2.0
 short-title: Infrastructure and DevOps capabilities
 description: >-
   This expansion pack extends BMAD Method with comprehensive infrastructure and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.24.0",
+  "version": "4.24.2",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "main": "tools/cli.js",
   "bin": {

package/tools/builders/web-builder.js

@@ -1,6 +1,7 @@
 const fs = require("node:fs").promises;
 const path = require("node:path");
 const DependencyResolver = require("../lib/dependency-resolver");
+const yamlUtils = require("../lib/yaml-utils");
 
 class WebBuilder {
   constructor(options = {}) {
@@ -111,10 +112,12 @@ class WebBuilder {
 
   processAgentContent(content) {
     // First, replace content before YAML with the template
+    const yamlContent = yamlUtils.extractYamlFromAgent(content);
+    if (!yamlContent) return content;
+
     const yamlMatch = content.match(/```ya?ml\n([\s\S]*?)\n```/);
     if (!yamlMatch) return content;
-
-    const yamlContent = yamlMatch[1];
+    
     const yamlStartIndex = content.indexOf(yamlMatch[0]);
     const yamlEndIndex = yamlStartIndex + yamlMatch[0].length;
 
@@ -259,7 +262,7 @@ class WebBuilder {
     const agentTeamsDir = path.join(packDir, "agent-teams");
     try {
       const teamFiles = await fs.readdir(agentTeamsDir);
-      const teamFile = teamFiles.find((f) => f.endsWith(".yml"));
+      const teamFile = teamFiles.find((f) => f.endsWith(".yaml"));
 
       if (teamFile) {
         console.log(`    Building team bundle for ${packName}`);
@@ -272,7 +275,7 @@ class WebBuilder {
         for (const outputDir of outputDirs) {
           const teamsOutputDir = path.join(outputDir, "teams");
           await fs.mkdir(teamsOutputDir, { recursive: true });
-          const outputFile = path.join(teamsOutputDir, teamFile.replace(".yml", ".txt"));
+          const outputFile = path.join(teamsOutputDir, teamFile.replace(".yaml", ".txt"));
           await fs.writeFile(outputFile, bundle, "utf8");
           console.log(`    ✓ Created bundle: ${path.relative(this.rootDir, outputFile)}`);
         }
@@ -294,11 +297,11 @@ class WebBuilder {
     sections.push(this.formatSection(`agents#${agentName}`, agentContent));
 
     // Resolve and add agent dependencies
-    const agentYaml = agentContent.match(/```yaml\n([\s\S]*?)\n```/);
-    if (agentYaml) {
+    const yamlContent = yamlUtils.extractYamlFromAgent(agentContent);
+    if (yamlContent) {
       try {
         const yaml = require("js-yaml");
-        const agentConfig = yaml.load(agentYaml[1]);
+        const agentConfig = yaml.load(yamlContent);
 
         if (agentConfig.dependencies) {
           // Add resources, first try expansion pack, then core
@@ -306,7 +309,7 @@ class WebBuilder {
             if (Array.isArray(resources)) {
               for (const resourceName of resources) {
                 let found = false;
-                const extensions = [".md", ".yml", ".yaml"];
+                const extensions = [".md", ".yaml"];
 
                 // Try expansion pack first
                 for (const ext of extensions) {
@@ -391,7 +394,7 @@ class WebBuilder {
 
     // Add team configuration and parse to get agent list
     const teamContent = await fs.readFile(teamConfigPath, "utf8");
-    const teamFileName = path.basename(teamConfigPath, ".yml");
+    const teamFileName = path.basename(teamConfigPath, ".yaml");
     const teamConfig = this.parseYaml(teamContent);
     sections.push(this.formatSection(`agent-teams#${teamFileName}`, teamContent));
 
@@ -416,9 +419,9 @@ class WebBuilder {
       try {
         const resourceFiles = await fs.readdir(resourcePath);
         for (const resourceFile of resourceFiles.filter(
-          (f) => f.endsWith(".md") || f.endsWith(".yml")
+          (f) => f.endsWith(".md") || f.endsWith(".yaml")
         )) {
-          const fileName = resourceFile.replace(/\.(md|yml)$/, "");
+          const fileName = resourceFile.replace(/\.(md|yaml)$/, "");
           expansionResources.set(`${resourceDir}#${fileName}`, true);
         }
       } catch (error) {
@@ -474,13 +477,9 @@ class WebBuilder {
           sections.push(this.formatSection(`agents#${agentId}`, coreAgentContent));
 
           // Parse and collect dependencies from core agent
-          const agentYaml = coreAgentContent.match(/```yaml\n([\s\S]*?)\n```/);
-          if (agentYaml) {
+          const yamlContent = yamlUtils.extractYamlFromAgent(coreAgentContent, true);
+          if (yamlContent) {
             try {
-              // Clean up the YAML to handle command descriptions after dashes
-              let yamlContent = agentYaml[1];
-              yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, "$1$2");
-
               const agentConfig = this.parseYaml(yamlContent);
               if (agentConfig.dependencies) {
                 for (const [resourceType, resources] of Object.entries(agentConfig.dependencies)) {
@@ -508,7 +507,7 @@ class WebBuilder {
     // Always prefer expansion pack versions if they exist
     for (const [key, dep] of allDependencies) {
       let found = false;
-      const extensions = [".md", ".yml", ".yaml"];
+      const extensions = [".md", ".yaml"];
 
       // Always check expansion pack first, even if the dependency came from a core agent
       if (expansionResources.has(key)) {
@@ -568,11 +567,11 @@ class WebBuilder {
       try {
         const resourceFiles = await fs.readdir(resourcePath);
         for (const resourceFile of resourceFiles.filter(
-          (f) => f.endsWith(".md") || f.endsWith(".yml")
+          (f) => f.endsWith(".md") || f.endsWith(".yaml")
         )) {
           const filePath = path.join(resourcePath, resourceFile);
           const fileContent = await fs.readFile(filePath, "utf8");
-          const fileName = resourceFile.replace(/\.(md|yml)$/, "");
+          const fileName = resourceFile.replace(/\.(md|yaml)$/, "");
 
           // Only add if not already included as a dependency
           const resourceKey = `${resourceDir}#${fileName}`;

package/tools/bump-all-versions.js

@@ -32,7 +32,7 @@ async function bumpAllVersions() {
   const updatedItems = [];
   
   // First, bump the core version
-  const coreConfigPath = path.join(__dirname, '..', 'bmad-core', 'core-config.yml');
+  const coreConfigPath = path.join(__dirname, '..', 'bmad-core', 'core-config.yaml');
   try {
     const coreConfigContent = fs.readFileSync(coreConfigPath, 'utf8');
     const coreConfig = yaml.load(coreConfigContent);
@@ -59,7 +59,7 @@ async function bumpAllVersions() {
     for (const entry of entries) {
       if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'README.md') {
         const packId = entry.name;
-        const configPath = path.join(expansionPacksDir, packId, 'config.yml');
+        const configPath = path.join(expansionPacksDir, packId, 'config.yaml');
         
         if (fs.existsSync(configPath)) {
           try {

package/tools/bump-core-version.js

@@ -30,7 +30,7 @@ function bumpVersion(currentVersion, type) {
 
 async function bumpCoreVersion() {
   try {
-    const coreConfigPath = path.join(__dirname, '..', 'bmad-core', 'core-config.yml');
+    const coreConfigPath = path.join(__dirname, '..', 'bmad-core', 'core-config.yaml');
     
     const coreConfigContent = fs.readFileSync(coreConfigPath, 'utf8');
     const coreConfig = yaml.load(coreConfigContent);

package/tools/bump-expansion-version.js

@@ -38,7 +38,7 @@ function bumpVersion(currentVersion, type) {
 
 async function updateVersion() {
   try {
-    const configPath = path.join(__dirname, '..', 'expansion-packs', packId, 'config.yml');
+    const configPath = path.join(__dirname, '..', 'expansion-packs', packId, 'config.yaml');
     
     if (!fs.existsSync(configPath)) {
       console.error(`Error: Expansion pack '${packId}' not found`);

package/tools/installer/README.md

@@ -16,7 +16,7 @@ installer/
 │   ├── ide-setup.js     # IDE-specific setup
 │   └── prompts.js       # Interactive CLI prompts
 ├── config/          # Configuration files
-│   └── install.config.yml # Installation profiles
+│   └── install.config.yaml # Installation profiles
 ├── templates/       # IDE template files
 │   ├── cursor-rules.md     # Cursor template
 │   ├── claude-commands.md  # Claude Code template

package/tools/installer/bin/bmad.js

@@ -158,7 +158,7 @@ async function promptInstallation() {
   const choices = [];
   
   // Load core config to get short-title
-  const coreConfigPath = path.join(__dirname, '..', '..', '..', 'bmad-core', 'core-config.yml');
+  const coreConfigPath = path.join(__dirname, '..', '..', '..', 'bmad-core', 'core-config.yaml');
   const coreConfig = yaml.load(await fs.readFile(coreConfigPath, 'utf8'));
   const coreShortTitle = coreConfig['short-title'] || 'BMad Agile Core System';
   
@@ -166,7 +166,7 @@ async function promptInstallation() {
   let bmadOptionText;
   if (state.type === 'v4_existing') {
     const currentVersion = state.manifest?.version || 'unknown';
-    const newVersion = coreConfig.version || 'unknown'; // Use version from core-config.yml
+    const newVersion = coreConfig.version || 'unknown'; // Use version from core-config.yaml
     const versionInfo = currentVersion === newVersion 
       ? `(v${currentVersion} - reinstall)`
       : `(v${currentVersion} → v${newVersion})`;

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();