bmad-method 4.6.3 → 4.8.0

package/docs/bmad-workflow-guide.md

@@ -33,11 +33,13 @@ The BMAD Method follows a structured approach to AI-assisted software developmen
 
 Use Google's Gemini for collaborative planning with the full team:
 
-1. **Open [Google AI Studio](https://aistudio.google.com/)**
-2. **Load team-fullstack**:
-   - Copy contents of: `/Users/brianmadison/dev/BMAD-METHOD/.bmad-core/web-bundles/teams/team-fullstack.txt`
-   - Paste into new Gemini chat
-3. **Collaborate with the team**:
+1. **Open [Google Gems](https://gemini.google.com/gems/view)**
+2. **Create a new Gem**:
+   - Give it a title and description (e.g., "BMAD Team Fullstack")
+3. **Load team-fullstack**:
+   - Copy contents of: `dist/teams/team-fullstack.txt` from your project
+   - Paste this content into the Gem setup to configure the team
+4. **Collaborate with the team**:
    - Business Analyst: Requirements gathering
    - Product Manager: Feature prioritization
    - Solution Architect: Technical design
@@ -53,9 +55,9 @@ Help me brainstorm features and create a comprehensive PRD."
 that can handle [specific requirements]."
 ```
 
-4. **Export planning documents**:
-   - Save PRD as `docs/prd.md`
-   - Save architecture as `docs/architecture.md`
+5. **Export planning documents**:
+   - Copy the PRD output and save as `docs/prd.md` in your project
+   - Copy the architecture output and save as `docs/architecture.md` in your project
 
 ### Phase 3: Document Organization (IDE)
 

package/docs/claude-code-guide.md

@@ -23,7 +23,7 @@ For ideation and planning, use Google's Gemini Custom Gem with the team-fullstac
 
 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`
+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

package/docs/core-architecture.md

@@ -35,7 +35,7 @@ graph TD
         end
 
         subgraph Outputs
-            J[".bmad-core/web-bundles"]
+            J["dist"]
         end
 
         B -- defines dependencies for --> E
@@ -133,17 +133,17 @@ The framework is designed for two primary environments: local IDEs and web-based
 
 ### 4.1. Web Builder (`tools/builders/web-builder.js`)
 
-- **Purpose**: This Node.js script is responsible for creating the `.txt` bundles found in `.bmad-core/web-bundles/`.
+- **Purpose**: This Node.js script is responsible for creating the `.txt` bundles found in `dist`.
 - **Process**:
   1. **Resolves Dependencies**: For a given agent or team, the script reads its definition file.
   2. It recursively finds all dependent resources (tasks, templates, etc.) that the agent/team needs.
   3. **Bundles Content**: It reads the content of all these files and concatenates them into a single, large text file, with clear separators indicating the original file path of each section.
-  4. **Outputs Bundle**: The final `.txt` file is saved in the `web-bundles` directory, ready to be uploaded to a web UI.
+  4. **Outputs Bundle**: The final `.txt` file is saved in the `dist` directory, ready to be uploaded to a web UI.
 
 ### 4.2. Environment-Specific Usage
 
 - **For IDEs**: Users interact with the agents directly via their markdown files in `.bmad-core/agents/`. The IDE integration (for Cursor, Claude Code, etc.) knows how to call these agents.
-- **For Web UIs**: Users upload a pre-built bundle from `.bmad-core/web-bundles/`. This single file provides the AI with the context of the entire team and all their required tools and knowledge.
+- **For Web UIs**: Users upload a pre-built bundle from `dist`. This single file provides the AI with the context of the entire team and all their required tools and knowledge.
 
 ## 5. BMAD Workflows
 

package/docs/cursor-guide.md

@@ -23,7 +23,7 @@ For ideation and planning, use Google's Gemini Custom Gem with the team-fullstac
 
 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`
+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

package/docs/roo-code-guide.md

@@ -23,7 +23,7 @@ For ideation and planning, use Google's Gemini Custom Gem with the team-fullstac
 
 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`
+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

package/docs/user-guide.md

@@ -46,7 +46,7 @@ BMAD-METHOD (Breakthrough Method of Agile AI-Driven Development) is an AI agent
 
 Best for: ChatGPT, Claude, Gemini users
 
-1. Navigate to `.bmad-core/web-bundles/teams/`
+1. Navigate to `dist/teams/`
 2. Copy `team-fullstack.txt` content
 3. Create new Gemini Gem or CustomGPT
 4. Upload file with instructions: "Your critical operating instructions are attached, do not break character as directed"
@@ -59,9 +59,6 @@ Best for: Cursor, Claude Code, Windsurf, VS Code users
 ````bash
 # Interactive installation (recommended)
 npx bmad-method install
-
-# Command line installation
-npx bmad-method install --full --directory ./my-project --ide cursor
 ```text
 
 ### First Steps
@@ -227,7 +224,7 @@ When working directly in IDEs:
 
 Templates can include `advanced-elicitation.md` for enhanced interaction:
 
-````markdown
+`````markdown
 [[LLM: Use advanced-elicitation actions 0-3 to refine requirements]]
 
 ````text
@@ -272,7 +269,9 @@ graph TD
     style L fill:#1a73e8,color:#fff
     style N fill:#34a853,color:#fff
 ````
-````
+`````
+
+`````
 
 #### Web UI to IDE Transition
 
@@ -392,7 +391,7 @@ agents:
   - qa
 workflows:
   - greenfield-fullstack
-````
+`````
 
 ## IDE Integration
 
@@ -544,7 +543,7 @@ BMAD's dependency system ensures agents only load necessary resources:
 
 Create custom templates following `template-format.md`:
 
-````markdown
+`````markdown
 ---
 title: Custom Template
 description: Your custom document type
@@ -596,7 +595,9 @@ phases:
       - implementation
       - tests
 ````
-````
+`````
+
+`````
 
 ### Creating Custom Templates
 
@@ -647,8 +648,9 @@ Templates are self-contained documents that embed both output structure and proc
 ## User Interface Section
 [[LLM: Only include for UI projects]]
 ^^/CONDITION^^
-````
-````
+`````
+
+`````
 
 #### Document Sharding
 
@@ -702,8 +704,9 @@ Tasks are reusable automation instructions that agents can execute. They follow
 ## Examples
 
 @{example: Concrete usage examples}
-````
-````
+`````
+
+`````
 
 #### Task Patterns
 
@@ -718,8 +721,9 @@ Tasks are reusable automation instructions that agents can execute. They follow
 **Advanced Elicitation:**
 ```markdown
 [[LLM: Apply tasks#advanced-elicitation protocol after completion]]
-````
-````
+`````
+
+`````
 
 **Conditional Logic:**
 
@@ -760,8 +764,9 @@ dependencies:
     - custom-task.md
   data:
     - domain-knowledge.md
-````
-````
+`````
+
+`````
 
 #### Agent Startup Instructions
 
@@ -793,7 +798,7 @@ Agents can reference and load documents from the `docs/` folder:
 - docs/brand-guidelines.md for design consistency
 - docs/third-party-apis/ for integration requirements
 - Any project-specific documentation in docs/ folder]]
-````
+`````
 
 ### Technical Preferences System
 
@@ -807,7 +812,7 @@ This file allows you to define your preferred technologies, patterns, and standa
 
 **Technology Stack Preferences:**
 
-````markdown
+`````markdown
 ## Preferred Technologies
 
 ### Frontend
@@ -842,7 +847,9 @@ This file allows you to define your preferred technologies, patterns, and standa
 - RESTful APIs with OpenAPI documentation
 - Event-driven architecture for real-time features
 ````
-````
+`````
+
+`````
 
 **External Services & APIs:**
 
@@ -883,7 +890,8 @@ This file allows you to define your preferred technologies, patterns, and standa
 - Want to try Framework A on next appropriate project
 - Interested in Pattern B for microservices
 - Consider Service C for better performance
-````
+`````
+
 ````
 
 #### Using with Web Bundles
@@ -1042,3 +1050,4 @@ Remember: BMAD is designed to enhance your development process, not replace your
 ---
 
 For additional support, join our [Discord community](https://discord.gg/g6ypHytrCB) or check out the [YouTube channel](https://www.youtube.com/@BMadCode) for video tutorials and walkthroughs.
+````

package/docs/windsurf-guide.md

@@ -23,7 +23,7 @@ For ideation and planning, use Google's Gemini Custom Gem with the team-fullstac
 
 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`
+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

package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md

@@ -0,0 +1,3 @@
+# Usage Information
+
+TODO

package/expansion-packs/expansion-creator/templates/agent-tmpl.md

@@ -16,6 +16,7 @@ activation-instructions:
     - 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
+    - Command
 
 agent:
   name: [AGENT_NAME]
@@ -36,7 +37,9 @@ persona:
     # Add more principles as needed
 
 startup:
-  - [STARTUP_INSTRUCTIONS]
+  - Greet the user with your name and role, and inform of the *help command.
+  - [STARTUP_INSTRUCTION]
+  - [STARTUP_INSTRUCTION]...
 
 commands:
   - "*help" - Show: numbered list of the following commands to allow selection

package/package.json

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