bmad-method 6.0.0-alpha.15 → 6.0.0-alpha.17

package/tools/cli/lib/xml-handler.js

@@ -44,18 +44,7 @@ class XmlHandler {
    * @returns {Object} Parsed activation block
    */
   async loadActivationTemplate() {
-    const templatePath = getSourcePath('utility', 'models', 'agent-activation-ide.xml');
-
-    try {
-      const xmlContent = await fs.readFile(templatePath, 'utf8');
-
-      // Parse the XML directly (file is now pure XML)
-      const parsed = await this.parser.parseStringPromise(xmlContent);
-      return parsed.activation;
-    } catch (error) {
-      console.error('Failed to load activation template:', error);
-      return null;
-    }
+    console.error('Failed to load activation template:', error);
   }
 
   /**
@@ -136,51 +125,10 @@ class XmlHandler {
   }
 
   /**
-   * Simple string-based injection (fallback method for legacy XML agents)
-   * This preserves formatting better than XML parsing
+   * TODO: DELETE THIS METHOD
    */
   injectActivationSimple(agentContent, metadata = {}) {
-    // Check if already has activation
-    if (agentContent.includes('<activation')) {
-      return agentContent;
-    }
-
-    // Load template file
-    const templatePath = getSourcePath('utility', 'models', 'agent-activation-ide.xml');
-
-    try {
-      const templateContent = fs.readFileSync(templatePath, 'utf8');
-
-      // The file is now pure XML, use it directly with proper indentation
-      // Add 2 spaces of indentation for insertion into agent
-      let activationBlock = templateContent
-        .split('\n')
-        .map((line) => (line ? '  ' + line : ''))
-        .join('\n');
-
-      // Replace {agent-filename} with actual filename if metadata provided
-      if (metadata.module && metadata.name) {
-        const agentFilename = `${metadata.module}-${metadata.name}.md`;
-        activationBlock = activationBlock.replace('{agent-filename}', agentFilename);
-      }
-
-      // Find where to insert (after <agent> tag)
-      const agentMatch = agentContent.match(/(<agent[^>]*>)/);
-      if (!agentMatch) {
-        return agentContent;
-      }
-
-      const insertPos = agentMatch.index + agentMatch[0].length;
-
-      // Insert the activation block
-      const before = agentContent.slice(0, insertPos);
-      const after = agentContent.slice(insertPos);
-
-      return before + '\n' + activationBlock + after;
-    } catch (error) {
-      console.error('Error in simple injection:', error);
-      return agentContent;
-    }
+    console.error('Error in simple injection:', error);
   }
 
   /**

package/tools/cli/lib/yaml-format.js

@@ -1,6 +1,6 @@
 const fs = require('node:fs');
 const path = require('node:path');
-const yaml = require('js-yaml');
+const yaml = require('yaml');
 const { execSync } = require('node:child_process');
 
 // Dynamic import for ES module
@@ -57,11 +57,10 @@ async function formatYamlContent(content, filename) {
     }
 
     // Parse and re-dump YAML to format it
-    const parsed = yaml.load(fixedContent);
-    const formatted = yaml.dump(parsed, {
+    const parsed = yaml.parse(fixedContent);
+    const formatted = yaml.stringify(parsed, {
       indent: 2,
-      lineWidth: -1, // Disable line wrapping
-      noRefs: true,
+      lineWidth: 0, // Disable line wrapping
       sortKeys: false, // Preserve key order
     });
     // Ensure POSIX-compliant final newline
@@ -96,7 +95,6 @@ async function processMarkdownFile(filePath) {
     const [fullMatch, yamlContent] = match;
     const formatted = await formatYamlContent(yamlContent, filePath);
     if (formatted !== null) {
-      // Remove trailing newline that js-yaml adds
       const trimmedFormatted = formatted.replace(/\n$/, '');
 
       if (trimmedFormatted !== yamlContent) {

package/tools/cli/lib/yaml-xml-builder.js

@@ -1,9 +1,10 @@
-const yaml = require('js-yaml');
+const yaml = require('yaml');
 const fs = require('fs-extra');
 const path = require('node:path');
 const crypto = require('node:crypto');
 const { AgentAnalyzer } = require('./agent-analyzer');
 const { ActivationBuilder } = require('./activation-builder');
+const { escapeXml } = require('../../lib/xml-utils');
 
 /**
  * Converts agent YAML files to XML format with smart activation injection
@@ -63,13 +64,13 @@ class YamlXmlBuilder {
   async loadAndMergeAgent(agentYamlPath, customizeYamlPath = null) {
     // Load base agent
     const agentContent = await fs.readFile(agentYamlPath, 'utf8');
-    const agentYaml = yaml.load(agentContent);
+    const agentYaml = yaml.parse(agentContent);
 
     // Load customization if exists
     let merged = agentYaml;
     if (customizeYamlPath && (await fs.pathExists(customizeYamlPath))) {
       const customizeContent = await fs.readFile(customizeYamlPath, 'utf8');
-      const customizeYaml = yaml.load(customizeContent);
+      const customizeYaml = yaml.parse(customizeContent);
 
       if (customizeYaml) {
         // Special handling: persona fields are merged, but only non-empty values override
@@ -241,15 +242,15 @@ class YamlXmlBuilder {
     let xml = '  <persona>\n';
 
     if (persona.role) {
-      xml += `    <role>${this.escapeXml(persona.role)}</role>\n`;
+      xml += `    <role>${escapeXml(persona.role)}</role>\n`;
     }
 
     if (persona.identity) {
-      xml += `    <identity>${this.escapeXml(persona.identity)}</identity>\n`;
+      xml += `    <identity>${escapeXml(persona.identity)}</identity>\n`;
     }
 
     if (persona.communication_style) {
-      xml += `    <communication_style>${this.escapeXml(persona.communication_style)}</communication_style>\n`;
+      xml += `    <communication_style>${escapeXml(persona.communication_style)}</communication_style>\n`;
     }
 
     if (persona.principles) {
@@ -260,7 +261,7 @@ class YamlXmlBuilder {
       } else {
         principlesText = persona.principles;
       }
-      xml += `    <principles>${this.escapeXml(principlesText)}</principles>\n`;
+      xml += `    <principles>${escapeXml(principlesText)}</principles>\n`;
     }
 
     xml += '  </persona>\n';
@@ -277,7 +278,7 @@ class YamlXmlBuilder {
     let xml = '  <memories>\n';
 
     for (const memory of memories) {
-      xml += `    <memory>${this.escapeXml(memory)}</memory>\n`;
+      xml += `    <memory>${escapeXml(memory)}</memory>\n`;
     }
 
     xml += '  </memories>\n';
@@ -314,7 +315,7 @@ class YamlXmlBuilder {
     for (const prompt of promptsArray) {
       xml += `    <prompt id="${prompt.id || ''}">\n`;
       xml += `      <content>\n`;
-      xml += `${this.escapeXml(prompt.content || '')}\n`;
+      xml += `${escapeXml(prompt.content || '')}\n`;
       xml += `      </content>\n`;
       xml += `    </prompt>\n`;
     }
@@ -351,7 +352,7 @@ class YamlXmlBuilder {
 
         // Handle multi format menu items with nested handlers
         if (item.multi && item.triggers && Array.isArray(item.triggers)) {
-          xml += `    <item type="multi">${this.escapeXml(item.multi)}\n`;
+          xml += `    <item type="multi">${escapeXml(item.multi)}\n`;
           xml += this.buildNestedHandlers(item.triggers);
           xml += `    </item>\n`;
         }
@@ -381,7 +382,7 @@ class YamlXmlBuilder {
           if (item.data) attrs.push(`data="${item.data}"`);
           if (item.action) attrs.push(`action="${item.action}"`);
 
-          xml += `    <item ${attrs.join(' ')}>${this.escapeXml(item.description || '')}</item>\n`;
+          xml += `    <item ${attrs.join(' ')}>${escapeXml(item.description || '')}</item>\n`;
         }
       }
     }
@@ -412,7 +413,7 @@ class YamlXmlBuilder {
 
         // For nested handlers in multi items, we don't need cmd attribute
         // The match attribute will handle fuzzy matching
-        const attrs = [`match="${this.escapeXml(execData.description || '')}"`];
+        const attrs = [`match="${escapeXml(execData.description || '')}"`];
 
         // Add handler attributes based on exec data
         if (execData.route) attrs.push(`exec="${execData.route}"`);
@@ -482,19 +483,6 @@ class YamlXmlBuilder {
     return result;
   }
 
-  /**
-   * Escape XML special characters
-   */
-  escapeXml(text) {
-    if (!text) return '';
-    return text
-      .replaceAll('&', '&amp;')
-      .replaceAll('<', '&lt;')
-      .replaceAll('>', '&gt;')
-      .replaceAll('"', '&quot;')
-      .replaceAll("'", '&apos;');
-  }
-
   /**
    * Calculate file hash for build tracking
    */
@@ -537,7 +525,7 @@ class YamlXmlBuilder {
     } else if (bmadIndex !== -1 && pathParts[bmadIndex + 1]) {
       // Path contains /bmad/{module}/
       const potentialModule = pathParts[bmadIndex + 1];
-      // Check if it's a known module, not 'agents' or '_cfg'
+      // Check if it's a known module, not 'agents' or '_config'
       if (['bmm', 'bmb', 'cis', 'core'].includes(potentialModule)) {
         module = potentialModule;
       }

package/tools/flattener/ignoreRules.js

@@ -6,7 +6,7 @@ const ignore = require('ignore');
 // These complement .gitignore and are applied regardless of VCS presence.
 const DEFAULT_PATTERNS = [
   // Project/VCS
-  '**/.bmad-method/**',
+  '**/_bmad/**',
   '**/.git/**',
   '**/.svn/**',
   '**/.hg/**',

package/tools/flattener/xml.js

@@ -1,11 +1,5 @@
 const fs = require('fs-extra');
-
-function escapeXml(string_) {
-  if (typeof string_ !== 'string') {
-    return String(string_);
-  }
-  return string_.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll("'", '&apos;');
-}
+const { escapeXml } = require('../lib/xml-utils');
 
 function indentFileContent(content) {
   if (typeof content !== 'string') {

package/tools/lib/xml-utils.js

@@ -0,0 +1,13 @@
+/**
+ * Escape XML special characters in a string
+ * @param {string} text - The text to escape
+ * @returns {string} The escaped text
+ */
+function escapeXml(text) {
+  if (!text) return '';
+  return text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;').replaceAll("'", '&apos;');
+}
+
+module.exports = {
+  escapeXml,
+};

package/tools/migrate-custom-module-paths.js

@@ -12,7 +12,7 @@ const chalk = require('chalk');
  * Find BMAD directory in project
  */
 function findBmadDir(projectDir = process.cwd()) {
-  const possibleNames = ['bmad', '.bmad'];
+  const possibleNames = ['_bmad'];
 
   for (const name of possibleNames) {
     const bmadDir = path.join(projectDir, name);
@@ -95,7 +95,7 @@ async function migrate(directory) {
   console.log(chalk.dim(`Project: ${projectRoot}`));
   console.log(chalk.dim(`BMAD Directory: ${bmadDir}`));
 
-  const manifestPath = path.join(bmadDir, '_cfg', 'manifest.yaml');
+  const manifestPath = path.join(bmadDir, '_config', 'manifest.yaml');
 
   if (!fs.existsSync(manifestPath)) {
     console.error(chalk.red('✗ No manifest.yaml found'));

package/tools/validate-agent-schema.js

@@ -12,7 +12,7 @@
  */
 
 const { glob } = require('glob');
-const yaml = require('js-yaml');
+const yaml = require('yaml');
 const fs = require('node:fs');
 const path = require('node:path');
 const { validateAgentFile } = require('./schema/agent.js');
@@ -49,7 +49,7 @@ async function main(customProjectRoot) {
 
     try {
       const fileContent = fs.readFileSync(filePath, 'utf8');
-      const agentData = yaml.load(fileContent);
+      const agentData = yaml.parse(fileContent);
 
       // Convert absolute path to relative src/ path for module detection
       const srcRelativePath = relativePath.startsWith('src/') ? relativePath : path.relative(project_root, filePath).replaceAll('\\', '/');

package/docs/v6-open-items.md

@@ -1,17 +0,0 @@
-# v6 Pending Items
-
-Before calling this beta
-
-- finalize web bundler
-- some subagents working again
-- knowledge base for bmad
-
-## Needed Beta → v0 release
-
-Aside from stability and bug fixes found during the alpha period - the main focus will be on the following:
-
-- knowledge base for BMM
-- Module repository and submission process defined
-- MCP Injections based on installation selection
-- sub agent for open-code and claude code optimization
-- TDD Workflow Integration

package/example-custom-content/README.md

@@ -1,8 +0,0 @@
-# Example Custom Content module
-
-This is a demonstration of custom stand along agents and workflows. By having this content all in a folder with a custom.yaml file,
-These items will be discovered by the installer and offered for installation.
-
-This is how you could also create and share other custom agents and workflows not tied to a specific module.
-
-To see how these become installable, rename custom.bak -> custom.yaml and run the installer from the location you also have put this folder.

package/example-custom-module/mwm/README.md

@@ -1,9 +0,0 @@
-# EXAMPLE MODULE WARNING
-
-This module is an example and is not at all recommended for any usage, this module was not vetted by any medical professionals and should
-be considered at best for entertainment purposes only.
-
-You should see the option in the module selector when installing.
-
-If you have received a module from someone else that is not in the official installation - you can install it similarly by running the
-normal bmad-method installer from the the same location you have placed the folder.

package/example-custom-module/mwm/agents/cbt-coach/cbt-coach-sidecar/cognitive-distortions.md

@@ -1,47 +0,0 @@
-# CBT Coach - Cognitive Distortions Reference
-
-## The 10 Cognitive Distortions
-
-1. **All-or-Nothing Thinking**
-   - Seeing things in black-and-white categories
-   - Example: "If I'm not perfect, I'm a failure"
-
-2. **Overgeneralization**
-   - Seeing a single negative event as a never-ending pattern
-   - Example: "I didn't get the job, so I'll never get hired"
-
-3. **Mental Filter**
-   - Dwell on negatives and ignore positives
-   - Example: Focusing on one criticism in an otherwise good review
-
-4. **Disqualifying the Positive**
-   - Rejecting positive experiences as "don't count"
-   - Example: "They were just being nice"
-
-5. **Jumping to Conclusions**
-   - Mind reading (assuming you know what others think)
-   - Fortune telling (predicting the future negatively)
-
-6. **Magnification/Minimization**
-   - Exaggerating negatives or shrinking positives
-   - Example: "Making a mistake feels catastrophic"
-
-7. **Emotional Reasoning**
-   - Believing something because it feels true
-   - Example: "I feel anxious, so danger must be near"
-
-8. **"Should" Statements**
-   - Using "shoulds" to motivate
-   - Example: "I should be more productive"
-
-9. **Labeling**
-   - Assigning global negative traits
-   - Example: "I'm a loser" instead of "I made a mistake"
-
-10. **Personalization**
-    - Taking responsibility/blame for things outside your control
-    - Example: "It's my fault the party wasn't fun"
-
-## User's Common Patterns
-
-_Track which distortions appear most frequently_

package/example-custom-module/mwm/agents/cbt-coach/cbt-coach-sidecar/thought-records.md

@@ -1,17 +0,0 @@
-# CBT Coach - Thought Records
-
-## Thought Record History
-
-_CBT thought records are documented here for pattern tracking and progress review_
-
-## Common Patterns Identified
-
-_Recurring cognitive distortions and thought patterns_
-
-## Successful Reframes
-
-_Examples of successful cognitive restructuring_
-
-## Homework Assignments
-
-_CBT exercises and behavioral experiments_

package/example-custom-module/mwm/agents/cbt-coach/cbt-coach.agent.yaml

@@ -1,151 +0,0 @@
-agent:
-  metadata:
-    id: "{bmad_folder}/mwm/agents/cbt-coach/cbt-coach.md"
-    name: "Dr. Alexis, M.D."
-    title: "CBT Coach"
-    icon: "🧠"
-    module: "mwm"
-    hasSidecar: true
-  persona:
-    role: "Cognitive Behavioral Therapy specialist"
-    identity: |
-      A structured yet empathetic CBT practitioner who helps users identify and reframe negative thought patterns using evidence-based techniques. Skilled at making cognitive behavioral concepts accessible and practical for daily use. Balances clinical expertise with genuine care for user progress.
-    communication_style: |
-      Clear, structured, and educational. Uses simple language to explain CBT concepts. Asks targeted questions to guide insight. Provides concrete exercises and homework. Validates struggles while encouraging growth. Uses Socratic questioning to help users discover their own insights.
-    principles:
-      - "Thoughts are not facts - they can be examined and challenged"
-      - "Behavior change follows cognitive change"
-      - "Small, consistent practice creates lasting change"
-      - "Self-compassion is essential for growth"
-      - "Evidence over assumptions"
-
-  critical_actions:
-    - "Load COMPLETE file {agent_sidecar_folder}/cbt-coach-sidecar/thought-records.md and review previous CBT work"
-    - "Load COMPLETE file {agent_sidecar_folder}/cbt-coach-sidecar/cognitive-distortions.md and reference recognized patterns"
-    - "Load COMPLETE file {agent_sidecar_folder}/cbt-coach-sidecar/progress.md and track user development"
-    - "ONLY read/write files in {agent_sidecar_folder}/cbt-coach-sidecar/ - this is our CBT workspace"
-
-  prompts:
-    - id: "thought-record"
-      content: |
-        <instructions>
-        Guide user through completing a CBT thought record
-        </instructions>
-
-        Let's work through a thought record together. This powerful tool helps us examine our thinking patterns.
-
-        **Step 1: Situation**
-        What was happening when the upsetting feeling started? Be specific - time, place, who was there?
-
-        **Step 2: Automatic Thoughts**
-        What thoughts went through your mind? List them exactly as they occurred.
-
-        **Step 3: Emotions**
-        What emotions did you feel? Rate each from 0-100 in intensity.
-
-        **Step 4: Cognitive Distortions**
-        Looking at your thoughts, which of these patterns might be present?
-        - All-or-nothing thinking
-        - Overgeneralization
-        - Mental filter
-        - Disqualifying the positive
-        - Jumping to conclusions
-        - Magnification/minimization
-        - Emotional reasoning
-        - "Should" statements
-        - Labeling
-        - Personalization
-
-        **Step 5: Alternative Thoughts**
-        What's a more balanced or realistic way to view this situation?
-
-        **Step 6: Outcome**
-        How do you feel now? Rate emotions again.
-
-    - id: "cognitive-reframing"
-      content: |
-        <instructions>
-        Help user identify and challenge negative thought patterns
-        </instructions>
-
-        Let's examine this thought pattern together.
-
-        First, identify the automatic thought: "I'll never be good enough at this"
-
-        Now, let's gather evidence:
-        - What evidence supports this thought?
-        - What evidence contradicts this thought?
-        - What would you tell a friend with this thought?
-        - What's a more balanced perspective?
-
-        Remember: We're looking for accuracy, not just positive thinking. Sometimes the balanced thought acknowledges real challenges while avoiding catastrophizing.
-
-        What feels most realistic and helpful to you now?
-
-    - id: "behavioral-experiment"
-      content: |
-        <instructions>
-        Design a behavioral experiment to test a belief
-        </instructions>
-
-        Let's design a small experiment to test your belief.
-
-        **The Belief:** "If I speak up in meetings, everyone will think I'm stupid"
-
-        **The Experiment:**
-        1. What's a small step to test this? (e.g., share one brief comment)
-        2. What do you predict will happen? (be specific)
-        3. How can you collect real data? (observe reactions, ask for feedback)
-        4. What would disprove your belief?
-        5. What would partially support it?
-
-        Remember: We're scientists testing hypotheses, not trying to prove ourselves right. What would be most informative to learn?
-
-  menu:
-    - multi: "[CH] Chat with Dr. Alexis or [SPM] Start Party Mode"
-      triggers:
-        - party-mode:
-            - input: SPM or fuzzy match start party mode
-            - route: "{project-root}/{bmad_folder}/core/workflows/edit-agent/workflow.md"
-            - data: CBT coach agent discussion
-            - type: exec
-        - expert-chat:
-            - input: CH or fuzzy match chat with dr alexis
-            - action: agent responds as CBT coach
-            - type: exec
-
-    - multi: "[TR] Thought Record [CF] Challenge Feeling"
-      triggers:
-        - thought-record:
-            - input: TR or fuzzy match thought record
-            - route: "{project-root}/{bmad_folder}/mwm/workflows/cbt-thought-record/workflow.md"
-            - description: "Complete thought record 📝"
-            - type: exec
-        - challenge-feeling:
-            - input: CF or fuzzy match challenge feeling
-            - action: "#cognitive-reframing"
-            - description: "Challenge thoughts 🔄"
-            - type: exec
-
-    - multi: "[BE] Behavioral Experiment [CD] Cognitive Distortions"
-      triggers:
-        - behavior-experiment:
-            - input: BE or fuzzy match behavioral experiment
-            - action: "#behavioral-experiment"
-            - description: "Test your beliefs 🧪"
-            - type: exec
-        - cognitive-distortions:
-            - input: CD or fuzzy match cognitive distortions
-            - action: "Review and explain the 10 common cognitive distortions with examples"
-            - description: "Learn distortions 🎭"
-            - type: exec
-
-    - trigger: "core-beliefs"
-      action: "Guide exploration of core beliefs using downward arrow technique"
-      description: "Explore core beliefs 💎"
-      type: action
-
-    - trigger: "save-thought-work"
-      action: "Save this thought work to {agent_sidecar_folder}/cbt-coach-sidecar/thought-records.md with date and patterns"
-      description: "Save thought work 💾"
-      type: action