bmad-method 4.27.5 → 5.0.0

package/tools/bump-all-versions.js

@@ -1,107 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-
-const args = process.argv.slice(2);
-const bumpType = args[0] || 'minor'; // default to minor
-
-if (!['major', 'minor', 'patch'].includes(bumpType)) {
-  console.log('Usage: node bump-all-versions.js [major|minor|patch]');
-  console.log('Default: minor');
-  process.exit(1);
-}
-
-function bumpVersion(currentVersion, type) {
-  const [major, minor, patch] = currentVersion.split('.').map(Number);
-  
-  switch (type) {
-    case 'major':
-      return `${major + 1}.0.0`;
-    case 'minor':
-      return `${major}.${minor + 1}.0`;
-    case 'patch':
-      return `${major}.${minor}.${patch + 1}`;
-    default:
-      return currentVersion;
-  }
-}
-
-async function bumpAllVersions() {
-  const updatedItems = [];
-  
-  // First, bump the core version
-  const coreConfigPath = path.join(__dirname, '..', 'bmad-core', 'core-config.yaml');
-  try {
-    const coreConfigContent = fs.readFileSync(coreConfigPath, 'utf8');
-    const coreConfig = yaml.load(coreConfigContent);
-    const oldCoreVersion = coreConfig.version || '1.0.0';
-    const newCoreVersion = bumpVersion(oldCoreVersion, bumpType);
-    
-    coreConfig.version = newCoreVersion;
-    
-    const updatedCoreYaml = yaml.dump(coreConfig, { indent: 2 });
-    fs.writeFileSync(coreConfigPath, updatedCoreYaml);
-    
-    updatedItems.push({ type: 'core', name: 'BMad Core', oldVersion: oldCoreVersion, newVersion: newCoreVersion });
-    console.log(`✓ BMad Core: ${oldCoreVersion} → ${newCoreVersion}`);
-  } catch (error) {
-    console.error(`✗ Failed to update BMad Core: ${error.message}`);
-  }
-  
-  // Then, bump all expansion packs
-  const expansionPacksDir = path.join(__dirname, '..', 'expansion-packs');
-  
-  try {
-    const entries = fs.readdirSync(expansionPacksDir, { withFileTypes: true });
-    
-    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.yaml');
-        
-        if (fs.existsSync(configPath)) {
-          try {
-            const configContent = fs.readFileSync(configPath, 'utf8');
-            const config = yaml.load(configContent);
-            const oldVersion = config.version || '1.0.0';
-            const newVersion = bumpVersion(oldVersion, bumpType);
-            
-            config.version = newVersion;
-            
-            const updatedYaml = yaml.dump(config, { indent: 2 });
-            fs.writeFileSync(configPath, updatedYaml);
-            
-            updatedItems.push({ type: 'expansion', name: packId, oldVersion, newVersion });
-            console.log(`✓ ${packId}: ${oldVersion} → ${newVersion}`);
-            
-          } catch (error) {
-            console.error(`✗ Failed to update ${packId}: ${error.message}`);
-          }
-        }
-      }
-    }
-    
-    if (updatedItems.length > 0) {
-      const coreCount = updatedItems.filter(i => i.type === 'core').length;
-      const expansionCount = updatedItems.filter(i => i.type === 'expansion').length;
-      
-      console.log(`\n✓ Successfully bumped ${updatedItems.length} item(s) with ${bumpType} version bump`);
-      if (coreCount > 0) console.log(`  - ${coreCount} core`);
-      if (expansionCount > 0) console.log(`  - ${expansionCount} expansion pack(s)`);
-      
-      console.log('\nNext steps:');
-      console.log('1. Test the changes');
-      console.log('2. Commit: git add -A && git commit -m "chore: bump all versions (' + bumpType + ')"');
-    } else {
-      console.log('No items found to update');
-    }
-    
-  } catch (error) {
-    console.error('Error reading expansion packs directory:', error.message);
-    process.exit(1);
-  }
-}
-
-bumpAllVersions();

package/tools/bump-core-version.js

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-
-const args = process.argv.slice(2);
-const bumpType = args[0] || 'minor'; // default to minor
-
-if (!['major', 'minor', 'patch'].includes(bumpType)) {
-  console.log('Usage: node bump-core-version.js [major|minor|patch]');
-  console.log('Default: minor');
-  process.exit(1);
-}
-
-function bumpVersion(currentVersion, type) {
-  const [major, minor, patch] = currentVersion.split('.').map(Number);
-  
-  switch (type) {
-    case 'major':
-      return `${major + 1}.0.0`;
-    case 'minor':
-      return `${major}.${minor + 1}.0`;
-    case 'patch':
-      return `${major}.${minor}.${patch + 1}`;
-    default:
-      return currentVersion;
-  }
-}
-
-async function bumpCoreVersion() {
-  try {
-    const coreConfigPath = path.join(__dirname, '..', 'bmad-core', 'core-config.yaml');
-    
-    const coreConfigContent = fs.readFileSync(coreConfigPath, 'utf8');
-    const coreConfig = yaml.load(coreConfigContent);
-    const oldVersion = coreConfig.version || '1.0.0';
-    const newVersion = bumpVersion(oldVersion, bumpType);
-    
-    coreConfig.version = newVersion;
-    
-    const updatedYaml = yaml.dump(coreConfig, { indent: 2 });
-    fs.writeFileSync(coreConfigPath, updatedYaml);
-    
-    console.log(`✓ BMad Core: ${oldVersion} → ${newVersion}`);
-    console.log(`\n✓ Successfully bumped BMad Core with ${bumpType} version bump`);
-    console.log('\nNext steps:');
-    console.log('1. Test the changes');
-    console.log('2. Commit: git add -A && git commit -m "chore: bump core version (' + bumpType + ')"');
-    
-  } catch (error) {
-    console.error('Error updating core version:', error.message);
-    process.exit(1);
-  }
-}
-
-bumpCoreVersion();

package/tools/bump-expansion-version.js

@@ -1,78 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-
-const args = process.argv.slice(2);
-
-if (args.length < 1 || args.length > 2) {
-  console.log('Usage: node bump-expansion-version.js <expansion-pack-id> [major|minor|patch]');
-  console.log('Default: minor');
-  console.log('Example: node bump-expansion-version.js bmad-creator-tools patch');
-  process.exit(1);
-}
-
-const packId = args[0];
-const bumpType = args[1] || 'minor'; // default to minor
-
-if (!['major', 'minor', 'patch'].includes(bumpType)) {
-  console.error('Error: Bump type must be major, minor, or patch');
-  process.exit(1);
-}
-
-function bumpVersion(currentVersion, type) {
-  const [major, minor, patch] = currentVersion.split('.').map(Number);
-  
-  switch (type) {
-    case 'major':
-      return `${major + 1}.0.0`;
-    case 'minor':
-      return `${major}.${minor + 1}.0`;
-    case 'patch':
-      return `${major}.${minor}.${patch + 1}`;
-    default:
-      return currentVersion;
-  }
-}
-
-async function updateVersion() {
-  try {
-    const configPath = path.join(__dirname, '..', 'expansion-packs', packId, 'config.yaml');
-    
-    if (!fs.existsSync(configPath)) {
-      console.error(`Error: Expansion pack '${packId}' not found`);
-      console.log('\nAvailable expansion packs:');
-      const expansionPacksDir = path.join(__dirname, '..', 'expansion-packs');
-      const entries = fs.readdirSync(expansionPacksDir, { withFileTypes: true });
-      entries.forEach(entry => {
-        if (entry.isDirectory() && !entry.name.startsWith('.')) {
-          console.log(`  - ${entry.name}`);
-        }
-      });
-      process.exit(1);
-    }
-    
-    const configContent = fs.readFileSync(configPath, 'utf8');
-    const config = yaml.load(configContent);
-    const oldVersion = config.version || '1.0.0';
-    const newVersion = bumpVersion(oldVersion, bumpType);
-    
-    config.version = newVersion;
-    
-    const updatedYaml = yaml.dump(config, { indent: 2 });
-    fs.writeFileSync(configPath, updatedYaml);
-    
-    console.log(`✓ ${packId}: ${oldVersion} → ${newVersion}`);
-    console.log(`\n✓ Successfully bumped ${packId} with ${bumpType} version bump`);
-    console.log('\nNext steps:');
-    console.log('1. Test the changes');
-    console.log('2. Commit: git add -A && git commit -m "chore: bump ' + packId + ' version (' + bumpType + ')"');
-    
-  } catch (error) {
-    console.error('Error updating version:', error.message);
-    process.exit(1);
-  }
-}
-
-updateVersion();

package/tools/installer/config/ide-agent-config.yaml

@@ -1,58 +0,0 @@
-# IDE-specific agent configurations
-# This file defines agent-specific settings for different IDEs
-
-# Roo Code file permissions
-# Each agent can have restricted file access based on regex patterns
-# If an agent is not listed here, it gets full edit access
-roo-permissions:
-  # Core agents
-  analyst:
-    fileRegex: "\\.(md|txt)$"
-    description: "Documentation and text files"
-  pm:
-    fileRegex: "\\.(md|txt)$"
-    description: "Product documentation"
-  architect:
-    fileRegex: "\\.(md|txt|yml|yaml|json)$"
-    description: "Architecture docs and configs"
-  qa:
-    fileRegex: "\\.(test|spec)\\.(js|ts|jsx|tsx)$|\\.md$"
-    description: "Test files and documentation"
-  ux-expert:
-    fileRegex: "\\.(md|css|scss|html|jsx|tsx)$"
-    description: "Design-related files"
-  po:
-    fileRegex: "\\.(md|txt)$"
-    description: "Story and requirement docs"
-  sm:
-    fileRegex: "\\.(md|txt)$"
-    description: "Process and planning docs"
-  # Expansion pack agents
-  game-designer:
-    fileRegex: "\\.(md|txt|json|yaml|yml)$"
-    description: "Game design documents and configs"
-  game-sm:
-    fileRegex: "\\.(md|txt)$"
-    description: "Game project management docs"
-
-# Cline agent ordering
-# Lower numbers appear first in the list
-# Agents not listed get order 99
-cline-order:
-  # Core agents
-  bmad-master: 1
-  bmad-orchestrator: 2
-  pm: 3
-  analyst: 4
-  architect: 5
-  po: 6
-  sm: 7
-  dev: 8
-  qa: 9
-  ux-expert: 10
-  # Expansion pack agents
-  bmad-the-creator: 11
-  game-designer: 12
-  game-developer: 13
-  game-sm: 14
-  infra-devops-platform: 15

package/tools/installer/config/install.config.yaml

@@ -1,91 +0,0 @@
-installation-options:
-  full:
-    name: Complete BMad Core
-    description: Copy the entire .bmad-core folder with all agents, templates, and tools
-    action: copy-folder
-    source: bmad-core
-  single-agent:
-    name: Single Agent
-    description: Select and install a single agent with its dependencies
-    action: copy-agent
-ide-configurations:
-  cursor:
-    name: Cursor
-    rule-dir: .cursor/rules/
-    format: multi-file
-    command-suffix: .mdc
-    instructions: |
-      # To use BMad agents in Cursor:
-      # 1. Press Ctrl+L (Cmd+L on Mac) to open the chat
-      # 2. Type @agent-name (e.g., "@dev", "@pm", "@architect")
-      # 3. The agent will adopt that persona for the conversation
-  claude-code:
-    name: Claude Code
-    rule-dir: .claude/commands/
-    format: multi-file
-    command-suffix: .md
-    instructions: |
-      # To use BMad agents in Claude Code:
-      # 1. Type /agent-name (e.g., "/dev", "/pm", "/architect")
-      # 2. Claude will switch to that agent's persona
-  windsurf:
-    name: Windsurf
-    rule-dir: .windsurf/rules/
-    format: multi-file
-    command-suffix: .md
-    instructions: |
-      # To use BMad agents in Windsurf:
-      # 1. Type @agent-name (e.g., "@dev", "@pm")
-      # 2. Windsurf will adopt that agent's persona
-  trae:
-    name: Trae
-    rule-dir: .trae/rules/
-    format: multi-file
-    command-suffix: .md
-    instructions: |
-      # To use BMad agents in Trae:
-      # 1. Type @agent-name (e.g., "@dev", "@pm", "@architect")
-      # 2. Trae will adopt that agent's persona
-  roo:
-    name: Roo Code
-    format: custom-modes
-    file: .roomodes
-    instructions: |
-      # To use BMad agents in Roo Code:
-      # 1. Open the mode selector (usually in the status bar)
-      # 2. Select any bmad-{agent} mode (e.g., "bmad-dev", "bmad-pm")
-      # 3. The AI will adopt that agent's full personality and capabilities
-  cline:
-    name: Cline
-    rule-dir: .clinerules/
-    format: multi-file
-    command-suffix: .md
-    instructions: |
-      # To use BMad agents in Cline:
-      # 1. Open the Cline chat panel in VS Code
-      # 2. Type @agent-name (e.g., "@dev", "@pm", "@architect")
-      # 3. The agent will adopt that persona for the conversation
-      # 4. Rules are stored in .clinerules/ directory in your project
-  gemini:
-    name: Gemini CLI
-    rule-dir: .gemini/agents/
-    format: context-files
-    instructions: |
-      # To use BMad agents with the Gemini CLI:
-      # 1. The installer creates a .gemini/ directory in your project.
-      # 2. It also configures .gemini/settings.json to load all agent files.
-      # 3. Simply mention the agent in your prompt (e.g., "As @dev, ...").
-      # 4. The Gemini CLI will automatically have the context for that agent.
-  github-copilot:
-    name: Github Copilot
-    rule-dir: .github/chatmodes/
-    format: multi-file
-    command-suffix: .md
-    instructions: |
-      # To use BMad agents with Github Copilot:
-      # 1. The installer creates a .github/chatmodes/ directory in your project
-      # 2. Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
-      # 3. The agent will adopt that persona for the conversation
-      # 4. Requires VS Code 1.101+ with `chat.agent.enabled: true` in settings
-      # 5. Agent files are stored in .github/chatmodes/
-      # 6. Use `*help` to see available commands and agents

package/tools/lib/yaml-utils.js

@@ -1,29 +0,0 @@
-/**
- * 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/md-assets/web-agent-startup-instructions.md

@@ -1,39 +0,0 @@
-# Web Agent Bundle Instructions
-
-You are now operating as a specialized AI agent from the BMad-Method framework. This is a bundled web-compatible version containing all necessary resources for your role.
-
-## Important Instructions
-
-### **Follow all startup commands**: Your agent configuration includes startup instructions that define your behavior, personality, and approach. These MUST be followed exactly.
-
-### **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
-
-- `==================== START: .bmad-core/folder/filename.md ====================`
-- `==================== END: .bmad-core/folder/filename.md ====================`
-
-When you need to reference a resource mentioned in your instructions:
-
-- Look for the corresponding START/END tags
-- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
-- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
-
-**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
-
-```yaml
-dependencies:
-  utils:
-    - template-format
-  tasks:
-    - create-story
-```
-
-These references map directly to bundle sections:
-
-- `dependencies.utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
-- `dependencies.utils: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
-
-### **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance. You have no file system to write to, so you will maintain document history being drafted in your memory unless a canvas feature is available and the user confirms its usage.
-
-## **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role explicitly as defined.
-
----

package/tools/update-expansion-version.js

@@ -1,54 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-
-const args = process.argv.slice(2);
-
-if (args.length < 2) {
-  console.log('Usage: node update-expansion-version.js <expansion-pack-id> <new-version>');
-  console.log('Example: node update-expansion-version.js bmad-creator-tools 1.1.0');
-  process.exit(1);
-}
-
-const [packId, newVersion] = args;
-
-// Validate version format
-if (!/^\d+\.\d+\.\d+$/.test(newVersion)) {
-  console.error('Error: Version must be in format X.Y.Z (e.g., 1.2.3)');
-  process.exit(1);
-}
-
-async function updateVersion() {
-  try {
-    // 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`);
-      process.exit(1);
-    }
-    
-    const configContent = fs.readFileSync(configPath, 'utf8');
-    const config = yaml.load(configContent);
-    const oldVersion = config.version || 'unknown';
-    
-    config.version = newVersion;
-    
-    const updatedYaml = yaml.dump(config, { indent: 2 });
-    fs.writeFileSync(configPath, updatedYaml);
-    
-    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');
-    console.log('2. Commit: git add -A && git commit -m "chore: bump ' + packId + ' to v' + newVersion + '"');
-    
-  } catch (error) {
-    console.error('Error updating version:', error.message);
-    process.exit(1);
-  }
-}
-
-updateVersion();