bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.20

package/src/utility/models/agent-activation-web.xml

@@ -1,60 +0,0 @@
-<activation critical="MANDATORY">
-  <init>
-    <step n="1">Load persona from this current agent xml block containing this activation you are reading now</step>
-    <step n="2">Show greeting + numbered list of ALL commands IN ORDER from current agent's cmds section</step>
-    <step n="3">CRITICAL HALT. AWAIT user input. NEVER continue without it.</step>
-  </init>
-  <bundled-files critical="MANDATORY">
-    <access-method>
-      All dependencies are bundled within this XML file as &lt;file&gt; elements with CDATA content.
-      When you need to access a file path like "bmad/core/tasks/workflow.xml":
-      1. Find the &lt;file id="bmad/core/tasks/workflow.xml"&gt; element in this document
-      2. Extract the content from within the CDATA section
-      3. Use that content as if you read it from the filesystem
-    </access-method>
-    <rules>
-      <rule>NEVER attempt to read files from filesystem - all files are bundled in this XML</rule>
-      <rule>File paths starting with "bmad/" or "{project-root}/bmad/" refer to &lt;file id="..."&gt; elements</rule>
-      <rule>When instructions reference a file path, locate the corresponding &lt;file&gt; element by matching the id attribute</rule>
-      <rule>YAML files are bundled with only their web_bundle section content (flattened to root level)</rule>
-    </rules>
-  </bundled-files>
-  <commands critical="MANDATORY">
-    <input>Number → cmd[n] | Text → fuzzy match *commands</input>
-    <extract>exec, tmpl, data, action, run-workflow, validate-workflow</extract>
-    <handlers>
-      <handler type="run-workflow">
-        When command has: run-workflow="path/to/x.yaml" You MUST:
-        1. CRITICAL: Locate &lt;file id="bmad/core/tasks/workflow.xml"&gt; in this XML bundle
-        2. Extract and READ its CDATA content - this is the CORE OS for EXECUTING workflows
-        3. Locate &lt;file id="path/to/x.yaml"&gt; for the workflow config
-        4. Pass the yaml content as 'workflow-config' parameter to workflow.xml instructions
-        5. Follow workflow.xml instructions EXACTLY as written
-        6. When workflow references other files, locate them by id in &lt;file&gt; elements
-        7. Save outputs after EACH section (never batch)
-      </handler>
-      <handler type="action">
-        When command has: action="#id" → Find prompt with id="id" in current agent XML, execute its content
-        When command has: action="text" → Execute the text directly as a critical action prompt
-      </handler>
-      <handler type="data">
-        When command has: data="path/to/x.json|yaml|yml"
-        Locate &lt;file id="path/to/x.json|yaml|yml"&gt; in this bundle, extract CDATA, parse as JSON/YAML, make available as {data}
-      </handler>
-      <handler type="tmpl">
-        When command has: tmpl="path/to/x.md"
-        Locate &lt;file id="path/to/x.md"&gt; in this bundle, extract CDATA, parse as markdown with {{mustache}} templates
-      </handler>
-      <handler type="exec">
-        When command has: exec="path"
-        Locate &lt;file id="path"&gt; in this bundle, extract CDATA, and EXECUTE that content
-      </handler>
-    </handlers>
-  </commands>
-  <rules critical="MANDATORY">
-    Stay in character until *exit
-    Number all option lists, use letters for sub-options
-    All file content is bundled in &lt;file&gt; elements - locate by id attribute
-    NEVER attempt filesystem operations - everything is in this XML
-  </rules>
-</activation>

package/src/utility/models/agent-config-template.md

@@ -1,23 +0,0 @@
-```xml
-<agent-config name="" title="">
-
-    <llm critical="true">
-        <i>ALWAYS respond in {core:communication_language}.</i>
-    </llm>
-
-    <!-- Standard Agent Persona Configuration -->
-
-    <role></role>
-    <identity></identity>
-    <communication_style></communication_style>
-    <principles></principles>
-    <memories>
-        <memory>The users name is {core:user_name}</memory>
-    </memories>
-
-    <!-- User Added custom Agent Configuration Nodes -->
-
-    <!-- Agent-specific configuration nodes -->
-
-</agent-config>
-```

package/src/utility/models/agent-in-team-activation.xml

@@ -1,3 +0,0 @@
-<activation critical="MANDATORY">
-
-</activation>

package/src/utility/models/fragments/activation-rules.xml

@@ -1,8 +0,0 @@
-<rules>
-  - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
-  - Stay in character until exit selected
-  - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
-  - Number all lists, use letters for sub-options
-  - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
-  - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
-</rules>

package/src/utility/models/fragments/activation-steps.xml

@@ -1,15 +0,0 @@
-<step n="1">Load persona from this current agent file (already in context)</step>
-<step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
-    - Load and read {project-root}/bmad/{{module}}/config.yaml NOW
-    - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
-    - VERIFY: If config not loaded, STOP and report error to user
-    - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
-<step n="3">Remember: user's name is {user_name}</step>
-{AGENT_SPECIFIC_STEPS}
-<step n="{MENU_STEP}">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
-    ALL menu items from menu section</step>
-<step n="{HALT_STEP}">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text</step>
-<step n="{INPUT_STEP}">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
-    to clarify | No match → show "Not recognized"</step>
-<step n="{EXECUTE_STEP}">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
-    (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>

package/src/utility/models/fragments/handler-action.xml

@@ -1,4 +0,0 @@
-    <handler type="action">
-      When menu item has: action="#id" → Find prompt with id="id" in current agent XML, execute its content
-      When menu item has: action="text" → Execute the text directly as an inline instruction
-    </handler>

package/src/utility/models/fragments/handler-exec.xml

@@ -1,5 +0,0 @@
-    <handler type="exec">
-      When menu item has: exec="path/to/file.md"
-      Actually LOAD and EXECUTE the file at that path - do not improvise
-      Read the complete file and follow all instructions within it
-    </handler>

package/src/utility/models/fragments/handler-tmpl.xml

@@ -1,5 +0,0 @@
-    <handler type="tmpl">
-      When menu item has: tmpl="path/to/template.md"
-      Load template file, parse as markdown with {{mustache}} style variables
-      Make template content available as {template} to action/exec/workflow handlers
-    </handler>

package/src/utility/models/fragments/handler-validate-workflow.xml

@@ -1,7 +0,0 @@
-<handler type="validate-workflow">
-  When command has: validate-workflow="path/to/workflow.yaml"
-  1. You MUST LOAD the file at: {project-root}/bmad/core/tasks/validate-workflow.xml
-  2. READ its entire contents and EXECUTE all instructions in that file
-  3. Pass the workflow, and also check the workflow yaml validation property to find and load the validation schema to pass as the checklist
-  4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
-</handler>

package/src/utility/models/fragments/handler-workflow.xml

@@ -1,9 +0,0 @@
-<handler type="workflow">
-  When menu item has: workflow="path/to/workflow.yaml"
-  1. CRITICAL: Always LOAD {project-root}/bmad/core/tasks/workflow.xml
-  2. Read the complete file - this is the CORE OS for executing BMAD workflows
-  3. Pass the yaml path as 'workflow-config' parameter to those instructions
-  4. Execute workflow.xml instructions precisely following all steps
-  5. Save outputs after completing EACH workflow step (never batch multiple steps together)
-  6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
-</handler>

package/src/utility/models/fragments/menu-handlers.xml

@@ -1,6 +0,0 @@
-<menu-handlers>
-  <extract>{DYNAMIC_EXTRACT_LIST}</extract>
-  <handlers>
-{DYNAMIC_HANDLERS}
-  </handlers>
-</menu-handlers>

package/src/utility/models/fragments/web-bundle-activation-steps.xml

@@ -1,32 +0,0 @@
-<step n="1">Load persona from this current agent XML block containing this activation you are reading now</step>
-{AGENT_SPECIFIC_STEPS}
-<step n="{MENU_STEP}">Show greeting + numbered list of ALL commands IN ORDER from current agent's menu section</step>
-<step n="{HALT_STEP}">CRITICAL HALT. AWAIT user input. NEVER continue without it.</step>
-<step n="{INPUT_STEP}">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
-  to clarify | No match → show "Not recognized"</step>
-<step n="{EXECUTE_STEP}">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
-  (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
-
-<bundled-files critical="MANDATORY">
-  <access-method>
-    All dependencies are bundled within this XML file as &lt;file&gt; elements with CDATA content.
-    When you need to access a file path like "bmad/core/tasks/workflow.xml":
-    1. Find the &lt;file id="bmad/core/tasks/workflow.xml"&gt; element in this document
-    2. Extract the content from within the CDATA section
-    3. Use that content as if you read it from the filesystem
-  </access-method>
-  <rules>
-    <rule>NEVER attempt to read files from filesystem - all files are bundled in this XML</rule>
-    <rule>File paths starting with "bmad/" or "{project-root}/bmad/" refer to &lt;file id="..."&gt; elements</rule>
-    <rule>When instructions reference a file path, locate the corresponding &lt;file&gt; element by matching the id attribute</rule>
-    <rule>YAML files are bundled with only their web_bundle section content (flattened to root level)</rule>
-  </rules>
-</bundled-files>
-
-<rules>
-  Stay in character until *exit
-  Number all option lists, use letters for sub-options
-  All file content is bundled in &lt;file&gt; elements - locate by id attribute
-  NEVER attempt filesystem operations - everything is in this XML
-  Menu triggers use asterisk (*) - display exactly as shown
-</rules>

package/src/utility/templates/agent.customize.template.yaml

@@ -1,42 +0,0 @@
-# Agent Customization
-# Customize any section below - all are optional
-# After editing: npx bmad-method build <agent-name>
-
-# Override agent name
-agent:
-  metadata:
-    name: ""
-
-# Replace entire persona (not merged)
-persona:
-  role: ""
-  identity: ""
-  communication_style: ""
-  principles: []
-
-# Add custom critical actions (appended after standard config loading)
-critical_actions: []
-
-# Add persistent memories for the agent
-memories: []
-# Example:
-# memories:
-#   - "User prefers detailed technical explanations"
-#   - "Current project uses React and TypeScript"
-
-# Add custom menu items (appended to base menu)
-# Don't include * prefix or help/exit - auto-injected
-menu: []
-# Example:
-# menu:
-#   - trigger: my-workflow
-#     workflow: "{project-root}/custom/my.yaml"
-#     description: My custom workflow
-
-# Add custom prompts (for action="#id" handlers)
-prompts: []
-# Example:
-# prompts:
-# - id: my-prompt
-#   content: |
-#     Prompt instructions here

package/test/fixtures/agent-schema/invalid/persona/principles-as-string.agent.yaml

@@ -1,23 +0,0 @@
-# Test: principles as string instead of array
-# Expected: FAIL
-# Error code: invalid_type
-# Error path: agent.persona.principles
-# Error expected: array
-
-agent:
-  metadata:
-    id: principles-string
-    name: Principles String
-    title: Principles String
-    icon: ❌
-
-  persona:
-    role: Test agent
-    identity: Test identity
-    communication_style: Test style
-    principles: This should be an array, not a string
-
-  menu:
-    - trigger: help
-      description: Show help
-      action: display_help

package/tools/cli/bundlers/bundle-web.js

@@ -1,179 +0,0 @@
-const { WebBundler } = require('./web-bundler');
-const chalk = require('chalk');
-const { program } = require('commander');
-const path = require('node:path');
-const fs = require('fs-extra');
-
-program.name('bundle-web').description('Generate web bundles for BMAD agents and teams').version('1.0.0');
-
-program
-  .command('all')
-  .description('Bundle all modules')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (options) => {
-    try {
-      const bundler = new WebBundler(null, options.output);
-      await bundler.bundleAll();
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('rebundle')
-  .description('Clean and rebundle all modules')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (options) => {
-    try {
-      // Clean output directory first
-      const outputDir = path.isAbsolute(options.output) ? options.output : path.join(process.cwd(), options.output);
-
-      if (await fs.pathExists(outputDir)) {
-        console.log(chalk.cyan(`🧹 Cleaning ${options.output}...`));
-        await fs.emptyDir(outputDir);
-      }
-
-      // Bundle all
-      const bundler = new WebBundler(null, options.output);
-      await bundler.bundleAll();
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('module <name>')
-  .description('Bundle a specific module')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (moduleName, options) => {
-    try {
-      const bundler = new WebBundler(null, options.output);
-      const result = await bundler.bundleModule(moduleName);
-
-      if (result.agents.length === 0 && result.teams.length === 0) {
-        console.log(chalk.yellow(`No agents or teams found in module: ${moduleName}`));
-      } else {
-        console.log(chalk.green(`\n✨ Successfully bundled ${result.agents.length} agents and ${result.teams.length} teams`));
-      }
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('agent <module> <agent>')
-  .description('Bundle a specific agent')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (moduleName, agentFile, options) => {
-    try {
-      const bundler = new WebBundler(null, options.output);
-
-      // Ensure .md extension
-      if (!agentFile.endsWith('.md')) {
-        agentFile += '.md';
-      }
-
-      // Pre-discover module for complete manifests
-      await bundler.preDiscoverModule(moduleName);
-
-      await bundler.bundleAgent(moduleName, agentFile, false);
-      console.log(chalk.green(`\n✨ Successfully bundled agent: ${agentFile}`));
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('team <module> <team>')
-  .description('Bundle a specific team')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (moduleName, teamFile, options) => {
-    try {
-      const bundler = new WebBundler(null, options.output);
-
-      // Ensure .yaml or .yml extension
-      if (!teamFile.endsWith('.yaml') && !teamFile.endsWith('.yml')) {
-        teamFile += '.yaml';
-      }
-
-      // Pre-discover module for complete manifests
-      await bundler.preDiscoverModule(moduleName);
-
-      await bundler.bundleTeam(moduleName, teamFile);
-      console.log(chalk.green(`\n✨ Successfully bundled team: ${teamFile}`));
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('list')
-  .description('List available modules and agents')
-  .action(async () => {
-    try {
-      const bundler = new WebBundler();
-      const modules = await bundler.discoverModules();
-
-      console.log(chalk.cyan.bold('\n📦 Available Modules:\n'));
-
-      for (const module of modules) {
-        console.log(chalk.bold(`  ${module}/`));
-
-        const modulePath = path.join(bundler.modulesPath, module);
-        const agents = await bundler.discoverAgents(modulePath);
-        const teams = await bundler.discoverTeams(modulePath);
-
-        if (agents.length > 0) {
-          console.log(chalk.gray('    agents/'));
-          for (const agent of agents) {
-            console.log(chalk.gray(`      - ${agent}`));
-          }
-        }
-
-        if (teams.length > 0) {
-          console.log(chalk.gray('    teams/'));
-          for (const team of teams) {
-            console.log(chalk.gray(`      - ${team}`));
-          }
-        }
-      }
-
-      console.log('');
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('clean')
-  .description('Remove all web bundles')
-  .action(async () => {
-    try {
-      const fs = require('fs-extra');
-      const outputDir = path.join(process.cwd(), 'web-bundles');
-
-      if (await fs.pathExists(outputDir)) {
-        await fs.remove(outputDir);
-        console.log(chalk.green('✓ Web bundles directory cleaned'));
-      } else {
-        console.log(chalk.yellow('Web bundles directory does not exist'));
-      }
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Parse command line arguments
-program.parse(process.argv);
-
-// Show help if no command provided
-if (process.argv.slice(2).length === 0) {
-  program.outputHelp();
-}

package/tools/cli/bundlers/test-analyst.js

@@ -1,28 +0,0 @@
-const { WebBundler } = require('./web-bundler');
-const chalk = require('chalk');
-const path = require('node:path');
-
-async function testAnalystBundle() {
-  console.log(chalk.cyan.bold('\n🧪 Testing Analyst Agent Bundle\n'));
-
-  try {
-    const bundler = new WebBundler();
-
-    // Load web activation first
-    await bundler.loadWebActivation();
-
-    // Bundle just the analyst agent from bmm module
-    // Only bundle the analyst for testing
-    const agentPath = path.join(bundler.modulesPath, 'bmm', 'agents', 'analyst.md');
-    await bundler.bundleAgent('bmm', 'analyst.md');
-
-    console.log(chalk.green.bold('\n✅ Test completed successfully!\n'));
-  } catch (error) {
-    console.error(chalk.red('\n❌ Test failed:'), error.message);
-    console.error(error.stack);
-    process.exit(1);
-  }
-}
-
-// Run test
-testAnalystBundle();

package/tools/cli/bundlers/test-bundler.js

@@ -1,118 +0,0 @@
-const { WebBundler } = require('./web-bundler');
-const chalk = require('chalk');
-const fs = require('fs-extra');
-const path = require('node:path');
-
-async function testWebBundler() {
-  console.log(chalk.cyan.bold('\n🧪 Testing Web Bundler\n'));
-
-  const bundler = new WebBundler();
-  let passedTests = 0;
-  let failedTests = 0;
-
-  // Test 1: Load web activation
-  try {
-    await bundler.loadWebActivation();
-    console.log(chalk.green('✓ Web activation loaded successfully'));
-    passedTests++;
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to load web activation:'), error.message);
-    failedTests++;
-  }
-
-  // Test 2: Discover modules
-  try {
-    const modules = await bundler.discoverModules();
-    console.log(chalk.green(`✓ Discovered ${modules.length} modules:`, modules.join(', ')));
-    passedTests++;
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to discover modules:'), error.message);
-    failedTests++;
-  }
-
-  // Test 3: Bundle analyst agent
-  try {
-    const result = await bundler.bundleAgent('bmm', 'analyst.md');
-
-    // Check if bundle was created
-    const bundlePath = path.join(bundler.outputDir, 'bmm', 'agents', 'analyst.xml');
-    if (await fs.pathExists(bundlePath)) {
-      const content = await fs.readFile(bundlePath, 'utf8');
-
-      // Validate bundle structure
-      const hasAgent = content.includes('<agent');
-      const hasActivation = content.includes('<activation');
-      const hasPersona = content.includes('<persona>');
-      const activationBeforePersona = content.indexOf('<activation') < content.indexOf('<persona>');
-      const hasManifests =
-        content.includes('<agent-party id="bmad/_cfg/agent-manifest.csv">') && content.includes('<manifest id="bmad/web-manifest.xml">');
-      const hasDependencies = content.includes('<dependencies>');
-
-      console.log(chalk.green('✓ Analyst bundle created successfully'));
-      console.log(chalk.gray(`  - Has agent tag: ${hasAgent ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Has activation: ${hasActivation ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Has persona: ${hasPersona ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Activation before persona: ${activationBeforePersona ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Has manifests: ${hasManifests ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Has dependencies: ${hasDependencies ? '✓' : '✗'}`));
-
-      if (hasAgent && hasActivation && hasPersona && activationBeforePersona && hasManifests && hasDependencies) {
-        passedTests++;
-      } else {
-        console.error(chalk.red('✗ Bundle structure validation failed'));
-        failedTests++;
-      }
-    } else {
-      console.error(chalk.red('✗ Bundle file not created'));
-      failedTests++;
-    }
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to bundle analyst agent:'), error.message);
-    failedTests++;
-  }
-
-  // Test 4: Bundle a different agent (architect which exists)
-  try {
-    const result = await bundler.bundleAgent('bmm', 'architect.md');
-    const bundlePath = path.join(bundler.outputDir, 'bmm', 'agents', 'architect.xml');
-
-    if (await fs.pathExists(bundlePath)) {
-      console.log(chalk.green('✓ Architect bundle created successfully'));
-      passedTests++;
-    } else {
-      console.error(chalk.red('✗ Architect bundle file not created'));
-      failedTests++;
-    }
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to bundle architect agent:'), error.message);
-    failedTests++;
-  }
-
-  // Test 5: Bundle all agents in a module
-  try {
-    const results = await bundler.bundleModule('bmm');
-    console.log(chalk.green(`✓ Bundled ${results.agents.length} agents from bmm module`));
-    passedTests++;
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to bundle bmm module:'), error.message);
-    failedTests++;
-  }
-
-  // Summary
-  console.log(chalk.bold('\n📊 Test Results:'));
-  console.log(chalk.green(`  Passed: ${passedTests}`));
-  console.log(chalk.red(`  Failed: ${failedTests}`));
-
-  if (failedTests === 0) {
-    console.log(chalk.green.bold('\n✅ All tests passed!\n'));
-  } else {
-    console.log(chalk.red.bold(`\n❌ ${failedTests} test(s) failed\n`));
-    process.exit(1);
-  }
-}
-
-// Run tests
-testWebBundler().catch((error) => {
-  console.error(chalk.red('Fatal error:'), error);
-  process.exit(1);
-});