bmad-method 4.19.2 → 4.21.0

package/docs/cursor-guide.md

@@ -1,131 +0,0 @@
-# BMAD Method Guide for Cursor
-
-This guide walks you through the complete BMAD workflow using Cursor as your AI-powered IDE.
-
-## Step 1: Install BMAD in Your Project
-
-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"
-
-This creates a `.bmad-core` folder with all agents and a `.cursor/rules` folder with agent rules.
-
-## Step 2: Set Up Team Fullstack in Gemini
-
-For ideation and planning, use Google's Gemini Custom Gem with the team-fullstack configuration:
-
-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` (location can vary if you chose a non default installation location for the bundles) - or just use the bundle premade from the repo dist folder.
-4. Paste this content into Gemini to set up the team
-
-### Gemini Planning Phase
-
-In Gemini, ask the BMAD team to help you:
-
-- **Ideate** your project concept
-- **Brainstorm** features and requirements
-- **Create a PRD** (Product Requirements Document)
-- **Design the architecture**
-
-Ask questions like:
-
-- "Help me brainstorm a [type of application] that does [core functionality]"
-- "Create a comprehensive PRD for this concept"
-- "Design the technical architecture for this system"
-
-Copy the PRD and architecture documents that Gemini creates into your project's `docs/` folder:
-
-- `docs/prd.md`
-- `docs/architecture.md`
-
-## Step 3: Back to Cursor - Document Sharding
-
-Once you have your PRD and architecture documents in the `docs/` folder:
-
-1. **Start a new chat in Cursor**
-2. **Load the bmad-master agent**: Type `@bmad-master`
-3. **Shard the PRD**: Type `*shard-doc docs/prd.md prd`
-4. **Shard the architecture**: Type `*shard-doc docs/architecture.md architecture`
-
-This creates organized folders:
-
-- `docs/prd/` - Contains broken down PRD sections
-- `docs/architecture/` - Contains broken down architecture sections
-
-## Step 4: Story Development Cycle
-
-Now begin the iterative development cycle:
-
-### Create Stories (Scrum Master)
-
-1. **Start a new chat**
-2. **Load SM agent**: Type `@sm`
-3. **Create story**: Type `*create` (this runs the create-next-story task)
-4. **Review the generated story**
-5. **If approved**: Set story status to "Approved" in the story file
-
-### Implement Stories (Developer)
-
-1. **Start a new chat**
-2. **Load Dev agent**: Type `@dev`
-3. **The agent will ask which story to implement**
-4. **Follow the development tasks** the agent provides
-5. **When story is complete**: Mark status as "Done"
-
-### Repeat the Cycle
-
-1. **Start a new chat with SM agent** (`@sm`)
-2. **Create next story**: Type `*create`
-3. **Review and approve**
-4. **Start new chat with Dev agent** (`@dev`)
-5. **Implement the story**
-6. **Repeat until project complete**
-
-## Available Agent Rules in Cursor
-
-All BMAD agents are available as Cursor rules (use `@` prefix):
-
-- `@bmad-master` - Universal task executor
-- `@sm` - Scrum Master for story creation
-- `@dev` - Full-stack developer for implementation
-- `@architect` - Solution architect for design
-- `@pm` - Product manager for planning
-- `@analyst` - Business analyst for requirements
-- `@qa` - QA specialist for testing
-- `@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
-- **Auto-completion**: Cursor will suggest `@agent-name` as you type
-- **Rule activation**: Rules activate automatically when you mention `@agent-name`
-- **Context awareness**: Agents have access to your current file context
-
-## Key Workflow Principles
-
-1. **Always start new chats** when switching agents to avoid context confusion
-2. **Use Gemini for initial planning** and ideation with the team-fullstack bundle
-3. **Use bmad-master for document management** (sharding, templates, etc.)
-4. **Follow the SM → Dev cycle** for consistent story development
-5. **Review and approve stories** before implementation begins
-
-## Tips for Success
-
-- **Keep chats focused**: Each chat should have one agent and one primary task
-- **Use \*help command**: Every agent supports `*help` to see available commands
-- **Review generated content**: Always review and approve stories before marking them ready
-- **Maintain status updates**: Keep story statuses current (Draft → Approved → InProgress → Done)
-- **Leverage Cursor's context**: Agents can see your current file selection for better assistance
-
-This workflow ensures systematic, AI-assisted development following agile principles with clear handoffs between planning, story creation, and implementation phases.

package/docs/expansion-pack-ideas.md

@@ -1,121 +0,0 @@
-# Expansion Pack Ideas
-
-The BMAD Method's natural language framework can be applied to any domain. Here are ideas to inspire your own expansion packs:
-
-## Health & Wellness Pack
-
-### Agents
-
-- **Fitness Coach** - Creates personalized workout plans
-- **Nutrition Advisor** - Designs meal plans and tracks nutrition
-- **Meditation Guide** - Leads mindfulness sessions
-- **Sleep Optimizer** - Improves sleep habits
-
-### Tasks
-
-- `create-workout-plan` - Generates weekly exercise routines
-- `analyze-nutrition` - Reviews dietary habits
-- `design-meditation` - Creates guided meditation scripts
-
-### Templates
-
-- `workout-plan-tmpl` - Structured exercise program
-- `meal-plan-tmpl` - Weekly nutrition guide
-- `wellness-journal-tmpl` - Progress tracking
-
-## Creative Writing Pack
-
-### Agents
-
-- **Story Architect** - Plots narratives and story structures
-- **Character Developer** - Creates deep, complex characters
-- **World Builder** - Designs fictional universes
-- **Dialog Master** - Crafts authentic conversations
-
-### Tasks
-
-- `develop-plot` - Creates story outlines
-- `build-character` - Develops character profiles
-- `create-world` - Designs settings and cultures
-
-### Templates
-
-- `story-outline-tmpl` - Three-act structure
-- `character-sheet-tmpl` - Detailed character profile
-- `world-bible-tmpl` - Universe documentation
-
-## Business Strategy Pack
-
-### Agents
-
-- **Strategy Consultant** - Develops business strategies
-- **Market Analyst** - Researches market opportunities
-- **Financial Advisor** - Creates financial projections
-- **Operations Expert** - Optimizes business processes
-
-### Tasks
-
-- `swot-analysis` - Conducts SWOT analysis
-- `market-research` - Analyzes market conditions
-- `financial-forecast` - Projects revenue/costs
-
-### Templates
-
-- `business-plan-tmpl` - Complete business plan
-- `market-analysis-tmpl` - Market research report
-- `pitch-deck-tmpl` - Investor presentation
-
-## Education Pack
-
-### Agents
-
-- **Curriculum Designer** - Creates learning pathways
-- **Lesson Planner** - Develops engaging lessons
-- **Assessment Creator** - Designs fair evaluations
-- **Learning Coach** - Provides personalized guidance
-
-### Tasks
-
-- `design-curriculum` - Creates course structure
-- `plan-lesson` - Develops lesson content
-- `create-assessment` - Builds tests/quizzes
-
-### Templates
-
-- `course-outline-tmpl` - Semester plan
-- `lesson-plan-tmpl` - Daily lesson structure
-- `rubric-tmpl` - Assessment criteria
-
-## Personal Development Pack
-
-### Agents
-
-- **Life Coach** - Guides personal growth
-- **Goal Strategist** - Helps achieve objectives
-- **Habit Builder** - Creates lasting habits
-- **Mindset Mentor** - Develops positive thinking
-
-### Tasks
-
-- `goal-setting` - Defines SMART goals
-- `habit-tracking` - Monitors habit formation
-- `reflection-exercise` - Facilitates self-reflection
-
-### Templates
-
-- `goal-plan-tmpl` - Goal achievement roadmap
-- `habit-tracker-tmpl` - Daily habit log
-- `journal-prompts-tmpl` - Reflection questions
-
-## Creating Your Own
-
-To create an expansion pack:
-
-1. **Identify the domain** - What area of expertise?
-2. **Define agent roles** - Who are the experts?
-3. **Create tasks** - What procedures do they follow?
-4. **Design templates** - What outputs do they produce?
-5. **Test with users** - Does it provide value?
-6. **Share with community** - Help others benefit!
-
-Remember: The BMAD Method works anywhere natural language instructions can guide AI assistance!

package/docs/roo-code-guide.md

@@ -1,142 +0,0 @@
-# BMAD Method Guide for Roo Code
-
-This guide walks you through the complete BMAD workflow using Roo Code as your AI-powered IDE.
-
-## Step 1: Install BMAD in Your Project
-
-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"
-
-This creates a `.bmad-core` folder with all agents and a `.roomodes` file (in the project root) with custom modes.
-
-## Step 2: Set Up Team Fullstack in Gemini
-
-For ideation and planning, use Google's Gemini Custom Gem with the team-fullstack configuration:
-
-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` (location can vary if you chose a non default installation location for the bundles) - or just use the bundle premade from the repo dist folder.
-4. Paste this content into Gemini to set up the team
-
-### Gemini Planning Phase
-
-In Gemini, ask the BMAD team to help you:
-
-- **Ideate** your project concept
-- **Brainstorm** features and requirements
-- **Create a PRD** (Product Requirements Document)
-- **Design the architecture**
-
-Ask questions like:
-
-- "Help me brainstorm a [type of application] that does [core functionality]"
-- "Create a comprehensive PRD for this concept"
-- "Design the technical architecture for this system"
-
-Copy the PRD and architecture documents that Gemini creates into your project's `docs/` folder:
-
-- `docs/prd.md`
-- `docs/architecture.md`
-
-## Step 3: Back to Roo Code - Document Sharding
-
-Once you have your PRD and architecture documents in the `docs/` folder:
-
-1. **Open your project in Roo Code**
-2. **Select the bmad-master mode** from the mode selector (usually in status bar)
-3. **Shard the PRD**: Type `*shard-doc docs/prd.md prd`
-4. **Shard the architecture**: Type `*shard-doc docs/architecture.md architecture`
-
-This creates organized folders:
-
-- `docs/prd/` - Contains broken down PRD sections
-- `docs/architecture/` - Contains broken down architecture sections
-
-## Step 4: Story Development Cycle
-
-Now begin the iterative development cycle:
-
-### Create Stories (Scrum Master)
-
-1. **Start a new chat or conversation**
-2. **Switch to SM mode**: Select `bmad-sm` from the mode selector
-3. **Create story**: Type `*create` (this runs the create-next-story task)
-4. **Review the generated story**
-5. **If approved**: Set story status to "Approved" in the story file
-
-### Implement Stories (Developer)
-
-1. **Start a new conversation**
-2. **Switch to Dev mode**: Select `bmad-dev` from the mode selector
-3. **The agent will ask which story to implement**
-4. **Follow the development tasks** the agent provides
-5. **When story is complete**: Mark status as "Done"
-
-### Repeat the Cycle
-
-1. **Switch to SM mode** (`bmad-sm`)
-2. **Create next story**: Type `*create`
-3. **Review and approve**
-4. **Switch to Dev mode** (`bmad-dev`)
-5. **Implement the story**
-6. **Repeat until project complete**
-
-## Available Custom Modes in Roo Code
-
-All BMAD agents are available as custom modes:
-
-- `bmad-bmad-master` - 🧙 Universal task executor
-- `bmad-sm` - 🏃 Scrum Master for story creation
-- `bmad-dev` - 💻 Full-stack developer for implementation
-- `bmad-architect` - 🏗️ Solution architect for design
-- `bmad-pm` - 📋 Product manager for planning
-- `bmad-analyst` - 📊 Business analyst for requirements
-- `bmad-qa` - 🧪 QA specialist for testing
-- `bmad-po` - 🎯 Product owner for prioritization
-- `bmad-ux-expert` - 🎨 UX specialist for design
-
-## Roo Code-Specific Features
-
-- **Custom modes are stored in**: `.roomodes` file (in the project root)
-- **Mode switching**: Use the mode selector in Roo Code's interface
-- **File permissions**: Each agent has specific file access permissions
-  - **Documentation agents** (SM, PM, PO, Analyst): Limited to `.md` and `.txt` files
-  - **Technical agents** (Dev, Architect, Master): Full file access
-  - **QA agents**: Access to test files and documentation
-  - **UX agents**: Access to design-related files
-- **Context preservation**: Modes maintain context within conversations
-
-## Key Workflow Principles
-
-1. **Switch modes instead of starting new chats** - Roo Code handles context better with mode switching
-2. **Use Gemini for initial planning** and ideation with the team-fullstack bundle
-3. **Use bmad-master mode for document management** (sharding, templates, etc.)
-4. **Follow the SM → Dev mode cycle** for consistent story development
-5. **Review and approve stories** before implementation begins
-
-## Tips for Success
-
-- **Use mode selector effectively**: Switch modes as needed for different tasks
-- **Respect file permissions**: Agents can only edit files they have permission for
-- **Use \*help command**: Every mode supports `*help` to see available commands
-- **Review generated content**: Always review and approve stories before marking them ready
-- **Maintain status updates**: Keep story statuses current (Draft → Approved → InProgress → Done)
-- **Leverage Roo's context**: Modes can maintain context across the conversation
-
-## File Permission Summary
-
-- **bmad-analyst, bmad-pm, bmad-po, bmad-sm**: `.md`, `.txt` files only
-- **bmad-architect**: `.md`, `.txt`, `.yml`, `.yaml`, `.json` files
-- **bmad-qa**: Test files (`.test.js`, `.spec.ts`, etc.) and `.md` files
-- **bmad-ux-expert**: `.md`, `.css`, `.scss`, `.html`, `.jsx`, `.tsx` files
-- **bmad-dev, bmad-bmad-master, bmad-orchestrator**: Full file access
-
-This workflow ensures systematic, AI-assisted development following agile principles with clear handoffs between planning, story creation, and implementation phases.

package/docs/windsurf-guide.md

@@ -1,129 +0,0 @@
-# BMAD Method Guide for Windsurf
-
-This guide walks you through the complete BMAD workflow using Windsurf as your AI-powered IDE.
-
-## Step 1: Install BMAD in Your Project
-
-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"
-
-This creates a `.bmad-core` folder with all agents and a `.windsurf/rules` folder with agent rules.
-
-## Step 2: Set Up Team Fullstack in Gemini
-
-For ideation and planning, use Google's Gemini Custom Gem with the team-fullstack configuration:
-
-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` (location can vary if you chose a non default installation location for the bundles) - or just use the bundle premade from the repo dist folder.
-4. Paste this content into Gemini to set up the team
-
-### Gemini Planning Phase
-
-In Gemini, ask the BMAD team to help you:
-
-- **Ideate** your project concept
-- **Brainstorm** features and requirements
-- **Create a PRD** (Product Requirements Document)
-- **Design the architecture**
-
-Ask questions like:
-
-- "Help me brainstorm a [type of application] that does [core functionality]"
-- "Create a comprehensive PRD for this concept"
-- "Design the technical architecture for this system"
-
-Copy the PRD and architecture documents that Gemini creates into your project's `docs/` folder:
-
-- `docs/prd.md`
-- `docs/architecture.md`
-
-## Step 3: Back to Windsurf - Document Sharding
-
-Once you have your PRD and architecture documents in the `docs/` folder:
-
-1. **Start a new chat in Windsurf**
-2. **Load the bmad-master agent**: Type `@bmad-master`
-3. **Shard the PRD**: Type `*shard-doc docs/prd.md prd`
-4. **Shard the architecture**: Type `*shard-doc docs/architecture.md architecture`
-
-This creates organized folders:
-
-- `docs/prd/` - Contains broken down PRD sections
-- `docs/architecture/` - Contains broken down architecture sections
-
-## Step 4: Story Development Cycle
-
-Now begin the iterative development cycle:
-
-### Create Stories (Scrum Master)
-
-1. **Start a new chat**
-2. **Load SM agent**: Type `@sm`
-3. **Create story**: Type `*create` (this runs the create-next-story task)
-4. **Review the generated story**
-5. **If approved**: Set story status to "Approved" in the story file
-
-### Implement Stories (Developer)
-
-1. **Start a new chat**
-2. **Load Dev agent**: Type `@dev`
-3. **The agent will ask which story to implement**
-4. **Follow the development tasks** the agent provides
-5. **When story is complete**: Mark status as "Done"
-
-### Repeat the Cycle
-
-1. **Start a new chat with SM agent** (`@sm`)
-2. **Create next story**: Type `*create`
-3. **Review and approve**
-4. **Start new chat with Dev agent** (`@dev`)
-5. **Implement the story**
-6. **Repeat until project complete**
-
-## Available Agent Rules in Windsurf
-
-All BMAD agents are available as Windsurf rules (use `@` prefix):
-
-- `@bmad-master` - Universal task executor
-- `@sm` - Scrum Master for story creation
-- `@dev` - Full-stack developer for implementation
-- `@architect` - Solution architect for design
-- `@pm` - Product manager for planning
-- `@analyst` - Business analyst for requirements
-- `@qa` - QA specialist for testing
-- `@po` - Product owner for prioritization
-- `@ux-expert` - UX specialist for design
-
-## Windsurf-Specific Features
-
-- **Agent rules are stored in**: `.windsurf/rules/` as `.md` files
-- **Rule activation**: Rules activate when you mention `@agent-name` in chat
-- **Collaborative workflow**: Windsurf's collaborative features work well with BMAD's agent-switching pattern
-- **Context awareness**: Agents have access to your project context
-
-## Key Workflow Principles
-
-1. **Always start new chats** when switching agents to avoid context confusion
-2. **Use Gemini for initial planning** and ideation with the team-fullstack bundle
-3. **Use bmad-master for document management** (sharding, templates, etc.)
-4. **Follow the SM → Dev cycle** for consistent story development
-5. **Review and approve stories** before implementation begins
-
-## Tips for Success
-
-- **Keep chats focused**: Each chat should have one agent and one primary task
-- **Use \*help command**: Every agent supports `*help` to see available commands
-- **Review generated content**: Always review and approve stories before marking them ready
-- **Maintain status updates**: Keep story statuses current (Draft → Approved → InProgress → Done)
-- **Leverage Windsurf's collaboration**: Use the collaborative features for team reviews
-
-This workflow ensures systematic, AI-assisted development following agile principles with clear handoffs between planning, story creation, and implementation phases.

package/test-ide-paths.js

@@ -1,41 +0,0 @@
-// Test script to verify IDE setup paths for expansion pack agents
-const path = require('path');
-const fs = require('fs-extra');
-
-// Simulate the findAgentPath logic
-function simulateFindAgentPath(agentId, installDir) {
-  const possiblePaths = [
-    path.join(installDir, ".bmad-core", "agents", `${agentId}.md`),
-    path.join(installDir, "agents", `${agentId}.md`),
-    // Expansion pack paths
-    path.join(installDir, ".bmad-2d-phaser-game-dev", "agents", `${agentId}.md`),
-    path.join(installDir, ".bmad-infrastructure-devops", "agents", `${agentId}.md`),
-    path.join(installDir, ".bmad-creator-tools", "agents", `${agentId}.md`)
-  ];
-  
-  // Simulate finding the agent in an expansion pack
-  if (agentId === 'game-developer') {
-    return path.join(installDir, ".bmad-2d-phaser-game-dev", "agents", `${agentId}.md`);
-  }
-  
-  // Default to core
-  return path.join(installDir, ".bmad-core", "agents", `${agentId}.md`);
-}
-
-// Test different scenarios
-const testDir = '/project';
-const agents = ['dev', 'game-developer', 'infra-devops-platform'];
-
-console.log('Testing IDE path references:\n');
-
-agents.forEach(agentId => {
-  const agentPath = simulateFindAgentPath(agentId, testDir);
-  const relativePath = path.relative(testDir, agentPath).replace(/\\/g, '/');
-  
-  console.log(`Agent: ${agentId}`);
-  console.log(`  Full path: ${agentPath}`);
-  console.log(`  Relative path: ${relativePath}`);
-  console.log(`  Roo customInstructions: CRITICAL Read the full YML from ${relativePath} ...`);
-  console.log(`  Cursor MDC reference: [${relativePath}](mdc:${relativePath})`);
-  console.log('');
-});