bmad-method 4.5.0 → 4.6.0

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+# [4.6.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.5.1...v4.6.0) (2025-06-18)
+
+
+### Bug Fixes
+
+* orchestractor yml ([3727cc7](https://github.com/bmadcode/BMAD-METHOD/commit/3727cc764a7c7295932ff872e2e5be8b4c4e6859))
+
+
+### Features
+
+* removed some templates that are not ready for use ([b03aece](https://github.com/bmadcode/BMAD-METHOD/commit/b03aece79e52cfe9585225de5aff7659293d9295))
+
+## [4.5.1](https://github.com/bmadcode/BMAD-METHOD/compare/v4.5.0...v4.5.1) (2025-06-18)
+
+
+### Bug Fixes
+
+* docs had some ide specific errors ([a954c7e](https://github.com/bmadcode/BMAD-METHOD/commit/a954c7e24284a6637483a9e47fc63a8f9d7dfbad))
+
 # [4.5.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.4.2...v4.5.0) (2025-06-17)
 
 

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

@@ -22,72 +22,68 @@ persona:
     - When embodied, specialized persona's principles take precedence
     - Be explicit about active persona and current task
     - Always use numbered lists for choices
-    - Process (*) commands immediately
+    - Process commands starting with * immediately
+    - Always remind users that commands require * prefix
 startup:
-  - Announce: Hey! I'm BMad, your BMAD-METHOD orchestrator. I can become any specialized agent, suggest workflows, explain setup, or help with any BMAD task. Type *help for options.
+  - Announce: Introduce yourself as the BMAD Orchestrator, explain you can coordinate agents and workflows
+  - IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
+  - Mention *help shows all available commands and options
   - Assess user goal against available agents and workflows in this bundle
-  - If clear match to an agent's expertise, suggest transformation
-  - If project-oriented, explore available workflows and guide selection
-  - Load resources only when needed
-commands:
-  - '*help" - Show commands/workflows/agents'
-  - '*chat-mode" - Conversational mode with advanced-elicitation'
-  - '*kb-mode" - Load knowledge base for full BMAD help'
-  - '*status" - Show current context/agent/progress'
-  - '*agent {name}" - Transform into agent (list if unspecified)'
-  - '*exit" - Return to BMad or exit (confirm if exiting BMad)'
-  - '*task {name}" - Run task (list if unspecified)'
-  - '*workflow {type}" - Start/list workflows'
-  - '*workflow-guidance" - Get help selecting the right workflow for your project'
-  - '*checklist {name}" - Execute checklist (list if unspecified)'
-  - '*yolo" - Toggle skip confirmations'
-  - '*party-mode" - Group chat with all agents'
-  - '*doc-out" - Output full document'
-help-format:
-  - When *help is called, focus on agent capabilities and what each can do
-  - List actual agent names with their specializations and deliverables
-  - List actual workflow names with descriptions
-  - 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"
+  - If clear match to an agent's expertise, suggest transformation with *agent command
+  - If project-oriented, suggest *workflow-guidance to explore options
+  - Load resources only when needed - never pre-load
+commands:  # All commands require * prefix when used (e.g., *help, *agent pm)
+  help: Show this guide with available agents and workflows
+  chat-mode: Start conversational mode for detailed assistance  
+  kb-mode: Load full BMAD knowledge base
+  status: Show current context, active agent, and progress
+  agent: Transform into a specialized agent (list if name not specified)
+  exit: Return to BMad or exit session
+  task: Run a specific task (list if name not specified)
+  workflow: Start a specific workflow (list if name not specified)
+  workflow-guidance: Get personalized help selecting the right workflow
+  checklist: Execute a checklist (list if name not specified)
+  yolo: Toggle skip confirmations mode
+  party-mode: Group chat with all agents
+  doc-out: Output full document
 help-display-template: |
-  🎭 BMad Orchestrator - Your Gateway to Specialized Agents
+  === BMAD Orchestrator Commands ===
+  All commands must start with * (asterisk)
   
-  I coordinate specialized agents for different tasks. Tell me what you need, and I'll connect you with the right expert!
+  Core Commands:
+  *help ............... Show this guide
+  *chat-mode .......... Start conversational mode for detailed assistance
+  *kb-mode ............ Load full BMAD knowledge base
+  *status ............. Show current context, active agent, and progress
+  *exit ............... Return to BMad or exit session
   
-  Orchestrator Commands:
-  *help: Show this guide
-  *chat-mode: Start conversational mode for detailed assistance
-  *kb-mode: Load full BMAD knowledge base
-  *status: Show current context, active agent, and progress
-  *yolo: Toggle skip confirmations mode
-  *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)
+  Agent & Task Management:
+  *agent [name] ....... Transform into specialized agent (list if no name)
+  *task [name] ........ Run specific task (list if no name, requires agent)
+  *checklist [name] ... Execute checklist (list if no name, requires agent)
   
   Workflow Commands:
-  *workflow {name}: Start a specific workflow directly
-  *workflow-guidance: Get personalized help selecting the right workflow for your project
+  *workflow [name] .... Start specific workflow (list if no name)
+  *workflow-guidance .. Get personalized help selecting the right workflow
+  
+  Other Commands:
+  *yolo ............... Toggle skip confirmations mode
+  *party-mode ......... Group chat with all agents
+  *doc-out ............ Output full document
   
-  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 Specialist Agents ===
+  [Dynamically list each agent in bundle with format:
+  *agent {id}: {title}
+    When to use: {whenToUse}
+    Key deliverables: {main outputs/documents}]
   
-  Available Workflows:
-  [For each workflow in bundle, show:
-  *workflow {name}: {workflow description}]
+  === Available Workflows ===
+  [Dynamically list each workflow in bundle with format:
+  *workflow {id}: {name}
+    Purpose: {description}]
   
-  💡 Tip: Each agent has their own tasks, templates, and checklists. Switch to an agent to see what they can do!
+  💡 Tip: Each agent has unique tasks, templates, and checklists. Switch to an agent to access their capabilities!
+
 fuzzy-matching:
   - 85% confidence threshold
   - Show numbered list if unsure
@@ -98,24 +94,17 @@ 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
   - Understand each workflow's purpose, options, and decision points
   - Ask clarifying questions based on the workflow's structure
   - Guide users through workflow selection when multiple options exist
-  - For workflows with divergent paths (e.g., simple vs complex), help users choose the right path
+  - For workflows with divergent paths, help users choose the right path
   - Adapt questions to the specific domain (e.g., game dev vs infrastructure vs web dev)
   - Only recommend workflows that actually exist in the current bundle
-workflow-guidance-command:
-  - When *workflow-guidance is called, start an interactive session
-  - First, list all available workflows with brief descriptions
-  - Ask about the user's project goals and constraints
-  - Based on answers, recommend the most suitable workflow
-  - If a workflow has multiple paths, help choose between them (e.g., complex vs simple project flow)
-  - Explain what documents will be created and which agents will be involved
-  - Offer to start the recommended workflow immediately
+  - When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions
 dependencies:
   tasks:
     - advanced-elicitation

package/bmad-core/agents/pm.md

@@ -48,7 +48,6 @@ dependencies:
   templates:
     - prd-tmpl
     - brownfield-prd-tmpl
-    - simple-project-prd-tmpl
   checklists:
     - pm-checklist
     - change-checklist

package/bmad-core/tasks/doc-migration-task.md

@@ -68,7 +68,7 @@ The epic numbering starts at 1 and increments for each epic found.
 
 ### Before (PRD):
 
-`````markdown
+```markdown
 # Product Requirements Document
 
 ## 1. Executive Summary
@@ -91,9 +91,10 @@ Epic content...
 
 Content here...
 
-````text
+```
 
 ### After (PRD):
+
 ```markdown
 # Product Requirements Document
 
@@ -113,9 +114,11 @@ Epic content...
 
 ## Success Metrics
 Content here...
-```text
+
+```
 
 ### Before (Non-PRD):
+
 ```markdown
 # Architecture Document
 
@@ -124,9 +127,10 @@ Content...
 
 ## 2.1 Technical Stack & Tools
 Content...
-```text
+```
 
 ### After (Non-PRD):
+
 ```markdown
 # Architecture Document
 
@@ -135,9 +139,5 @@ Content...
 
 ## Technical Stack Tools
 Content...
-````
-`````
 
-```text
-
-```
+```

package/bmad-core/tasks/index-docs.md

@@ -56,7 +56,7 @@ You are now operating as a Documentation Indexer. Your goal is to ensure all doc
 
 The index should be organized as follows:
 
-`````markdown
+```markdown
 # Documentation Index
 
 ## Root Documents
@@ -89,7 +89,7 @@ Documents within the `another-folder/` directory:
 
 Description of nested document.
 
-````text
+```
 
 ### Index Entry Format
 
@@ -99,10 +99,7 @@ Each entry should follow this format:
 ### [Document Title](relative/path/to/file.md)
 
 Brief description of the document's purpose and contents.
-````
-`````
-
-````
+```
 
 ### Rules of Operation
 
@@ -180,4 +177,3 @@ Please provide:
 5. Whether to include hidden files/folders (starting with `.`)
 
 Would you like to proceed with documentation indexing? Please provide the required input above.
-````

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

@@ -131,7 +131,7 @@ Create subsections for each major flow. After presenting all flows, apply `tasks
 
 ```mermaid
 {{flow_diagram}}
-```text
+```
 
 **Edge Cases & Error Handling:**
 

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

@@ -84,7 +84,7 @@ Document the choice and key services that will be used.]]
 
 ### Repository Structure
 
-[[LLM: Define the repository approach based on PRD requirements and platform choice:
+[[LLM: Define the repository approach based on PRD requirements and platform choice, explain your rationale or ask quetsions to the user if unsure:
 
 1. For modern fullstack apps, monorepo is often preferred
 2. Consider tooling (Nx, Turborepo, Lerna, npm workspaces)
@@ -109,9 +109,9 @@ Document the choice and key services that will be used.]]
 
 Use appropriate diagram type for clarity.]]
 
-````mermaid
+```mermaid
 {{architecture_diagram}}
-```text
+```
 
 ### Architectural Patterns
 
@@ -222,7 +222,7 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
     model_interface;
   }
 }
-````
+```
 
 **Relationships:**
 
@@ -246,7 +246,7 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
 
 **TypeScript Interface:**
 
-````typescript
+```typescript
 interface User {
   id: string;
   email: string;
@@ -262,7 +262,7 @@ interface UserProfile {
   bio?: string;
   preferences: Record<string, any>;
 }
-```text
+```
 
 **Relationships:**
 
@@ -300,16 +300,16 @@ servers:
       '[object Object]': null
     description:
       '[object Object]': null
-````
+```
 
 ^^/CONDITION: has_rest_api^^
 
 ^^CONDITION: has_graphql_api^^
 
-````graphql
+```graphql
 # GraphQL Schema
 {{graphql_schema}}
-```text
+```
 
 ^^/CONDITION: has_graphql_api^^
 
@@ -322,7 +322,7 @@ servers:
     trpc_routers;
   }
 }
-````
+```
 
 ^^/CONDITION: has_trpc_api^^
 
@@ -467,19 +467,19 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 **Component Organization:**
 
-`````text
-{{component_structure}}
 ```text
+{{component_structure}}
+```
 
 **Component Template:**
 
-````typescript
+```typescript
 {
   {
     component_template;
   }
 }
-```text
+```
 
 ### State Management Architecture
 
@@ -493,7 +493,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
     state_structure;
   }
 }
-`````
+```
 
 **State Management Patterns:**
 
@@ -508,17 +508,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 ```text
 {{route_structure}}
-```text
+```
 
 **Protected Route Pattern:**
 
-````typescript
+```typescript
 {
   {
     protected_route_example;
   }
 }
-```text
+```
 
 ### Frontend Services Layer
 
@@ -532,17 +532,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
     api_client_setup;
   }
 }
-````
+```
 
 **Service Example:**
 
-````typescript
+```typescript
 {
   {
     service_example;
   }
 }
-```text
+```
 
 ## Backend Architecture
 
@@ -557,11 +557,11 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 ^^CONDITION: serverless^^
 **Function Organization:**
 
-````
+```text
 
 {{function_structure}}
 
-````text
+```
 
 **Function Template:**
 
@@ -571,26 +571,26 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
     function_template;
   }
 }
-````
+```
 
 ^^/CONDITION: serverless^^
 
 ^^CONDITION: traditional_server^^
 **Controller/Route Organization:**
 
-`````text
-{{controller_structure}}
 ```text
+{{controller_structure}}
+```
 
 **Controller Template:**
 
-````typescript
+```typescript
 {
   {
     controller_template;
   }
 }
-```text
+```
 
 ^^/CONDITION: traditional_server^^
 
@@ -602,17 +602,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 ```sql
 {{database_schema}}
-`````
+```
 
 **Data Access Layer:**
 
-````typescript
+```typescript
 {
   {
     repository_pattern;
   }
 }
-```text
+```
 
 ### Authentication and Authorization
 
@@ -622,17 +622,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 ```mermaid
 {{auth_flow_diagram}}
-````
+```
 
 **Middleware/Guards:**
 
-````typescript
+```typescript
 {
   {
     auth_middleware;
   }
 }
-```text
+```
 
 ## Unified Project Structure
 
@@ -692,7 +692,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 ├── package.json                # Root package.json
 ├── {{monorepo_config}}         # Monorepo configuration
 └── README.md
-````
+```
 
 @{example: vercel_structure}
 apps/
@@ -714,19 +714,19 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 **Prerequisites:**
 
-````bash
+```bash
 {{prerequisites_commands}}
-```text
+```
 
 **Initial Setup:**
 
 ```bash
 {{setup_commands}}
-````
+```
 
 **Development Commands:**
 
-````bash
+```bash
 # Start all services
 {{start_all_command}}
 
@@ -738,7 +738,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 # Run tests
 {{test_commands}}
-```text
+```
 
 ### Environment Configuration
 
@@ -753,7 +753,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 # Shared
 {{shared_env_vars}}
-````
+```
 
 ## Deployment Architecture
 
@@ -776,9 +776,9 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 ### CI/CD Pipeline
 
-````yaml
+```yaml
 '[object Object]': null
-```text
+```
 
 ### Environments
 
@@ -836,7 +836,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 ### Testing Pyramid
 
-````
+```text
 
         E2E Tests
        /          \
@@ -845,17 +845,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 / \
  Frontend Unit Backend Unit
 
-```text
+```
 
 ### Test Organization
 
 **Frontend Tests:**
 
-```
+```text
 
 {{frontend_test_structure}}
 
-````text
+```
 
 **Backend Tests:**
 
@@ -863,15 +863,15 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 {{backend_test_structure}}
 
-```text
+```
 
 **E2E Tests:**
 
-````
+```text
 
 {{e2e_test_structure}}
 
-````text
+```
 
 ### Test Examples
 
@@ -883,17 +883,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
     frontend_test_example;
   }
 }
-````
+```
 
 **Backend API Test:**
 
-````typescript
+```typescript
 {
   {
     backend_test_example;
   }
 }
-```text
+```
 
 **E2E Test:**
 
@@ -903,7 +903,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
     e2e_test_example;
   }
 }
-````
+```
 
 ## Coding Standards
 
@@ -944,9 +944,9 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
 
 ### Error Flow
 
-````mermaid
+```mermaid
 {{error_flow_diagram}}
-```text
+```
 
 ### Error Response Format
 
@@ -960,17 +960,17 @@ interface ApiError {
     requestId: string;
   };
 }
-````
+```
 
 ### Frontend Error Handling
 
-````typescript
+```typescript
 {
   {
     frontend_error_handler;
   }
 }
-```text
+```
 
 ### Backend Error Handling
 
@@ -980,7 +980,7 @@ interface ApiError {
     backend_error_handler;
   }
 }
-````
+```
 
 ## Monitoring and Observability