bmad-method 4.4.2 → 4.5.0

package/.prettierignore

@@ -0,0 +1,22 @@
+# Dependencies
+node_modules/
+package-lock.json
+
+# Build outputs
+dist/
+web-bundles/
+
+# 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

@@ -0,0 +1,23 @@
+{
+  "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/CHANGELOG.md

@@ -1,3 +1,21 @@
+# [4.5.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.4.2...v4.5.0) (2025-06-17)
+
+
+### Bug Fixes
+
+* installer relative path issue for npx resolved ([8b9bda5](https://github.com/bmadcode/BMAD-METHOD/commit/8b9bda5639ec882f1887f20b4610a6c2183042c6))
+* readme updated to indicate move of web-bundles ([7e9574f](https://github.com/bmadcode/BMAD-METHOD/commit/7e9574f571f41ae5003a1664d999c282dd7398be))
+* temp disable yml linting ([296c2fb](https://github.com/bmadcode/BMAD-METHOD/commit/296c2fbcbd9ac40b3c68633ba7454aacf1e31204))
+* update documentation and installer to reflect .roomodes file location in project root ([#236](https://github.com/bmadcode/BMAD-METHOD/issues/236)) ([bd7f030](https://github.com/bmadcode/BMAD-METHOD/commit/bd7f03016bfa13e39cb39aedb24db9fccbed18a7))
+
+
+### Features
+
+* bmad the creator expansion with some basic tools for modifying bmad method ([2d61df4](https://github.com/bmadcode/BMAD-METHOD/commit/2d61df419ac683f5691b6ee3fab81174f3d2cdde))
+* can now select different web bundles from what ide agents are installed ([0c41633](https://github.com/bmadcode/BMAD-METHOD/commit/0c41633b07d7dd4d7dda8d3a14d572eac0dcbb47))
+* installer offers option to install web bundles ([e934769](https://github.com/bmadcode/BMAD-METHOD/commit/e934769a5e35dba99f59b4e2e6bb49131c43a526))
+* robust installer ([1fbeed7](https://github.com/bmadcode/BMAD-METHOD/commit/1fbeed75ea446b0912277cfec376ee34f0b3d853))
+
 ## [4.4.2](https://github.com/bmadcode/BMAD-METHOD/compare/v4.4.1...v4.4.2) (2025-06-17)
 
 

package/README.md

@@ -2,7 +2,7 @@
 
 [![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Node.js Version](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/g6ypHytrCB)
 
 **AI-Powered Agile Development Framework** - Transform your software development with specialized AI agents that work as your complete Agile team.
@@ -15,10 +15,12 @@
 
 ### Fastest Start: Web UI (2 minutes) 🏃‍♂️
 
-1. Copy `bmad-core/web-bundles/teams/team-fullstack.txt`
-2. Create a new Gemini Gem or CustomGPT
-3. Upload the file and set instructions: "Your critical operating instructions are attached, do not break character as directed"
-4. Start chatting! Type `/help` to see available commands
+1. **Get the bundle**: Copy `dist/teams/team-fullstack.txt` (from this repository)
+2. **Create AI agent**: Create a new Gemini Gem or CustomGPT
+3. **Upload & configure**: Upload the file and set instructions: "Your critical operating instructions are attached, do not break character as directed"
+4. **Start Ideating and Planning**: Start chatting! Type `*help` to see available commands or pick an agent like `*analyst` to start right in on creating a brief.
+
+> 💡 **All pre-built bundles are in the `dist/` folder** - ready to copy and use immediately!
 
 ### IDE Quick Start (5 minutes) 💻
 
@@ -56,8 +58,8 @@ BMAD-METHOD (Breakthrough Method of Agile AI-Driven Development) revolutionizes
 For ChatGPT, Claude, or Gemini web interfaces:
 
 1. Choose a bundle:
-   - **Recommended**: `.bmad-core/web-bundles/teams/team-fullstack.txt` (complete development team)
-   - Or pick from individual agents in `.bmad-core/web-bundles/agents/`
+   - **Recommended**: `dist/teams/team-fullstack.txt` (complete development team)
+   - Or pick from individual agents in `dist/agents/`
 2. Upload to your AI platform (Gemini Gem, CustomGPT, or directly in chat)
 3. Set instructions: "Your critical operating instructions are attached, do not break character as directed"
 4. Type `/help` to see available commands
@@ -106,7 +108,7 @@ The BMad Method works with any IDE, but has built-in integration for:
 
 After installation with `--ide` flag:
 
-````bash
+```bash
 # In Cursor
 @pm Create a PRD for a task management app
 
@@ -115,7 +117,7 @@ After installation with `--ide` flag:
 
 # In Windsurf
 @dev Implement story 1.3
-```text
+```
 
 ### With Web UI (ChatGPT/Claude/Gemini)
 
@@ -132,16 +134,16 @@ npx bmad-method install
 
 # Check installation status
 npx bmad-method status
-````
+```
 
 ### Upgrading from V3 to V4
 
 If you have an existing BMAD-METHOD V3 project, simply run the installer in your project directory:
 
-````bash
+```bash
 npx bmad-method install
 # The installer will automatically detect your V3 installation and offer to upgrade
-```text
+```
 
 The upgrade process will:
 
@@ -189,7 +191,7 @@ Structured approaches for different scenarios:
 ├── tasks/           # Reusable task definitions
 ├── checklists/      # Quality checklists
 ├── data/            # Knowledge base
-└── web-bundles/     # Pre-built bundles
+└── web-bundles/     # Pre-built bundles (deprecated - use dist/ instead)
 
 tools/
 ├── cli.js           # Build tool
@@ -197,7 +199,32 @@ tools/
 └── lib/             # Build utilities
 
 expansion-packs/     # Optional add-ons (DevOps, Mobile, etc.)
-````
+
+dist/                # 📦 PRE-BUILT BUNDLES (Ready to use!)
+├── agents/          # Individual agent bundles (.txt files)
+├── teams/           # Team bundles (.txt files)
+└── expansion-packs/ # Expansion pack bundles
+```
+
+### 📦 Pre-Built Bundles (dist/ folder)
+
+**All ready-to-use bundles are in the `dist/` directory!**
+
+- **Teams**: `dist/teams/` - Complete team configurations
+
+  - `team-fullstack.txt` - Full-stack development team
+  - `team-ide-minimal.txt` - Minimal IDE workflow team
+  - `team-no-ui.txt` - Backend-only team
+  - `team-all.txt` - All agents included
+
+- **Individual Agents**: `dist/agents/` - Single agent files
+
+  - One `.txt` file per agent (analyst, architect, dev, etc.)
+
+- **Expansion Packs**: `dist/expansion-packs/` - Specialized domains
+  - Game development, DevOps, etc.
+
+**For Web UI usage**: Simply copy any `.txt` file from `dist/` and upload to your AI platform!`
 
 ## Advanced Features
 

package/bmad-core/agents/bmad-orchestrator.md

@@ -50,14 +50,14 @@ help-format:
   - DO NOT list individual tasks/checklists (these belong to specific agents)
   - Emphasize that users should switch to an agent to access its specific capabilities
   - Format examples:
-      - "*agent game-designer: Game Design Specialist"
-      - "  Specializes in: Game concepts, mechanics, level design"
-      - "  Can create: Game design documents, level designs, game briefs"
+    - "*agent game-designer: Game Design Specialist"
+    - "  Specializes in: Game concepts, mechanics, level design"
+    - "  Can create: Game design documents, level designs, game briefs"
 help-display-template: |
   🎭 BMad Orchestrator - Your Gateway to Specialized Agents
-
+  
   I coordinate specialized agents for different tasks. Tell me what you need, and I'll connect you with the right expert!
-
+  
   Orchestrator Commands:
   *help: Show this guide
   *chat-mode: Start conversational mode for detailed assistance
@@ -67,26 +67,26 @@ help-display-template: |
   *party-mode: Group chat with all agents
   *doc-out: Output full document
   *exit: Return to BMad or exit session
-
+  
   Agent Management:
   *agent {name}: Transform into a specialized agent
   *task {name}: Run a specific task (when in an agent)
   *checklist {name}: Execute a checklist (when in an agent)
-
+  
   Workflow Commands:
   *workflow {name}: Start a specific workflow directly
   *workflow-guidance: Get personalized help selecting the right workflow for your project
-
+  
   Available Specialist Agents:
   [For each agent in bundle, show:
   *agent {name}: {role/title}
     Specializes in: {key capabilities from agent's whenToUse}
     Can create: {list of documents/deliverables this agent produces}]
-
+  
   Available Workflows:
   [For each workflow in bundle, show:
   *workflow {name}: {workflow description}]
-
+  
   💡 Tip: Each agent has their own tasks, templates, and checklists. Switch to an agent to see what they can do!
 fuzzy-matching:
   - 85% confidence threshold
@@ -98,7 +98,7 @@ transformation:
 loading:
   - KB: Only for *kb-mode or BMAD questions
   - Agents: Only when transforming
-  - "Templates/Tasks: Only when executing"
+  - 'Templates/Tasks: Only when executing'
   - Always indicate loading
 workflow-guidance:
   - Discover available workflows in the bundle at runtime

package/bmad-core/agents/sm.md

@@ -32,7 +32,7 @@ startup:
   - CRITICAL: Do NOT create or modify any files during startup
   - Offer to help with story preparation but wait for explicit user confirmation
   - Only execute tasks when user explicitly requests them
-  - "CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Dev Agent"
+  - 'CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Dev Agent'
 commands:
   - '*help" - Show: numbered list of the following commands to allow selection'
   - '*chat-mode" - Conversational mode with advanced-elicitation for advice'

package/bmad-core/tasks/shard-doc.md

@@ -101,7 +101,7 @@ Create an `index.md` file in the sharded folder that:
 1. Contains the original level 1 heading and any content before the first level 2 section
 2. Lists all the sharded files with links:
 
-````markdown
+```markdown
 # Original Document Title
 
 [Original introduction content if any]
@@ -112,8 +112,7 @@ Create an `index.md` file in the sharded folder that:
 - [Section Name 2](./section-name-2.md)
 - [Section Name 3](./section-name-3.md)
   ...
-
-````text
+```text
 
 ### 5. Preserve Special Content
 
@@ -123,8 +122,7 @@ Create an `index.md` file in the sharded folder that:
 
    ```language
    content
-````
-````
+   ```
 
 2. **Mermaid diagrams**: Preserve complete syntax:
 

package/bmad-core/templates/architecture-tmpl.md

@@ -341,7 +341,7 @@ Use YAML format for better readability. If no REST API, skip this section.]]
 
 ^^CONDITION: has_rest_api^^
 
-````yaml
+```yaml
 openapi: 3.0.0
 info:
   title:
@@ -468,7 +468,7 @@ Get user input on deployment preferences and CI/CD tool choices.]]
 
 ```text
 {{promotion_flow_diagram}}
-````
+```
 
 ### Rollback Strategy
 

package/bmad-core/templates/brownfield-architecture-tmpl.md

@@ -222,7 +222,7 @@ Present component architecture and apply `tasks#advanced-elicitation` protocol]]
 
 [[LLM: Create Mermaid diagram showing how new components interact with existing ones]]
 
-````mermaid
+```mermaid
 {{component_interaction_diagram}}
 ```text
 
@@ -258,11 +258,11 @@ Present API design and apply `tasks#advanced-elicitation` protocol]]
 
 ```json
 {{request_schema}}
-````
+```
 
 **Response:**
 
-````json
+```json
 {{response_schema}}
 ```text
 
@@ -313,7 +313,7 @@ Present integration plan and apply `tasks#advanced-elicitation` protocol]]
 
 ```plaintext
 {{existing_structure_relevant_parts}}
-````
+```
 
 ### New File Organization
 

package/bmad-core/templates/front-end-spec-tmpl.md

@@ -74,7 +74,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 ### Site Map / Screen Inventory
 
-````mermaid
+```mermaid
 {{sitemap_diagram}}
 ```text
 
@@ -93,7 +93,7 @@ graph TD
     D --> D1[Profile]
     D --> D2[Settings]
     D --> D3[Billing]
-````
+```
 
 @{/example}
 
@@ -129,7 +129,7 @@ Create subsections for each major flow. After presenting all flows, apply `tasks
 
 #### Flow Diagram
 
-````mermaid
+```mermaid
 {{flow_diagram}}
 ```text
 
@@ -165,7 +165,7 @@ graph TD
     Validate -->|Yes| Verify[Email Verification]
     Verify --> Complete[Account Created]
     Complete --> Dashboard[Redirect to Dashboard]
-````
+```
 
 **Edge Cases & Error Handling:**
 

package/bmad-core/templates/fullstack-architecture-tmpl.md

@@ -506,7 +506,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 **Route Organization:**
 
-`````text
+```text
 {{route_structure}}
 ```text
 
@@ -532,7 +532,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
     api_client_setup;
   }
 }
-`````
+````
 
 **Service Example:**
 

package/bmad-core/utils/workflow-management.md

@@ -40,7 +40,7 @@ The actual list depends on which team bundle is loaded. When responding to this
 
 Example response format:
 
-````text
+```text
 Available workflows for [Team Name]:
 1. [workflow-id] - [Brief description based on workflow type]
 2. [workflow-id] - [Brief description based on workflow type]
@@ -135,7 +135,7 @@ workflow_state:
       status: in-progress
       created_by: pm
       started: 2024-01-15T11:00:00.000Z
-````
+```
 
 ### 4. Workflow Interruption Handling
 
@@ -149,7 +149,7 @@ When user returns after interruption:
 
 Example:
 
-````text
+```text
 User: I'm working on a new app. Here's my PRD and architecture doc.
 BMad: I see you have a PRD and architecture document. Based on these artifacts,
       it looks like you're following the greenfield-fullstack workflow and have completed
@@ -198,7 +198,7 @@ conditional_paths:
   - condition: project_type == 'web'
     next_stage: web-architecture
   - default: fullstack-architecture
-````
+```
 
 Handle these by asking clarifying questions when needed.
 

package/{bmad-core/web-bundles → dist}/agents/bmad-master.txt

@@ -2440,67 +2440,6 @@ Document sharded successfully:
 - Ensure the sharding is reversible (could reconstruct the original from shards)
 ==================== END: tasks#shard-doc ====================
 
-==================== START: templates#agent-tmpl ====================
-# [AGENT_ID]
-
-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
-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
-
-agent:
-  name: [AGENT_NAME]
-  id: [AGENT_ID]
-  title: [AGENT_TITLE]
-  customization: [OPTIONAL_CUSTOMIZATION]
-
-persona:
-  role: [AGENT_ROLE_DESCRIPTION]
-  style: [COMMUNICATION_STYLE]
-  identity: [AGENT_IDENTITY_DESCRIPTION]
-  focus: [PRIMARY_FOCUS_AREAS]
-
-  core_principles:
-    - [PRINCIPLE_1]
-    - [PRINCIPLE_2]
-    - [PRINCIPLE_3]
-    # Add more principles as needed
-
-startup:
-  - [STARTUP_INSTRUCTIONS]
-
-commands:
-  - "*help" - Show: numbered list of the following commands to allow selection
-  - "*chat-mode" - (Default) [DEFAULT_MODE_DESCRIPTION]
-  - "*create-doc {template}" - Create doc (no template = show available templates)
-  - [tasks] specific to the agent that are not covered by a template
-  - "*exit" - Say goodbye as the [AGENT_TITLE], and then abandon inhabiting this persona
-
-dependencies:
-  tasks:
-    - [TASK_1]
-    - [TASK_2]
-    # Add required tasks
-  templates:
-    - [TEMPLATE_1]
-    - [TEMPLATE_2]
-    # Add required templates
-  checklists:
-    - [CHECKLIST_1]
-    # Add required checklists
-  data:
-    - [DATA_1]
-    # Add required data files
-  utils:
-    - [UTIL_1]
-    # Add required utilities
-```
-==================== END: templates#agent-tmpl ====================
-
 ==================== START: templates#architecture-tmpl ====================
 # {{Project Name}} Architecture Document
 
@@ -8543,121 +8482,6 @@ With this work flow, there is only 1 story in progress at a time, worked sequent
 None Listed
 ==================== END: data#technical-preferences ====================
 
-==================== START: utils#agent-switcher.ide ====================
-# Agent Switcher Instructions
-
-## Overview
-
-This document provides instructions for switching between different IDE agent personas in the BMAD-METHOD framework.
-
-## Behavior
-
-### Listing Available Agents
-
-When no agent name is provided:
-
-1. Read the `bmad-core/ide-agents/` directory
-2. Look for files matching the pattern `*.ide.md`
-3. Extract agent names from filenames (the part before `.ide.md`)
-4. Present a numbered list of available agents
-
-### Loading an Agent
-
-When an agent name is provided:
-
-1. Attempt to load `bmad-core/ide-agents/{agent-name}.ide.md`
-2. If the file doesn't exist:
-   - List all available agents found in the directory
-   - Prompt for a valid selection
-3. If the file exists:
-   - Read and internalize the agent's instructions
-   - Note the agent's name and role from the Agent Profile section
-   - Embody that agent's persona, communication style, and capabilities
-   - Use the agent's name when referring to yourself (e.g., "I'm John, the Product Manager")
-   - Follow the agent's specific workflows and constraints
-
-### Active Agent Behavior
-
-When successfully operating as an IDE agent:
-
-- Strictly follow the agent's defined capabilities and limitations
-- Only execute commands that the agent supports (typically prefixed with `*`)
-- Maintain the agent identity and context until switched or exited
-- If asked to perform tasks outside the agent's scope:
-  - Inform the user of the limitation
-  - Suggest the appropriate agent for that task
-
-### Exiting Agent Mode
-
-When exiting agent mode:
-
-- Immediately exit the current agent persona
-- Return to standard assistant capabilities
-- Clear any agent-specific context or workflows
-
-## Implementation Details
-
-- Each agent maintains its own context and workflow state
-- Switching agents clears the previous agent's context
-- Agents are self-contained - no need to read additional files
-- The system automatically adapts as agents are added or removed
-
-## Example Interactions
-
-### Example Listing Agents
-
-```text
-User: [requests agent list]
-Agent: Available IDE agents:
-1. architect
-2. dev
-3. devops
-4. pm
-5. po
-6. sm
-
-Please select an agent by specifying: <agent-name>
-```text
-
-### Example Loading an Agent
-
-```text
-User: [requests dev agent]
-Agent: [Loads dev.ide.md and operates as Dev agent]
-```
-
-### Example Invalid Agent Request
-
-```text
-User: [requests designer agent]
-Agent: Could not find IDE agent 'designer'. Available agents:
-1. architect
-2. dev
-3. devops
-4. pm
-5. po
-6. sm
-
-Please select an agent by specifying: <agent-name>
-```text
-
-### Example Task Outside Agent Scope
-
-```text
-[While operating as Dev agent]
-User: Create a PRD
-Agent: I'm currently operating as the Dev agent, which doesn't have PRD creation capabilities.
-The PM agent can create PRDs. Would you like me to switch to the PM agent?
-```
-
-### Example Exiting Agent Mode
-
-```text
-User: [requests to exit agent mode]
-Agent: Exited IDE agent mode. Returned to standard assistant capabilities.
-```
-==================== END: utils#agent-switcher.ide ====================
-
 ==================== START: utils#template-format ====================
 # Template Format Conventions
 

package/{expansion-packs/bmad-2d-phaser-game-dev/web-bundles/teams/team-game-dev.txt → dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt}

@@ -38,11 +38,11 @@ These references map directly to bundle sections:
 
 ---
 
-==================== START: agent-teams#team-game-dev ====================
+==================== START: agent-teams#phaser-2d-nodejs-game-team ====================
 bundle:
-  name: Game Development Team
+  name: Phaser 2D NodeJS Game Team
   icon: 🎮
-  description: Comprehensive game development team specialized in 2D games using Phaser 3 and TypeScript. This team handles the complete game development lifecycle from initial concept brainstorming through detailed design documentation to technical implementation and quality assurance. Specializes in indie games, mobile games, web games, educational games, prototyping, and game feature development with focus on player experience and performance optimization.
+  description: Game Development team specialized in 2D games using Phaser 3 and TypeScript.
 agents:
   - bmad-orchestrator
   - game-designer
@@ -51,7 +51,7 @@ agents:
 workflows:
   - game-dev-greenfield
   - game-prototype
-==================== END: agent-teams#team-game-dev ====================
+==================== END: agent-teams#phaser-2d-nodejs-game-team ====================
 
 ==================== START: agents#bmad-orchestrator ====================
 # bmad