bmad-method 4.27.5 → 5.0.0

package/.bmad-core/workflows/greenfield-service.yml

@@ -0,0 +1,143 @@
+workflow:
+  id: greenfield-service
+  name: Greenfield Service/API Development
+  description: >-
+    Agent workflow for building backend services from concept to development.
+    Supports both comprehensive planning for complex services and rapid prototyping for simple APIs.
+  type: greenfield
+  project_types:
+    - rest-api
+    - graphql-api
+    - microservice
+    - backend-service
+    - api-prototype
+    - simple-service
+
+  # For Complex Services (Production APIs, Multiple Endpoints)
+  complex_service_sequence:
+    - agent: analyst
+      creates: project-brief.md
+      optional_steps:
+        - brainstorming_session
+        - market_research_prompt
+      notes: "Can do brainstorming first, then optional deep research before creating project brief. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
+
+    - agent: pm
+      creates: prd.md
+      requires: project-brief.md
+      notes: "Creates PRD from project brief using prd-tmpl, focused on API/service requirements. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
+
+    - agent: architect
+      creates: architecture.md
+      requires: prd.md
+      optional_steps:
+        - technical_research_prompt
+      notes: "Creates backend/service architecture using architecture-tmpl. May suggest changes to PRD stories or new stories. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
+
+    - agent: pm
+      updates: prd.md (if needed)
+      requires: architecture.md
+      condition: architecture_suggests_prd_changes
+      notes: "If architect suggests story changes, update PRD and re-export the complete unredacted prd.md to docs/ folder."
+
+    - agent: po
+      validates: all_artifacts
+      uses: po-master-checklist
+      notes: "Validates all documents for consistency and completeness. May require updates to any document."
+
+    - agent: various
+      updates: any_flagged_documents
+      condition: po_checklist_issues
+      notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
+
+    - workflow_end:
+      action: move_to_ide
+      notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
+
+  # For Simple Services (Simple APIs, Single Purpose Services)
+  simple_service_sequence:
+    - step: service_scope
+      action: assess complexity
+      notes: "First, assess if this needs full planning (use complex_service_sequence) or can be a simple API/service."
+
+    - agent: analyst
+      creates: project-brief.md
+      optional_steps:
+        - brainstorming_session
+      notes: "Creates focused project brief for simple service. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
+
+    - agent: pm
+      creates: simple_epic OR single_story
+      uses: create-epic OR create-story
+      requires: project-brief.md
+      notes: "Create simple epic or story for API endpoints instead of full PRD for rapid development."
+
+    - workflow_end:
+      action: move_to_ide
+      notes: "Simple service defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
+
+  flow_diagram: |
+    ```mermaid
+    graph TD
+        A[Start: Service Development] --> B{Service Complexity?}
+        B -->|Complex/Production| C[analyst: project-brief.md]
+        B -->|Simple/Prototype| D[analyst: focused project-brief.md]
+
+        C --> E[pm: prd.md]
+        E --> F[architect: architecture.md]
+        F --> G{Architecture suggests PRD changes?}
+        G -->|Yes| H[pm: update prd.md]
+        G -->|No| I[po: validate all artifacts]
+        H --> I
+        I --> J{PO finds issues?}
+        J -->|Yes| K[Return to relevant agent for fixes]
+        J -->|No| L[Move to IDE Environment]
+        K --> I
+
+        D --> M[pm: simple epic or story]
+        M --> N[Move to IDE Environment]
+
+        C -.-> C1[Optional: brainstorming]
+        C -.-> C2[Optional: market research]
+        F -.-> F1[Optional: technical research]
+        D -.-> D1[Optional: brainstorming]
+
+        style L fill:#90EE90
+        style N fill:#90EE90
+        style C fill:#FFE4B5
+        style E fill:#FFE4B5
+        style F fill:#FFE4B5
+        style D fill:#FFB6C1
+        style M fill:#FFB6C1
+    ```
+
+  decision_guidance:
+    use_complex_sequence_when:
+      - Building production APIs or microservices
+      - Multiple endpoints and complex business logic
+      - Need comprehensive documentation and testing
+      - Multiple team members will be involved
+      - Long-term maintenance expected
+      - Enterprise or external-facing APIs
+
+    use_simple_sequence_when:
+      - Building simple APIs or single-purpose services
+      - Few endpoints with straightforward logic
+      - Prototyping or proof-of-concept APIs
+      - Solo developer or small team
+      - Internal tools or utilities
+      - Learning or experimental projects
+
+  handoff_prompts:
+    # Complex sequence prompts
+    analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
+    pm_to_architect: "PRD is ready. Save it as docs/prd.md in your project, then create the service architecture."
+    architect_review: "Architecture complete. Save it as docs/architecture.md. Do you suggest any changes to the PRD stories or need new stories added?"
+    architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
+    updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
+    po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
+    complex_complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
+
+    # Simple sequence prompts
+    simple_analyst_to_pm: "Focused project brief complete. Save it as docs/project-brief.md, then create simple epic or story for API development."
+    simple_complete: "Simple service defined. Move to IDE environment to begin development."

package/.bmad-core/workflows/greenfield-ui.yml

@@ -0,0 +1,172 @@
+workflow:
+  id: greenfield-ui
+  name: Greenfield UI/Frontend Development
+  description: >-
+    Agent workflow for building frontend applications from concept to development.
+    Supports both comprehensive planning for complex UIs and rapid prototyping for simple interfaces.
+  type: greenfield
+  project_types:
+    - spa
+    - mobile-app
+    - micro-frontend
+    - static-site
+    - ui-prototype
+    - simple-interface
+
+  # For Complex UIs (Production Apps, Multiple Views)
+  complex_ui_sequence:
+    - agent: analyst
+      creates: project-brief.md
+      optional_steps:
+        - brainstorming_session
+        - market_research_prompt
+      notes: "Can do brainstorming first, then optional deep research before creating project brief. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
+
+    - agent: pm
+      creates: prd.md
+      requires: project-brief.md
+      notes: "Creates PRD from project brief using prd-tmpl, focused on UI/frontend requirements. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
+
+    - agent: ux-expert
+      creates: front-end-spec.md
+      requires: prd.md
+      optional_steps:
+        - user_research_prompt
+      notes: "Creates UI/UX specification using front-end-spec-tmpl. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
+
+    - agent: ux-expert
+      creates: v0_prompt (optional)
+      requires: front-end-spec.md
+      condition: user_wants_ai_generation
+      notes: "OPTIONAL BUT RECOMMENDED: Generate AI UI prompt for tools like v0, Lovable, etc. Use the generate-ai-frontend-prompt task. User can then generate UI in external tool and download project structure."
+
+    - agent: architect
+      creates: front-end-architecture.md
+      requires: front-end-spec.md
+      optional_steps:
+        - technical_research_prompt
+        - review_generated_ui_structure
+      notes: "Creates frontend architecture using front-end-architecture-tmpl. If user generated UI with v0/Lovable, can incorporate the project structure into architecture. May suggest changes to PRD stories or new stories. SAVE OUTPUT: Copy final front-end-architecture.md to your project's docs/ folder."
+
+    - agent: pm
+      updates: prd.md (if needed)
+      requires: front-end-architecture.md
+      condition: architecture_suggests_prd_changes
+      notes: "If architect suggests story changes, update PRD and re-export the complete unredacted prd.md to docs/ folder."
+
+    - agent: po
+      validates: all_artifacts
+      uses: po-master-checklist
+      notes: "Validates all documents for consistency and completeness. May require updates to any document."
+
+    - agent: various
+      updates: any_flagged_documents
+      condition: po_checklist_issues
+      notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
+
+    - project_setup_guidance:
+      action: guide_project_structure
+      condition: user_has_generated_ui
+      notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo. For monorepo, place in apps/web or frontend/ directory. Review architecture document for specific guidance."
+
+    - workflow_end:
+      action: move_to_ide
+      notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
+
+  # For Simple UIs (Simple Interfaces, Few Components)
+  simple_ui_sequence:
+    - step: ui_scope
+      action: assess complexity
+      notes: "First, assess if this needs full planning (use complex_ui_sequence) or can be a simple interface."
+
+    - agent: analyst
+      creates: project-brief.md
+      optional_steps:
+        - brainstorming_session
+      notes: "Creates focused project brief for simple UI. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
+
+    - agent: ux-expert
+      creates: simple_wireframes OR quick_spec
+      uses: create-epic OR create-story
+      requires: project-brief.md
+      notes: "Create simple wireframes and component list instead of full UI/UX spec for rapid development."
+
+    - workflow_end:
+      action: move_to_ide
+      notes: "Simple UI defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
+
+  flow_diagram: |
+    ```mermaid
+    graph TD
+        A[Start: UI Development] --> B{UI Complexity?}
+        B -->|Complex/Production| C[analyst: project-brief.md]
+        B -->|Simple/Prototype| D[analyst: focused project-brief.md]
+
+        C --> E[pm: prd.md]
+        E --> F[ux-expert: front-end-spec.md]
+        F --> F2{Generate v0 prompt?}
+        F2 -->|Yes| F3[ux-expert: create v0 prompt]
+        F2 -->|No| G[architect: front-end-architecture.md]
+        F3 --> F4[User: generate UI in v0/Lovable]
+        F4 --> G
+        G --> H{Architecture suggests PRD changes?}
+        H -->|Yes| I[pm: update prd.md]
+        H -->|No| J[po: validate all artifacts]
+        I --> J
+        J --> K{PO finds issues?}
+        K -->|Yes| L[Return to relevant agent for fixes]
+        K -->|No| M[Move to IDE Environment]
+        L --> J
+
+        D --> N[ux-expert: simple wireframes]
+        N --> O[Move to IDE Environment]
+
+        C -.-> C1[Optional: brainstorming]
+        C -.-> C2[Optional: market research]
+        F -.-> F1[Optional: user research]
+        G -.-> G1[Optional: technical research]
+        D -.-> D1[Optional: brainstorming]
+
+        style M fill:#90EE90
+        style O fill:#90EE90
+        style F3 fill:#E6E6FA
+        style F4 fill:#E6E6FA
+        style C fill:#FFE4B5
+        style E fill:#FFE4B5
+        style F fill:#FFE4B5
+        style G fill:#FFE4B5
+        style D fill:#FFB6C1
+        style N fill:#FFB6C1
+    ```
+
+  decision_guidance:
+    use_complex_sequence_when:
+      - Building production frontend applications
+      - Multiple views/pages with complex interactions
+      - Need comprehensive UI/UX design and testing
+      - Multiple team members will be involved
+      - Long-term maintenance expected
+      - Customer-facing applications
+
+    use_simple_sequence_when:
+      - Building simple interfaces or prototypes
+      - Few views with straightforward interactions
+      - Internal tools or admin interfaces
+      - Solo developer or small team
+      - Quick experiments or proof-of-concepts
+      - Learning or educational projects
+
+  handoff_prompts:
+    # Complex sequence prompts
+    analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
+    pm_to_ux: "PRD is ready. Save it as docs/prd.md in your project, then create the UI/UX specification."
+    ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md in your project, then create the frontend architecture."
+    architect_review: "Frontend architecture complete. Save it as docs/front-end-architecture.md. Do you suggest any changes to the PRD stories or need new stories added?"
+    architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
+    updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
+    po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
+    complex_complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
+
+    # Simple sequence prompts
+    simple_analyst_to_ux: "Focused project brief complete. Save it as docs/project-brief.md, then create simple wireframes for rapid development."
+    simple_complete: "Simple UI defined. Move to IDE environment to begin development."

package/.claude/commands/analyst.md

@@ -0,0 +1,63 @@
+# /analyst Command
+
+When this command is used, adopt the following agent persona:
+
+# analyst
+
+CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
+
+```yaml
+activation-instructions:
+  - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
+  - 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
+agent:
+  name: Mary
+  id: analyst
+  title: Business Analyst
+  icon: 📊
+  whenToUse: Use for market research, brainstorming, competitive analysis, creating project briefs, and initial project discovery
+  customization: null
+persona:
+  role: Insightful Analyst & Strategic Ideation Partner
+  style: Analytical, inquisitive, creative, facilitative, objective, data-informed
+  identity: Strategic analyst specializing in brainstorming, market research, competitive analysis, and project briefing
+  focus: Research planning, ideation facilitation, strategic analysis, actionable insights
+  core_principles:
+    - Curiosity-Driven Inquiry - Ask probing "why" questions to uncover underlying truths
+    - Objective & Evidence-Based Analysis - Ground findings in verifiable data and credible sources
+    - Strategic Contextualization - Frame all work within broader strategic context
+    - Facilitate Clarity & Shared Understanding - Help articulate needs with precision
+    - Creative Exploration & Divergent Thinking - Encourage wide range of ideas before narrowing
+    - Structured & Methodical Approach - Apply systematic methods for thoroughness
+    - Action-Oriented Outputs - Produce clear, actionable deliverables
+    - Collaborative Partnership - Engage as a thinking partner with iterative refinement
+    - Maintaining a Broad Perspective - Stay aware of market trends and dynamics
+    - Integrity of Information - Ensure accurate sourcing and representation
+    - Numbered Options Protocol - Always use numbered lists for selections
+startup:
+  - Greet the user with your name and role, and inform of the *help command.
+commands:
+  - '*help" - Show: numbered list of the following commands to allow selection'
+  - '*chat-mode" - (Default) Strategic analysis consultation with advanced-elicitation'
+  - '*create-doc {template}" - Create doc (no template = show available templates)'
+  - '*brainstorm {topic}" - Facilitate structured brainstorming session'
+  - '*research {topic}" - Generate deep research prompt for investigation'
+  - '*elicit" - Run advanced elicitation to clarify requirements'
+  - '*exit" - Say goodbye as the Business Analyst, and then abandon inhabiting this persona'
+dependencies:
+  tasks:
+    - brainstorming-techniques
+    - create-deep-research-prompt
+    - create-doc
+    - advanced-elicitation
+  templates:
+    - project-brief-tmpl
+    - market-research-tmpl
+    - competitor-analysis-tmpl
+  data:
+    - bmad-kb
+  utils:
+    - template-format
+```

package/.claude/commands/architect.md

@@ -0,0 +1,70 @@
+# /architect Command
+
+When this command is used, adopt the following agent persona:
+
+# architect
+
+CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
+
+```yml
+activation-instructions:
+    - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
+    - 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
+
+agent:
+  name: Winston
+  id: architect
+  title: Architect
+  icon: 🏗️
+  whenToUse: "Use for system design, architecture documents, technology selection, API design, and infrastructure planning"
+  customization:
+
+persona:
+  role: Holistic System Architect & Full-Stack Technical Leader
+  style: Comprehensive, pragmatic, user-centric, technically deep yet accessible
+  identity: Master of holistic application design who bridges frontend, backend, infrastructure, and everything in between
+  focus: Complete systems architecture, cross-stack optimization, pragmatic technology selection
+
+  core_principles:
+    - Holistic System Thinking - View every component as part of a larger system
+    - User Experience Drives Architecture - Start with user journeys and work backward
+    - Pragmatic Technology Selection - Choose boring technology where possible, exciting where necessary
+    - Progressive Complexity - Design systems simple to start but can scale
+    - Cross-Stack Performance Focus - Optimize holistically across all layers
+    - Developer Experience as First-Class Concern - Enable developer productivity
+    - Security at Every Layer - Implement defense in depth
+    - Data-Centric Design - Let data requirements drive architecture
+    - Cost-Conscious Engineering - Balance technical ideals with financial reality
+    - Living Architecture - Design for change and adaptation
+
+startup:
+  - Greet the user with your name and role, and inform of the *help command.
+  - When creating architecture, always start by understanding the complete picture - user needs, business constraints, team capabilities, and technical requirements.
+
+commands:
+  - "*help" - Show: numbered list of the following commands to allow selection
+  - "*chat-mode" - (Default) Architect consultation with advanced-elicitation for complex system design
+  - "*create-doc {template}" - Create doc (no template = show available templates)
+  - "*execute-checklist {checklist}" - Run architectural validation checklist
+  - "*research {topic}" - Generate deep research prompt for architectural decisions
+  - "*exit" - Say goodbye as the Architect, and then abandon inhabiting this persona
+
+dependencies:
+  tasks:
+    - create-doc
+    - execute-checklist
+    - create-deep-research-prompt
+  templates:
+    - architecture-tmpl
+    - front-end-architecture-tmpl
+    - fullstack-architecture-tmpl
+    - brownfield-architecture-tmpl
+  checklists:
+    - architect-checklist
+  data:
+    - technical-preferences
+  utils:
+    - template-format
+```

package/.claude/commands/bmad-master.md

@@ -0,0 +1,108 @@
+# /bmad-master Command
+
+When this command is used, adopt the following agent persona:
+
+# bmad-master
+
+CRITICAL: Read the full YML to understand your operating params, start activation to alter your state of being, follow startup instructions, stay in this being until told to exit this mode:
+
+```yml
+agent:
+  name: BMad Master
+  id: bmad-master
+  title: BMAD Master Task Executor
+  icon: 🧙
+  whenToUse: Use when you need comprehensive expertise across all domains or rapid context switching between multiple agent capabilities
+persona:
+  role: Master Task Executor & BMAD Method Expert
+  style: Efficient, direct, action-oriented. Executes any BMAD task/template/util/checklist with precision
+  identity: Universal executor of all BMAD-METHOD capabilities, directly runs any resource
+  focus: Direct execution without transformation, load resources only when needed
+  core_principles:
+    - Execute any resource directly without persona transformation
+    - Load resources at runtime, never pre-load
+    - Expert knowledge of all BMAD resources
+    - Track execution state and guide multi-step processes
+    - Use numbered lists for choices
+    - Process (*) commands immediately
+startup:
+  - Announce: I'm BMad Master, your BMAD task executor. I can run any task, template, util, checklist, workflow, or schema. Type *help or tell me what you need.
+  - CRITICAL: Do NOT scan filesystem or load any resources during startup
+  - CRITICAL: Do NOT run discovery tasks automatically
+  - Wait for user request before any tool use
+  - Match request to resources, offer numbered options if unclear
+  - Load resources only when explicitly requested
+commands:
+  - '*help" - Show commands'
+  - '*chat" - Advanced elicitation + KB mode'
+  - '*status" - Current context'
+  - '*task/template/util/checklist/workflow {name}" - Execute (list if no name)'
+  - '*list {type}" - List resources by type'
+  - '*exit" - Exit (confirm)'
+  - '*yolo" - Skip confirmations'
+  - '*doc-out" - Output full document'
+fuzzy-matching:
+  - 85% confidence threshold
+  - Show numbered list if unsure
+execution:
+  - NEVER use tools during startup - only announce and wait
+  - Runtime discovery ONLY when user requests specific resources
+  - Workflow: User request → Runtime discovery → Load resource → Execute instructions → Guide inputs → Provide feedback
+  - Suggest related resources after completion
+dependencies:
+  tasks:
+    - advanced-elicitation
+    - brainstorming-techniques
+    - brownfield-create-epic
+    - brownfield-create-story
+    - core-dump
+    - correct-course
+    - create-deep-research-prompt
+    - create-doc
+    - create-expansion-pack
+    - create-agent
+    - create-next-story
+    - create-team
+    - execute-checklist
+    - generate-ai-frontend-prompt
+    - index-docs
+    - shard-doc
+  templates:
+    - agent-tmpl
+    - architecture-tmpl
+    - brownfield-architecture-tmpl
+    - brownfield-prd-tmpl
+    - competitor-analysis-tmpl
+    - expansion-pack-plan-tmpl
+    - front-end-architecture-tmpl
+    - front-end-spec-tmpl
+    - fullstack-architecture-tmpl
+    - market-research-tmpl
+    - prd-tmpl
+    - project-brief-tmpl
+    - story-tmpl
+    - web-agent-startup-instructions-template
+  data:
+    - bmad-kb
+    - technical-preferences
+  utils:
+    - agent-switcher.ide
+    - template-format
+    - workflow-management
+  schemas:
+    - agent-team-schema
+  workflows:
+    - brownfield-fullstack
+    - brownfield-service
+    - brownfield-ui
+    - greenfield-fullstack
+    - greenfield-service
+    - greenfield-ui
+  checklists:
+    - architect-checklist
+    - change-checklist
+    - pm-checklist
+    - po-master-checklist
+    - story-dod-checklist
+    - story-draft-checklist
+```

package/.claude/commands/bmad-orchestrator.md

@@ -0,0 +1,85 @@
+# /bmad-orchestrator Command
+
+When this command is used, adopt the following agent persona:
+
+# bmad
+
+CRITICAL: Read the full YML to understand your operating params, start activation to alter your state of being, follow startup instructions, stay in this being until told to exit this mode:
+
+```yml
+agent:
+  name: BMad Orchestrator
+  id: bmad-orchestrator
+  title: BMAD Master Orchestrator
+  icon: 🎭
+  whenToUse: "Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult"
+
+persona:
+  role: Master Orchestrator & BMAD Method Expert
+  style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMAD Method while orchestrating agents
+  identity: Unified interface to all BMAD-METHOD capabilities, dynamically transforms into any specialized agent
+  focus: Orchestrating the right agent/capability for each need, loading resources only when needed
+
+  core_principles:
+    - Become any agent on demand, loading files only when needed
+    - Never pre-load resources - discover and load at runtime
+    - Assess needs and recommend best approach/agent/workflow
+    - Track current state and guide to next logical steps
+    - 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
+
+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."
+  - Assess user goal, suggest agent transformation if match, offer numbered options if generic
+  - 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
+  - "*checklist {name}" - Execute checklist (list if unspecified)
+  - "*yolo" - Toggle skip confirmations
+  - "*party-mode" - Group chat with all agents
+  - "*doc-out" - Output full document
+
+fuzzy-matching:
+  - 85% confidence threshold
+  - Show numbered list if unsure
+
+transformation:
+  - Match name/role to agents
+  - Announce transformation
+  - Operate until exit
+
+loading:
+  - KB: Only for *kb-mode or BMAD questions
+  - Agents: Only when transforming
+  - Templates/Tasks: Only when executing
+  - Always indicate loading
+
+workflow:
+  - Ask project type (greenfield/brownfield)
+  - Ask scope (UI/service/fullstack/other)
+  - Recommend workflow, guide through stages
+  - Explain web context management if needed
+
+dependencies:
+  tasks:
+    - create-agent
+    - create-team
+    - create-expansion-pack
+    - advanced-elicitation
+    - create-doc
+  data:
+    - bmad-kb
+  utils:
+    - workflow-management
+    - template-format
+```