bmad-method 4.27.5 → 5.0.0

package/tools/installer/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "bmad-method",
-  "version": "4.3.0",
+  "version": "4.0.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "bmad-method",
-      "version": "4.3.0",
+      "version": "4.0.1",
       "license": "MIT",
       "dependencies": {
         "chalk": "^5.4.1",
@@ -21,7 +21,7 @@
         "bmad-method": "bin/bmad.js"
       },
       "engines": {
-        "node": ">=20.0.0"
+        "node": ">=14.0.0"
       }
     },
     "node_modules/@inquirer/checkbox": {

package/tools/installer/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bmad-method",
-  "version": "4.27.5",
-  "description": "BMad Method installer - AI-powered Agile development framework",
+  "version": "5.0.0",
+  "description": "BMAD Method installer - AI-powered Agile development framework",
   "main": "lib/installer.js",
   "bin": {
     "bmad": "./bin/bmad.js",
@@ -19,7 +19,7 @@
     "installer",
     "agents"
   ],
-  "author": "BMad Team",
+  "author": "BMAD Team",
   "license": "MIT",
   "dependencies": {
     "chalk": "^5.4.1",
@@ -30,7 +30,7 @@
     "ora": "^8.2.0"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=14.0.0"
   },
   "repository": {
     "type": "git",

package/tools/installer/templates/claude-commands.md

@@ -0,0 +1,7 @@
+# {{AGENT_NAME}} Agent
+
+{{AGENT_CONTENT}}
+
+---
+
+This is a BMAD Method agent. For more information, visit: https://github.com/your-org/bmad-method

package/tools/installer/templates/cursor-rules.md

@@ -0,0 +1,22 @@
+# BMAD Method Agents for Cursor
+
+This file contains all BMAD Method agent personas. To use an agent, type its name or alias in the Cursor chat.
+
+## Available Agents
+
+{{AGENT_LIST}}
+
+---
+
+{{AGENT_RULES}}
+
+---
+
+# Agent Switching
+
+To switch between agents during a conversation:
+
+1. Simply type the new agent name (e.g., "architect" or "dev")
+2. The AI will adopt that agent's persona
+
+For more information about BMAD Method, visit: https://github.com/your-org/bmad-method

package/tools/installer/templates/windsurf-rules.md

@@ -0,0 +1,22 @@
+# BMAD Method Agent Commands
+
+This file contains all BMAD Method agent commands for Windsurf. Use /agent-name to switch personas.
+
+## Available Commands
+
+{{COMMAND_LIST}}
+
+---
+
+{{AGENT_SECTIONS}}
+
+---
+
+# Usage Tips
+
+- Type `/dev` to switch to Developer persona
+- Type `/pm` to switch to Product Manager persona
+- Type `/architect` to switch to Architect persona
+- And so on for other agents...
+
+For more information about BMAD Method, visit: https://github.com/your-org/bmad-method

package/tools/lib/dependency-resolver.js

@@ -1,13 +1,11 @@
 const fs = require('fs').promises;
 const path = require('path');
 const yaml = require('js-yaml');
-const { extractYamlFromAgent } = require('./yaml-utils');
 
 class DependencyResolver {
   constructor(rootDir) {
     this.rootDir = rootDir;
-    this.bmadCore = path.join(rootDir, 'bmad-core');
-    this.common = path.join(rootDir, 'common');
+    this.bmadCore = path.join(rootDir, '.bmad-core');
     this.cache = new Map();
   }
 
@@ -15,18 +13,23 @@ class DependencyResolver {
     const agentPath = path.join(this.bmadCore, 'agents', `${agentId}.md`);
     const agentContent = await fs.readFile(agentPath, 'utf8');
     
-    // Extract YAML from markdown content with command cleaning
-    const yamlContent = extractYamlFromAgent(agentContent, true);
-    if (!yamlContent) {
+    // Extract YAML from markdown content
+    const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)\n```/);
+    if (!yamlMatch) {
       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 = {
       agent: {
         id: agentId,
-        path: agentPath,
+        path: `agents#${agentId}`,
         content: agentContent,
         config: agentConfig
       },
@@ -49,14 +52,14 @@ class DependencyResolver {
   }
 
   async resolveTeamDependencies(teamId) {
-    const teamPath = path.join(this.bmadCore, 'agent-teams', `${teamId}.yaml`);
+    const teamPath = path.join(this.bmadCore, 'agent-teams', `${teamId}.yml`);
     const teamContent = await fs.readFile(teamPath, 'utf8');
     const teamConfig = yaml.load(teamContent);
     
     const dependencies = {
       team: {
         id: teamId,
-        path: teamPath,
+        path: `agent-teams#${teamId}`,
         content: teamContent,
         config: teamConfig
       },
@@ -116,20 +119,17 @@ class DependencyResolver {
     }
 
     try {
+      const extensions = ['.md', '.yml', '.yaml'];
       let content = null;
       let filePath = null;
 
-      // First try bmad-core
-      try {
-        filePath = path.join(this.bmadCore, type, id);
-        content = await fs.readFile(filePath, 'utf8');
-      } catch (e) {
-        // If not found in bmad-core, try common folder
+      for (const ext of extensions) {
         try {
-          filePath = path.join(this.common, type, id);
+          filePath = path.join(this.bmadCore, type, `${id}${ext}`);
           content = await fs.readFile(filePath, 'utf8');
-        } catch (e2) {
-          // File not found in either location
+          break;
+        } catch (e) {
+          // Try next extension
         }
       }
 
@@ -141,7 +141,7 @@ class DependencyResolver {
       const resource = {
         type,
         id,
-        path: filePath,
+        path: `${type}#${id}`,
         content
       };
 
@@ -168,12 +168,12 @@ class DependencyResolver {
     try {
       const files = await fs.readdir(path.join(this.bmadCore, 'agent-teams'));
       return files
-        .filter(f => f.endsWith('.yaml'))
-        .map(f => f.replace('.yaml', ''));
+        .filter(f => f.endsWith('.yml'))
+        .map(f => f.replace('.yml', ''));
     } catch (error) {
       return [];
     }
   }
 }
 
-module.exports = DependencyResolver;
+module.exports = DependencyResolver;

package/tools/upgraders/v3-to-v4-upgrader.js

@@ -26,10 +26,10 @@ class V3ToV4Upgrader {
 
       // 1. Welcome message
       console.log(
-        chalk.bold("\nWelcome to BMad-Method V3 to V4 Upgrade Tool\n")
+        chalk.bold("\nWelcome to BMAD-METHOD V3 to V4 Upgrade Tool\n")
       );
       console.log(
-        "This tool will help you upgrade your BMad-Method V3 project to V4.\n"
+        "This tool will help you upgrade your BMAD-METHOD V3 project to V4.\n"
       );
       console.log(chalk.cyan("What this tool does:"));
       console.log("- Creates a backup of your V3 files (.bmad-v3-backup/)");
@@ -98,7 +98,7 @@ class V3ToV4Upgrader {
 
       // 8. Setup IDE
       if (!options.dryRun) {
-        await this.setupIDE(projectPath, options.ides);
+        await this.setupIDE(projectPath);
       }
 
       // 9. Show completion report
@@ -379,8 +379,8 @@ class V3ToV4Upgrader {
     const spinner = ora("Installing V4 structure...").start();
 
     try {
-      // Get the source bmad-core directory (without dot prefix)
-      const sourcePath = path.join(__dirname, "..", "..", "bmad-core");
+      // Get the source .bmad-core directory
+      const sourcePath = path.join(__dirname, "..", "..", ".bmad-core");
       const destPath = path.join(projectPath, ".bmad-core");
 
       // Copy .bmad-core
@@ -545,39 +545,47 @@ class V3ToV4Upgrader {
     }
   }
 
-  async setupIDE(projectPath, selectedIdes) {
-    // Use the IDE selections passed from the installer
-    if (!selectedIdes || selectedIdes.length === 0) {
-      console.log(chalk.dim("No IDE setup requested - skipping"));
-      return;
-    }
+  async setupIDE(projectPath) {
+    const { ide } = await inquirer.prompt([
+      {
+        type: "list",
+        name: "ide",
+        message: "Which IDE are you using?",
+        choices: [
+          { name: "Cursor", value: "cursor" },
+          { name: "Claude Code", value: "claude-code" },
+          { name: "Windsurf", value: "windsurf" },
+          { name: "Roo Code", value: "roo" },
+          { name: "VS Code", value: "skip" },
+          { name: "Other/Skip", value: "skip" },
+        ],
+      },
+    ]);
 
-    const ideSetup = require("../installer/lib/ide-setup");
-    const spinner = ora("Setting up IDE rules for all agents...").start();
+    const selectedIde = ide === "skip" ? null : ide;
 
-    try {
-      const ideMessages = {
-        cursor: "Rules created in .cursor/rules/",
-        "claude-code": "Commands created in .claude/commands/",
-        windsurf: "Rules created in .windsurf/rules/",
-        trae: "Rules created in.trae/rules/",
-        roo: "Custom modes created in .roomodes",
-        cline: "Rules created in .clinerules/",
-      };
-
-      // Setup each selected IDE
-      for (const ide of selectedIdes) {
-        spinner.text = `Setting up ${ide}...`;
-        await ideSetup.setup(ide, projectPath);
-        console.log(chalk.green(`\n✓ ${ideMessages[ide]}`));
-      }
+    if (selectedIde) {
+      const ideSetup = require("../installer/lib/ide-setup");
+      const spinner = ora("Setting up IDE rules for all agents...").start();
 
-      spinner.succeed(`IDE setup complete for ${selectedIdes.length} IDE(s)!`);
-    } catch (error) {
-      spinner.fail("IDE setup failed");
-      console.error(
-        chalk.yellow("IDE setup failed, but upgrade is complete.")
-      );
+      try {
+        await ideSetup.setup(selectedIde, projectPath);
+        spinner.succeed("IDE setup complete!");
+
+        const ideMessages = {
+          cursor: "Rules created in .cursor/rules/",
+          "claude-code": "Commands created in .claude/commands/",
+          windsurf: "Rules created in .windsurf/rules/",
+          roo: "Custom modes created in .roomodes",
+        };
+
+        console.log(chalk.green(`- ${ideMessages[selectedIde]}`));
+      } catch (error) {
+        spinner.fail("IDE setup failed");
+        console.error(
+          chalk.yellow("IDE setup failed, but upgrade is complete.")
+        );
+      }
     }
   }
 

package/tools/version-bump.js

@@ -15,7 +15,7 @@ async function initializeModules() {
 }
 
 /**
- * Simple version bumping script for BMad-Method
+ * Simple version bumping script for BMAD-METHOD
  * Usage: node tools/version-bump.js [patch|minor|major]
  */
 

package/tools/yaml-format.js

@@ -16,7 +16,7 @@ async function initializeModules() {
 }
 
 /**
- * YAML Formatter and Linter for BMad-Method
+ * YAML Formatter and Linter for BMAD-METHOD
  * Formats and validates YAML files and YAML embedded in Markdown
  */
 
@@ -197,7 +197,7 @@ async function main() {
       let changed = false;
       if (ext === '.md') {
         changed = await processMarkdownFile(filePath);
-      } else if (ext === '.yaml' || ext === '.yml' || basename.includes('roomodes') || basename.includes('.yaml') || basename.includes('.yml')) {
+      } else if (ext === '.yml' || ext === '.yaml' || basename.includes('roomodes') || basename.includes('.yml') || basename.includes('.yaml')) {
         // Handle YAML files and special cases like .roomodes
         changed = await processYamlFile(filePath);
         

package/.github/FUNDING.yaml

@@ -1,15 +0,0 @@
-# These are supported funding model platforms
-
-github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
-polar: # Replace with a single Polar username
-buy_me_a_coffee: bmad
-thanks_dev: # Replace with a single thanks.dev username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,32 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ""
-labels: ""
-assignees: ""
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**Steps to Reproduce**
-What lead to the bug and can it be reliable recreated - if so with what steps.
-
-**PR**
-If you have an idea to fix and would like to contribute, please indicate here you are working on a fix, or link to a proposed PR to fix the issue. Please review the contribution.md - contributions are always welcome!
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Please be Specific if relevant**
-Model(s) Used:
-Agentic IDE Used:
-WebSite Used:
-Project Language:
-BMad Method version:
-
-**Screenshots or Links**
-If applicable, add screenshots or links (if web sharable record) to help explain your problem.
-
-**Additional context**
-Add any other context about the problem here. The more information you can provide, the easier it will be to suggest a fix or resolve

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,22 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ""
-labels: ""
-assignees: ""
----
-
-**Did you discuss the idea first in Discord Server (#general-dev)**
-Yes/No - Link to thread. If no, please after posting request also share the link in the channel so it can be easily discussed.
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.

package/.prettierignore

@@ -1,21 +0,0 @@
-# Dependencies
-node_modules/
-package-lock.json
-
-# Build outputs
-dist/
-
-# Generated files
-*.log
-*.lock
-
-# BMad core files (have their own formatting)
-bmad-core/**/*.md
-
-# Specific files that need custom formatting
-.roomodes
-CHANGELOG.md
-
-# IDE files
-.vscode/
-.idea/

package/.prettierrc

@@ -1,23 +0,0 @@
-{
-  "printWidth": 100,
-  "tabWidth": 2,
-  "useTabs": false,
-  "semi": true,
-  "singleQuote": false,
-  "quoteProps": "as-needed",
-  "trailingComma": "es5",
-  "bracketSpacing": true,
-  "bracketSameLine": false,
-  "arrowParens": "always",
-  "proseWrap": "preserve",
-  "endOfLine": "lf",
-  "overrides": [
-    {
-      "files": "*.md",
-      "options": {
-        "proseWrap": "preserve",
-        "printWidth": 120
-      }
-    }
-  ]
-}

package/bmad-core/agent-teams/team-all.yaml

@@ -1,14 +0,0 @@
-bundle:
-  name: Team All
-  icon: 👥
-  description: Includes every core system agent.
-agents:
-  - bmad-orchestrator
-  - '*'
-workflows:
-  - brownfield-fullstack.yaml
-  - brownfield-service.yaml
-  - brownfield-ui.yaml
-  - greenfield-fullstack.yaml
-  - greenfield-service.yaml
-  - greenfield-ui.yaml

package/bmad-core/agent-teams/team-fullstack.yaml

@@ -1,18 +0,0 @@
-bundle:
-  name: Team Fullstack
-  icon: 🚀
-  description: Team capable of full stack, front end only, or service development.
-agents:
-  - bmad-orchestrator
-  - analyst
-  - pm
-  - ux-expert
-  - architect
-  - po
-workflows:
-  - brownfield-fullstack.yaml
-  - brownfield-service.yaml
-  - brownfield-ui.yaml
-  - greenfield-fullstack.yaml
-  - greenfield-service.yaml
-  - greenfield-ui.yaml

package/bmad-core/agent-teams/team-ide-minimal.yaml

@@ -1,10 +0,0 @@
-bundle:
-  name: Team IDE Minimal
-  icon: ⚡
-  description: Only the bare minimum for the IDE PO SM dev qa cycle.
-agents:
-  - po
-  - sm
-  - dev
-  - qa
-workflows: null

package/bmad-core/agent-teams/team-no-ui.yaml

@@ -1,13 +0,0 @@
-bundle:
-  name: Team No UI
-  icon: 🔧
-  description: Team with no UX or UI Planning.
-agents:
-  - bmad-orchestrator
-  - analyst
-  - pm
-  - architect
-  - po
-workflows:
-  - greenfield-service.yaml
-  - brownfield-service.yaml

package/bmad-core/agents/architect.md

@@ -1,63 +0,0 @@
-# architect
-
-CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
-
-```yaml
-root: .bmad-core
-IDE-FILE-RESOLUTION: Dependencies map to files as {root}/{type}/{name} where root=".bmad-core", type=folder (tasks/templates/checklists/utils), name=dependency name.
-REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.yaml), or ask for clarification if ambiguous.
-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
-  - The customization field ALWAYS takes precedence over any conflicting instructions
-  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
-  - Greet the user with your name and role, and inform of the *help command.
-  - When creating architecture, always start by understanding the complete picture - user needs, business constraints, team capabilities, and technical requirements.
-agent:
-  name: Winston
-  id: architect
-  title: Architect
-  icon: 🏗️
-  whenToUse: Use for system design, architecture documents, technology selection, API design, and infrastructure planning
-  customization: null
-persona:
-  role: Holistic System Architect & Full-Stack Technical Leader
-  style: Comprehensive, pragmatic, user-centric, technically deep yet accessible
-  identity: Master of holistic application design who bridges frontend, backend, infrastructure, and everything in between
-  focus: Complete systems architecture, cross-stack optimization, pragmatic technology selection
-  core_principles:
-    - Holistic System Thinking - View every component as part of a larger system
-    - User Experience Drives Architecture - Start with user journeys and work backward
-    - Pragmatic Technology Selection - Choose boring technology where possible, exciting where necessary
-    - Progressive Complexity - Design systems simple to start but can scale
-    - Cross-Stack Performance Focus - Optimize holistically across all layers
-    - Developer Experience as First-Class Concern - Enable developer productivity
-    - Security at Every Layer - Implement defense in depth
-    - Data-Centric Design - Let data requirements drive architecture
-    - Cost-Conscious Engineering - Balance technical ideals with financial reality
-    - Living Architecture - Design for change and adaptation
-# All commands require * prefix when used (e.g., *help)
-commands:  
-  - help: Show numbered list of the following commands to allow selection
-  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
-  - yolo: Toggle Yolo Mode
-  - doc-out: Output full document to current destination file
-  - execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
-  - research {topic}: execute task create-deep-research-prompt for architectural decisions
-  - exit: Say goodbye as the Architect, and then abandon inhabiting this persona
-dependencies:
-  tasks:
-    - create-doc.md
-    - create-deep-research-prompt.md
-    - document-project.md
-    - execute-checklist.md
-  templates:
-    - architecture-tmpl.yaml
-    - front-end-architecture-tmpl.yaml
-    - fullstack-architecture-tmpl.yaml
-    - brownfield-architecture-tmpl.yaml
-  checklists:
-    - architect-checklist.md
-  data:
-    - technical-preferences.md
-```