bmad-method 4.5.0 → 4.6.0

package/docs/claude-code-guide.md

@@ -6,9 +6,11 @@ This guide walks you through the complete BMAD workflow using Claude Code as you
 
 1. Navigate to your project directory
 2. Run the BMAD installer:
+
    ```bash
    npx bmad-method install
    ```
+
 3. When prompted:
    - **Installation Type**: Choose "Complete installation (recommended)"
    - **IDE**: Select "Claude Code"
@@ -17,11 +19,11 @@ This creates a `.bmad-core` folder with all agents and a `.claude/commands` fold
 
 ## Step 2: Set Up Team Fullstack in Gemini
 
-For ideation and planning, use Google's Gemini with the team-fullstack configuration:
+For ideation and planning, use Google's Gemini Custom Gem with the team-fullstack configuration:
 
-1. Open [Google AI Studio (Gemini)](https://aistudio.google.com/)
-2. Create a new chat
-3. Copy the contents of `/Users/brianmadison/dev/BMAD-METHOD/.bmad-core/web-bundles/teams/team-fullstack.txt`
+1. Open [Google gems](https://gemini.google.com/gems/view)
+2. Create a new Gem - give it a title and description
+3. Copy the contents of `.<install location>/web-bundles/teams/team-fullstack.txt`
 4. Paste this content into Gemini to set up the team
 
 ### Gemini Planning Phase

package/docs/cursor-guide.md

@@ -6,9 +6,11 @@ This guide walks you through the complete BMAD workflow using Cursor as your AI-
 
 1. Navigate to your project directory
 2. Run the BMAD installer:
+
    ```bash
    npx bmad-method install
    ```
+
 3. When prompted:
    - **Installation Type**: Choose "Complete installation (recommended)"
    - **IDE**: Select "Cursor"
@@ -17,11 +19,11 @@ This creates a `.bmad-core` folder with all agents and a `.cursor/rules` folder
 
 ## Step 2: Set Up Team Fullstack in Gemini
 
-For ideation and planning, use Google's Gemini with the team-fullstack configuration:
+For ideation and planning, use Google's Gemini Custom Gem with the team-fullstack configuration:
 
-1. Open [Google AI Studio (Gemini)](https://aistudio.google.com/)
-2. Create a new chat
-3. Copy the contents of `/Users/brianmadison/dev/BMAD-METHOD/.bmad-core/web-bundles/teams/team-fullstack.txt`
+1. Open [Google gems](https://gemini.google.com/gems/view)
+2. Create a new Gem - give it a title and description
+3. Copy the contents of `.<install location>/web-bundles/teams/team-fullstack.txt`
 4. Paste this content into Gemini to set up the team
 
 ### Gemini Planning Phase
@@ -101,6 +103,8 @@ All BMAD agents are available as Cursor rules (use `@` prefix):
 - `@po` - Product owner for prioritization
 - `@ux-expert` - UX specialist for design
 
+Alternatively, and more performance - you can copy the contents of an agent file into a custom mode - see the cursor docs on how to use custom agents.
+
 ## Cursor-Specific Features
 
 - **Agent rules are stored in**: `.cursor/rules/` as `.mdc` files

package/docs/roo-code-guide.md

@@ -6,9 +6,11 @@ This guide walks you through the complete BMAD workflow using Roo Code as your A
 
 1. Navigate to your project directory
 2. Run the BMAD installer:
+
    ```bash
    npx bmad-method install
    ```
+
 3. When prompted:
    - **Installation Type**: Choose "Complete installation (recommended)"
    - **IDE**: Select "Roo Code"
@@ -17,11 +19,11 @@ This creates a `.bmad-core` folder with all agents and a `.roomodes` file (in th
 
 ## Step 2: Set Up Team Fullstack in Gemini
 
-For ideation and planning, use Google's Gemini with the team-fullstack configuration:
+For ideation and planning, use Google's Gemini Custom Gem with the team-fullstack configuration:
 
-1. Open [Google AI Studio (Gemini)](https://aistudio.google.com/)
-2. Create a new chat
-3. Copy the contents of `/Users/brianmadison/dev/BMAD-METHOD/.bmad-core/web-bundles/teams/team-fullstack.txt`
+1. Open [Google gems](https://gemini.google.com/gems/view)
+2. Create a new Gem - give it a title and description
+3. Copy the contents of `.<install location>/web-bundles/teams/team-fullstack.txt`
 4. Paste this content into Gemini to set up the team
 
 ### Gemini Planning Phase

package/docs/versioning-and-releases.md

@@ -8,11 +8,11 @@ The easiest way to release new versions is through **automatic semantic releases
 
 Use these prefixes to control what type of release happens:
 
-````bash
+```bash
 fix: resolve CLI argument parsing bug      # → patch release (4.1.0 → 4.1.1)
 feat: add new agent orchestration mode     # → minor release (4.1.0 → 4.2.0)
 feat!: redesign CLI interface              # → major release (4.1.0 → 5.0.0)
-```text
+```
 
 ### What Happens Automatically
 
@@ -35,24 +35,24 @@ git push
 
 # That's it! Release happens automatically 🎉
 # Users can now run: npx bmad-method (and get the new version)
-````
+```
 
 ### Commits That DON'T Trigger Releases
 
 These commit types won't create releases (use them for maintenance):
 
-````bash
+```bash
 chore: update dependencies     # No release
 docs: fix typo in readme      # No release
 style: format code            # No release
 test: add unit tests          # No release
-```text
+```
 
 ### Test Your Setup
 
 ```bash
 npm run release:test    # Safe to run locally - tests the config
-````
+```
 
 ---
 

package/docs/windsurf-guide.md

@@ -6,9 +6,11 @@ This guide walks you through the complete BMAD workflow using Windsurf as your A
 
 1. Navigate to your project directory
 2. Run the BMAD installer:
+
    ```bash
    npx bmad-method install
    ```
+
 3. When prompted:
    - **Installation Type**: Choose "Complete installation (recommended)"
    - **IDE**: Select "Windsurf"
@@ -17,11 +19,11 @@ This creates a `.bmad-core` folder with all agents and a `.windsurf/rules` folde
 
 ## Step 2: Set Up Team Fullstack in Gemini
 
-For ideation and planning, use Google's Gemini with the team-fullstack configuration:
+For ideation and planning, use Google's Gemini Custom Gem with the team-fullstack configuration:
 
-1. Open [Google AI Studio (Gemini)](https://aistudio.google.com/)
-2. Create a new chat
-3. Copy the contents of `/Users/brianmadison/dev/BMAD-METHOD/.bmad-core/web-bundles/teams/team-fullstack.txt`
+1. Open [Google gems](https://gemini.google.com/gems/view)
+2. Create a new Gem - give it a title and description
+3. Copy the contents of `.<install location>/web-bundles/teams/team-fullstack.txt`
 4. Paste this content into Gemini to set up the team
 
 ### Gemini Planning Phase

package/expansion-packs/expansion-creator/tasks/generate-expansion-pack.md

@@ -70,7 +70,7 @@ IMPORTANT: STOP HERE AND CREATE PLAN FIRST
 
 Create `expansion-packs/{pack-name}/plan.md` with:
 
-````markdown
+```markdown
 # {Pack Name} Expansion Pack Plan
 
 ## Overview
@@ -149,8 +149,7 @@ Create `expansion-packs/{pack-name}/plan.md` with:
 ## Approval
 
 User approval received: [ ] Yes
-
-```text
+```
 
 Important: Wait for user approval before proceeding to Phase 2
 
@@ -281,8 +280,8 @@ For each checklist, implement comprehensive validation frameworks:
 IMPORTANT: Only proceed after plan.md is approved
 
 #### 3.1 Create Directory Structure
+
 ```
-````
 
 expansion-packs/
 └── {pack-name}/
@@ -312,7 +311,7 @@ expansion-packs/
 └── agent-teams/
 └── {domain}-team.yml (REQUIRED if multiple agents)
 
-````text
+```
 
 #### 3.2 Create Manifest
 
@@ -415,7 +414,7 @@ post_install_message: |
   - Domain best practices and terminology
   - Quality standards and validation criteria
   - Workflow orchestration with handoff protocols
-````
+```
 
 ### Phase 4: Content Creation
 
@@ -439,7 +438,7 @@ IMPORTANT: Work through plan.md checklist systematically!
 
 Before proceeding, copy these essential files from bmad-core:
 
-````bash
+```bash
 # Copy core task utilities
 cp bmad-core/tasks/create-doc.md expansion-packs/{pack-name}/tasks/
 cp bmad-core/tasks/execute-checklist.md expansion-packs/{pack-name}/tasks/
@@ -448,7 +447,7 @@ cp bmad-core/tasks/execute-checklist.md expansion-packs/{pack-name}/tasks/
 mkdir -p expansion-packs/{pack-name}/utils
 cp bmad-core/utils/template-format.md expansion-packs/{pack-name}/utils/
 cp bmad-core/utils/workflow-management.md expansion-packs/{pack-name}/utils/
-```text
+```
 
 **Step 3: Technical Implementation**
 
@@ -488,7 +487,7 @@ cp bmad-core/utils/workflow-management.md expansion-packs/{pack-name}/utils/
      tasks: {required task list}
      templates: {required template list}
      checklists: {quality checklist list}
-````
+   ```
 
 **Step 4: Workflow and Team Integration**
 
@@ -698,10 +697,10 @@ _{Professional background and expertise}_
    - `{file2}.{ext}` - {description}
 
 2. **Launch Orchestrator**:
+
    ```bash
    npm run agent {pack-name}-orchestrator
    ```
-````
 
 3. **Follow Numbered Options**: {Character Name} will present numbered choices for each decision
 
@@ -731,14 +730,12 @@ _{Professional background and expertise}_
 ### Knowledge Base
 
 [Embedded domain expertise]
-
 ````
 
 #### 6.3 Advanced Data File Documentation with Validation
 
 For each required data file, provide comprehensive guidance:
 
-```markdown
 ## Required User Data Files
 
 ### {filename}.{ext}
@@ -748,7 +745,6 @@ For each required data file, provide comprehensive guidance:
 - **Location**: Place in `bmad-core/data/`
 - **Validation**: {how agents will verify the file is correct}
 - **Example Structure**:
-````
 
 {sample content showing exact format}
 
@@ -1024,3 +1020,11 @@ Embedded knowledge (automatic):
 - [ ] Template conditional content tested with different scenarios
 - [ ] Workflow decision trees validated with sample use cases
 - [ ] Character interactions tested for consistency and professional authenticity
+
+```
+
+```
+
+```
+
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "main": "tools/cli.js",
   "bin": {

package/tools/installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "BMAD Method installer - AI-powered Agile development framework",
   "main": "lib/installer.js",
   "bin": {