bmad-method 4.4.1 → 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,9 +1,33 @@
-## [4.4.1](https://github.com/bmadcode/BMAD-METHOD/compare/v4.4.0...v4.4.1) (2025-06-17)
+# [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)
+
+
+### Bug Fixes
+
+* single agent install and team installation support ([18a382b](https://github.com/bmadcode/BMAD-METHOD/commit/18a382baa4e4a82db20affa3525eb951af1081e0))
+
+## [4.4.1](https://github.com/bmadcode/BMAD-METHOD/compare/v4.4.0...v4.4.1) (2025-06-17)
 
 ### Bug Fixes
 
-* installer no longer suggests the bmad-method directory as defauly ([e2e1658](https://github.com/bmadcode/BMAD-METHOD/commit/e2e1658c07f6957fea4e3aa9e7657a650205ee71))
+- installer no longer suggests the bmad-method directory as defauly ([e2e1658](https://github.com/bmadcode/BMAD-METHOD/commit/e2e1658c07f6957fea4e3aa9e7657a650205ee71))
 
 # [4.4.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.3.0...v4.4.0) (2025-06-16)
 

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,22 +15,18 @@
 
 ### 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) 💻
 
-**Prerequisites**: Install [Node.js](https://nodejs.org) (v14 or higher)
+**Prerequisites**: Install [Node.js](https://nodejs.org) (v20 or higher)
 
-````bash
-npx bmad-method install
-# The installer will automatically detect your project state and guide you through:
-# - Fresh installation or upgrade from v3
-# - Full installation or single agent
-# - Destination folder and IDE configuration
-```text
+Run `npx bmad-method install`
 
 This installs all agents and configures them for your IDE. If you have an existing v3 installation, it will offer to upgrade it automatically.
 
@@ -62,31 +58,17 @@ 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
 
 ### Method 2: CLI Installer (For IDEs) 🎯
 
-**Prerequisites**: Install [Node.js](https://nodejs.org) v14+ first
-
-Install directly into your project:
-
-```bash
-# Interactive installation (recommended)
-npx bmad-method install
-# The installer automatically detects your project state and guides you through:
-# - Fresh installation or upgrade from v3
-# - Installation type (full/single agent)
-# - Destination directory
-# - IDE configuration
+**Prerequisites**: Install [Node.js](https://nodejs.org) v20+ first
 
-# Or use command line options for fresh installations
-npx bmad-method install --full --directory ./my-project --ide cursor
-npx bmad-method install --agent pm --directory ./my-project --ide claude-code
-````
+Install directly into your project: `npx bmad-method install`
 
 **Supported IDEs:**
 
@@ -96,7 +78,7 @@ The BMad Method works with any IDE, but has built-in integration for:
 - `claude-code` - Claude Code with /agent commands
 - `windsurf` - Windsurf with @agent commands
 - `roo` - Roo Code with custom modes (see `.roomodes`)
-- More coming soon - BUT ITS easy to use with ANY IDE!
+- More coming soon - BUT ITS easy to use with ANY IDE - just copy the bmad-code folder to your project, and rename it .bmad-code.
 
 ## Available Agents
 
@@ -126,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
 
@@ -135,7 +117,7 @@ After installation with `--ide` flag:
 
 # In Windsurf
 @dev Implement story 1.3
-```text
+```
 
 ### With Web UI (ChatGPT/Claude/Gemini)
 
@@ -152,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:
 
@@ -209,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
@@ -217,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/agent-teams/team-all.yml

@@ -1,7 +1,7 @@
 bundle:
   name: Team All
   icon: 👥
-  description: This is a full organization of agents and includes every possible agent. This will produce the larges bundle but give the most options for discussion in a single session
+  description: Includes every core system agent.
 agents:
   - bmad-orchestrator
   - '*'

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

@@ -1,7 +1,7 @@
 bundle:
   name: Team Fullstack
   icon: 🚀
-  description: Comprehensive full-stack development team capable of handling both greenfield  application development and brownfield enhancement projects. This team combines  strategic planning, user experience design, and holistic system architecture  to deliver complete solutions from concept to deployment. Specializes in  full-stack applications, SaaS platforms, enterprise apps, feature additions,  refactoring, and system modernization.
+  description: Team capable of full stack, front end only, or service development.
 agents:
   - bmad-orchestrator
   - analyst

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

@@ -0,0 +1,10 @@
+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.yml

@@ -1,7 +1,7 @@
 bundle:
   name: Team No UI
   icon: 🔧
-  description: This is a team that is responsible for planning the project without any UI/UX design. This is for projects that do not require UI/UX design.
+  description: Team with no UX or UI Planning.
 agents:
   - bmad-orchestrator
   - analyst

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.