bmad-method 4.6.3 → 4.8.0

package/dist/agents/qa.txt

@@ -75,10 +75,10 @@ persona:
 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) QA consultation with advanced-elicitation for test strategy'
-  - '*create-doc {template}" - Create doc (no template = show available templates)'
-  - '*exit" - Say goodbye as the QA Test Architect, and then abandon inhabiting this persona'
+  - help: Show numbered list of the following commands to allow selection
+  - chat-mode: (Default) QA consultation with advanced-elicitation for test strategy
+  - create-doc {template}: Create doc (no template = show available templates)
+  - exit: Say goodbye as the QA Test Architect, and then abandon inhabiting this persona
 dependencies:
   data:
     - technical-preferences

package/dist/agents/sm.txt

@@ -46,7 +46,6 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll
 ```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:
@@ -62,31 +61,25 @@ persona:
   identity: Story creation expert who prepares detailed, actionable stories for AI developers
   focus: Creating crystal-clear stories that dumb AI agents can implement without confusion
   core_principles:
-    - Task Adherence - Rigorously follow create-next-story procedures
-    - Checklist-Driven Validation - Apply story-draft-checklist meticulously
-    - Clarity for Developer Handoff - Stories must be immediately actionable
-    - Focus on One Story at a Time - Complete one before starting next
-    - Numbered Options Protocol - Always use numbered lists for selections
+    - Rigorously follow `create-next-story` procedure to generate the detailed user story
+    - Will ensure all information comes from the PRD and Architecture to guide the dumb dev agent
+    - You are NOT allowed to implement stories or modify code EVER!
 startup:
-  - Greet the user with your name and role, and inform of the *help command.
-  - CRITICAL: Do NOT automatically execute create-next-story tasks during startup
-  - CRITICAL: Do NOT create or modify any files during startup
+  - Greet the user with your name and role, and inform of the *help command and then HALT to await instruction if not given already.
   - Offer to help with story preparation but wait for explicit user confirmation
   - Only execute tasks when user explicitly requests them
-  - 'CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Dev Agent'
 commands:
-  - '*help" - Show: numbered list of the following commands to allow selection'
-  - '*chat-mode" - Conversational mode with advanced-elicitation for advice'
-  - '*create" - Execute all steps in Create Next Story Task document'
-  - '*pivot" - Run correct-course task (ensure no story already created first)'
-  - '*checklist {checklist}" - Show numbered list of checklists, execute selection'
-  - '*doc-shard {PRD|Architecture|Other}" - Execute shard-doc task'
-  - '*index-docs" - Update documentation index in /docs/index.md'
-  - '*exit" - Say goodbye as the Scrum Master, and then abandon inhabiting this persona'
+  - help: Show numbered list of the following commands to allow selection
+  - chat-mode: Conversational mode with advanced-elicitation for advice
+  - create|draft: Execute create-next-story
+  - pivot: Execute `correct-course` task
+  - checklist {checklist}: Show numbered list of checklists, execute selection
+  - exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona
 dependencies:
   tasks:
     - create-next-story
     - execute-checklist
+    - course-correct
   templates:
     - story-tmpl
   checklists:
@@ -103,45 +96,42 @@ dependencies:
 
 To identify the next logical story based on project progress and epic definitions, and then to prepare a comprehensive, self-contained, and actionable story file using the `Story Template`. This task ensures the story is enriched with all necessary technical context, requirements, and acceptance criteria, making it ready for efficient implementation by a Developer Agent with minimal need for additional research.
 
-## Inputs for this Task
-
-- Access to the project's documentation repository, specifically:
-  - `docs/index.md` (hereafter "Index Doc")
-  - All Epic files - located in one of these locations:
-    - Primary: `docs/prd/epic-{n}-{description}.md` (e.g., `epic-1-foundation-core-infrastructure.md`)
-    - Secondary: `docs/epics/epic-{n}-{description}.md`
-    - User-specified location if not found in above paths
-  - Existing story files in `docs/stories/`
-  - Main PRD (hereafter "PRD Doc")
-  - Main Architecture Document (hereafter "Main Arch Doc")
-  - Frontend Architecture Document (hereafter "Frontend Arch Doc," if relevant)
-  - Project Structure Guide (`docs/project-structure.md`)
-  - Operational Guidelines Document (`docs/operational-guidelines.md`)
-  - Technology Stack Document (`docs/tech-stack.md`)
-  - Data Models Document (as referenced in Index Doc)
-  - API Reference Document (as referenced in Index Doc)
-  - UI/UX Specifications, Style Guides, Component Guides (if relevant, as referenced in Index Doc)
-- The `bmad-core/templates/story-tmpl.md` (hereafter "Story Template")
-- The `bmad-core/checklists/story-draft-checklist.md` (hereafter "Story Draft Checklist")
-- User confirmation to proceed with story identification and, if needed, to override warnings about incomplete prerequisite stories.
-
 ## Task Execution Instructions
 
+### 0. Load Core Configuration
+
+[[LLM: CRITICAL - This MUST be your first step]]
+
+- Load `.bmad-core/core-config.yml` from the project root
+- If the file does not exist:
+  - HALT and inform the user: "core-config.yml not found. This file is required for story creation. You can:
+    1. Copy it from GITHUB BMAD-METHOD/bmad-core/core-config.yml and configure it for your project
+    2. Run the BMAD installer against your project to upgrade and add the file automatically
+    Please add and configure core-config.yml before proceeding."
+- Extract the following key configurations:
+  - `dev-story-location`: Where to save story files
+  - `prd.prdSharded`: Whether PRD is sharded or monolithic
+  - `prd.prd-file`: Location of monolithic PRD (if not sharded)
+  - `prd.prdShardedLocation`: Location of sharded epic files
+  - `prd.epicFilePattern`: Pattern for epic files (e.g., `epic-{n}*.md`)
+  - `architecture.architectureVersion`: Architecture document version
+  - `architecture.architectureSharded`: Whether architecture is sharded
+  - `architecture.architecture-file`: Location of monolithic architecture
+  - `architecture.architectureShardedLocation`: Location of sharded architecture files
+
 ### 1. Identify Next Story for Preparation
 
 #### 1.1 Locate Epic Files
 
-- First, determine where epic files are located:
-  - Check `docs/prd/` for files matching pattern `epic-{n}-*.md`
-  - If not found, check `docs/epics/` for files matching pattern `epic-{n}-*.md`
-  - If still not found, ask user: "Unable to locate epic files. Please specify the path where epic files are stored."
-- Note: Epic files follow naming convention `epic-{n}-{description}.md` (e.g., `epic-1-foundation-core-infrastructure.md`)
+- Based on `prdSharded` from config:
+  - **If `prdSharded: true`**: Look for epic files in `prdShardedLocation` using `epicFilePattern`
+  - **If `prdSharded: false`**: Load the full PRD from `prd-file` and extract epics from section headings (## Epic N or ### Epic N)
 
 #### 1.2 Review Existing Stories
 
-- Review `docs/stories/` to find the highest-numbered story file.
+- Check `dev-story-location` from config (e.g., `docs/stories/`) for existing story files
+- If the directory exists and has at least 1 file, find the highest-numbered story file.
 - **If a highest story file exists (`{lastEpicNum}.{lastStoryNum}.story.md`):**
-
   - Verify its `Status` is 'Done' (or equivalent).
   - If not 'Done', present an alert to the user:
 
@@ -159,17 +149,17 @@ To identify the next logical story based on project progress and epic definition
     ```
 
   - Proceed only if user selects option 3 (Override) or if the last story was 'Done'.
-  - If proceeding: Look for the Epic File for `{lastEpicNum}` (e.g., `epic-{lastEpicNum}-*.md`) and check for a story numbered `{lastStoryNum + 1}`. If it exists and its prerequisites (per Epic File) are met, this is the next story.
-  - Else (story not found or prerequisites not met): The next story is the first story in the next Epic File (e.g., look for `epic-{lastEpicNum + 1}-*.md`, then `epic-{lastEpicNum + 2}-*.md`, etc.) whose prerequisites are met.
+  - If proceeding: Look for the Epic File for `{lastEpicNum}` (e.g., `epic-{lastEpicNum}*.md`) and check for a story numbered `{lastStoryNum + 1}`. If it exists and its prerequisites (per Epic File) are met, this is the next story.
+  - Else (story not found or prerequisites not met): The next story is the first story in the next Epic File (e.g., look for `epic-{lastEpicNum + 1}*.md`, then `epic-{lastEpicNum + 2}*.md`, etc.) whose prerequisites are met.
 
 - **If no story files exist in `docs/stories/`:**
   - The next story is the first story in the first epic file (look for `epic-1-*.md`, then `epic-2-*.md`, etc.) whose prerequisites are met.
 - If no suitable story with met prerequisites is found, report to the user that story creation is blocked, specifying what prerequisites are pending. HALT task.
 - Announce the identified story to the user: "Identified next story for preparation: {epicNum}.{storyNum} - {Story Title}".
 
-### 2. Gather Core Story Requirements (from Epic File)
+### 2. Gather Core Story Requirements (from Epic)
 
-- For the identified story, open its parent Epic File (e.g., `epic-{epicNum}-*.md` from the location identified in step 1.1).
+- For the identified story, review its parent Epic (e.g., `epic-{epicNum}*.md` from the location identified in step 1.1).
 - Extract: Exact Title, full Goal/User Story statement, initial list of Requirements, all Acceptance Criteria (ACs), and any predefined high-level Tasks.
 - Keep a record of this original epic-defined scope for later deviation analysis.
 
@@ -178,7 +168,7 @@ To identify the next logical story based on project progress and epic definition
 [[LLM: This step is CRITICAL for continuity and learning from implementation experience]]
 
 - If this is not the first story (i.e., previous story exists):
-  - Read the previous story file: `docs/stories/{prevEpicNum}.{prevStoryNum}.story.md`
+  - Read the previous sequential story from `docs/stories`
   - Pay special attention to:
     - Dev Agent Record sections (especially Completion Notes and Debug Log References)
     - Any deviations from planned implementation
@@ -187,18 +177,30 @@ To identify the next logical story based on project progress and epic definition
     - Any "lessons learned" or notes for future stories
   - Extract relevant insights that might inform the current story's preparation
 
-### 4. Gather & Synthesize Architecture Context from Sharded Docs
+### 4. Gather & Synthesize Architecture Context
+
+[[LLM: CRITICAL - You MUST gather technical details from the architecture documents. NEVER make up technical details not found in these documents.]]
 
-[[LLM: CRITICAL - You MUST gather technical details from the sharded architecture documents. NEVER make up technical details not found in these documents.]]
+#### 4.1 Determine Architecture Document Strategy
 
-#### 4.1 Start with Architecture Index
+Based on configuration loaded in Step 0:
 
-- Read `docs/architecture/index.md` to understand the full scope of available documentation
-- Identify which sharded documents are most relevant to the current story
+- **If `architectureVersion: v4` and `architectureSharded: true`**:
+  - Read `{architectureShardedLocation}/index.md` to understand available documentation
+  - Follow the structured reading order in section 4.2 below
+  
+- **If `architectureVersion: v4` and `architectureSharded: false`**:
+  - Load the monolithic architecture from `architecture-file`
+  - Extract relevant sections based on v4 structure (tech stack, project structure, etc.)
+  
+- **If `architectureVersion` is NOT v4**:
+  - Inform user: "Architecture document is not v4 format. Will use best judgment to find relevant information."
+  - If `architectureSharded: true`: Search sharded files by filename relevance
+  - If `architectureSharded: false`: Search within monolithic `architecture-file` for relevant sections
 
-#### 4.2 Recommended Reading Order Based on Story Type
+#### 4.2 Recommended Reading Order Based on Story Type (v4 Sharded Only)
 
-[[LLM: Read documents in this order, but ALWAYS verify relevance to the specific story. Skip irrelevant sections but NEVER skip documents that contain information needed for the story.]]
+[[LLM: Use this structured approach ONLY for v4 sharded architecture. For other versions, use best judgment based on file names and content.]]
 
 **For ALL Stories:**
 
@@ -207,9 +209,18 @@ To identify the next logical story based on project progress and epic definition
 3. `docs/architecture/coding-standards.md` - Ensure dev follows project conventions
 4. `docs/architecture/testing-strategy.md` - Include testing requirements in tasks
 
-**For Backend/API Stories, additionally read:** 5. `docs/architecture/data-models.md` - Data structures and validation rules 6. `docs/architecture/database-schema.md` - Database design and relationships 7. `docs/architecture/backend-architecture.md` - Service patterns and structure 8. `docs/architecture/rest-api-spec.md` - API endpoint specifications 9. `docs/architecture/external-apis.md` - Third-party integrations (if relevant)
+**For Backend/API Stories, additionally read:**
+5. `docs/architecture/data-models.md` - Data structures and validation rules
+6. `docs/architecture/database-schema.md` - Database design and relationships
+7. `docs/architecture/backend-architecture.md` - Service patterns and structure
+8. `docs/architecture/rest-api-spec.md` - API endpoint specifications
+9. `docs/architecture/external-apis.md` - Third-party integrations (if relevant)
 
-**For Frontend/UI Stories, additionally read:** 5. `docs/architecture/frontend-architecture.md` - Component structure and patterns 6. `docs/architecture/components.md` - Specific component designs 7. `docs/architecture/core-workflows.md` - User interaction flows 8. `docs/architecture/data-models.md` - Frontend data handling
+**For Frontend/UI Stories, additionally read:**
+5. `docs/architecture/frontend-architecture.md` - Component structure and patterns
+6. `docs/architecture/components.md` - Specific component designs
+7. `docs/architecture/core-workflows.md` - User interaction flows
+8. `docs/architecture/data-models.md` - Frontend data handling
 
 **For Full-Stack Stories:**
 
@@ -242,7 +253,7 @@ Format references as: `[Source: architecture/{filename}.md#{section}]`
 
 ### 6. Populate Story Template with Full Context
 
-- Create a new story file: `docs/stories/{epicNum}.{storyNum}.story.md`.
+- Create a new story file: `{dev-story-location}/{epicNum}.{storyNum}.story.md` (using location from config).
 - Use the Story Template to structure the file.
 - Fill in:
   - Story `{EpicNum}.{StoryNum}: {Short Title Copied from Epic File}`
@@ -289,7 +300,7 @@ Format references as: `[Source: architecture/{filename}.md#{section}]`
 - Verify all source references are included for technical details
 - Ensure tasks align with both epic requirements and architecture constraints
 - Update status to "Draft"
-- Save the story file to `docs/stories/{epicNum}.{storyNum}.story.md`
+- Save the story file to `{dev-story-location}/{epicNum}.{storyNum}.story.md` (using location from config)
 
 ### 9. Report Completion
 

package/dist/agents/ux-expert.txt

@@ -79,13 +79,13 @@ startup:
   - Greet the user with your name and role, and inform of the *help command.
   - Always start by understanding the user's context, goals, and constraints before proposing solutions.
 commands:
-  - '*help" - Show: numbered list of the following commands to allow selection'
-  - '*chat-mode" - (Default) UX consultation with advanced-elicitation for design decisions'
-  - '*create-doc {template}" - Create doc (no template = show available templates)'
-  - '*generate-ui-prompt" - Create AI frontend generation prompt'
-  - '*research {topic}" - Generate deep research prompt for UX investigation'
-  - '*execute-checklist {checklist}" - Run design validation checklist'
-  - '*exit" - Say goodbye as the UX Expert, and then abandon inhabiting this persona'
+  - help: Show numbered list of the following commands to allow selection
+  - chat-mode: (Default) UX consultation with advanced-elicitation for design decisions
+  - create-doc {template}: Create doc (no template = show available templates)
+  - generate-ui-prompt: Create AI frontend generation prompt
+  - research {topic}: Generate deep research prompt for UX investigation
+  - execute-checklist {checklist}: Run design validation checklist
+  - exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona
 dependencies:
   tasks:
     - generate-ai-frontend-prompt
@@ -639,6 +639,8 @@ The LLM will:
 ==================== START: templates#front-end-spec-tmpl ====================
 # {{Project Name}} UI/UX Specification
 
+[[LLM: The default path and filename unless specified is docs/front-end-spec.md]]
+
 [[LLM: Review provided documents including Project Brief, PRD, and any user research to gather context. Focus on understanding user needs, pain points, and desired outcomes before beginning the specification.]]
 
 ## Introduction

package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt

@@ -92,13 +92,13 @@ persona:
 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'
+  - 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
@@ -117,9 +117,9 @@ dependencies:
 ==================== END: agents#analyst ====================
 
 ==================== START: agents#bmad-orchestrator ====================
-# bmad
+# bmad-orchestrator
 
-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:
+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
 agent:
@@ -151,9 +151,9 @@ startup:
   - 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)
+commands:
   help: Show this guide with available agents and workflows
-  chat-mode: Start conversational mode for detailed assistance  
+  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)
@@ -168,41 +168,40 @@ commands:  # All commands require * prefix when used (e.g., *help, *agent pm)
 help-display-template: |
   === BMAD Orchestrator Commands ===
   All commands must start with * (asterisk)
-  
+
   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
-  
+
   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 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 ===
   [Dynamically list each agent in bundle with format:
   *agent {id}: {title}
     When to use: {whenToUse}
     Key deliverables: {main outputs/documents}]
-  
+
   === Available Workflows ===
   [Dynamically list each workflow in bundle with format:
   *workflow {id}: {name}
     Purpose: {description}]
-  
-  💡 Tip: Each agent has unique tasks, templates, and checklists. Switch to an agent to access their capabilities!
 
+  💡 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
@@ -1158,6 +1157,8 @@ The questions and perspectives offered should always consider:
 ==================== START: templates#project-brief-tmpl ====================
 # Project Brief: {{Project Name}}
 
+[[LLM: The default path and filename unless specified is docs/brief.md]]
+
 [[LLM: This template guides creation of a comprehensive Project Brief that serves as the foundational input for product development.
 
 Start by asking the user which mode they prefer:
@@ -1389,6 +1390,8 @@ These replace the standard elicitation options when working on project brief doc
 ==================== START: templates#market-research-tmpl ====================
 # Market Research Report: {{Project/Product Name}}
 
+[[LLM: The default path and filename unless specified is docs/market-research.md]]
+
 [[LLM: This template guides the creation of a comprehensive market research report. Begin by understanding what market insights the user needs and why. Work through each section systematically, using the appropriate analytical frameworks based on the research objectives.]]
 
 ## Executive Summary
@@ -1653,6 +1656,8 @@ These replace the standard elicitation options when working on market research d
 ==================== START: templates#competitor-analysis-tmpl ====================
 # Competitive Analysis Report: {{Project/Product Name}}
 
+[[LLM: The default path and filename unless specified is docs/competitor-analysis.md]]
+
 [[LLM: This template guides comprehensive competitor analysis. Start by understanding the user's competitive intelligence needs and strategic objectives. Help them identify and prioritize competitors before diving into detailed analysis.]]
 
 ## Executive Summary
@@ -1984,11 +1989,13 @@ You are developing games as a "Player Experience CEO" - thinking like a game dir
 ### Phase 1: Game Concept and Design
 
 1. **Game Designer**: Start with brainstorming and concept development
-   - Use *brainstorm to explore game concepts and mechanics
+
+   - Use \*brainstorm to explore game concepts and mechanics
    - Create Game Brief using game-brief-tmpl
    - Develop core game pillars and player experience goals
 
 2. **Game Designer**: Create comprehensive Game Design Document
+
    - Use game-design-doc-tmpl to create detailed GDD
    - Define all game mechanics, progression, and balance
    - Specify technical requirements and platform targets
@@ -2008,11 +2015,13 @@ You are developing games as a "Player Experience CEO" - thinking like a game dir
 ### Phase 3: Story-Driven Development
 
 5. **Game Scrum Master**: Break down design into development stories
+
    - Use create-game-story task to create detailed implementation stories
    - Each story should be immediately actionable by game developers
    - Apply game-story-dod-checklist to ensure story quality
 
 6. **Game Developer**: Implement game features story by story
+
    - Follow TypeScript strict mode and Phaser 3 best practices
    - Maintain 60 FPS performance target throughout development
    - Use test-driven development for game logic components
@@ -2027,6 +2036,7 @@ You are developing games as a "Player Experience CEO" - thinking like a game dir
 ### Phaser 3 + TypeScript Standards
 
 **Project Structure:**
+
 ```text
 game-project/
 ├── src/
@@ -2044,12 +2054,14 @@ game-project/
 ```
 
 **Performance Requirements:**
+
 - Maintain 60 FPS on target devices
 - Memory usage under specified limits per level
 - Loading times under 3 seconds for levels
 - Smooth animation and responsive controls
 
 **Code Quality:**
+
 - TypeScript strict mode compliance
 - Component-based architecture
 - Object pooling for frequently created/destroyed objects
@@ -2058,6 +2070,7 @@ game-project/
 ### Game Development Story Structure
 
 **Story Requirements:**
+
 - Clear reference to Game Design Document section
 - Specific acceptance criteria for game functionality
 - Technical implementation details for Phaser 3
@@ -2065,6 +2078,7 @@ game-project/
 - Testing requirements including gameplay validation
 
 **Story Categories:**
+
 - **Core Mechanics**: Fundamental gameplay systems
 - **Level Content**: Individual levels and content implementation
 - **UI/UX**: User interface and player experience features
@@ -2074,6 +2088,7 @@ game-project/
 ### Quality Assurance for Games
 
 **Testing Approach:**
+
 - Unit tests for game logic (separate from Phaser)
 - Integration tests for game systems
 - Performance benchmarking and profiling
@@ -2081,6 +2096,7 @@ game-project/
 - Cross-platform compatibility testing
 
 **Performance Monitoring:**
+
 - Frame rate consistency tracking
 - Memory usage monitoring
 - Asset loading performance
@@ -2090,16 +2106,19 @@ game-project/
 ## Game Development Team Roles
 
 ### Game Designer (Alex)
+
 - **Primary Focus**: Game mechanics, player experience, design documentation
 - **Key Outputs**: Game Brief, Game Design Document, Level Design Framework
 - **Specialties**: Brainstorming, game balance, player psychology, creative direction
 
 ### Game Developer (Maya)
+
 - **Primary Focus**: Phaser 3 implementation, technical excellence, performance
 - **Key Outputs**: Working game features, optimized code, technical architecture
 - **Specialties**: TypeScript/Phaser 3, performance optimization, cross-platform development
 
 ### Game Scrum Master (Jordan)
+
 - **Primary Focus**: Story creation, development planning, agile process
 - **Key Outputs**: Detailed implementation stories, sprint planning, quality assurance
 - **Specialties**: Story breakdown, developer handoffs, process optimization
@@ -2107,18 +2126,21 @@ game-project/
 ## Platform-Specific Considerations
 
 ### Web Platform
+
 - Browser compatibility across modern browsers
 - Progressive loading for large assets
 - Touch-friendly mobile controls
 - Responsive design for different screen sizes
 
 ### Mobile Optimization
+
 - Touch gesture support and responsive controls
 - Battery usage optimization
 - Performance scaling for different device capabilities
 - App store compliance and packaging
 
 ### Performance Targets
+
 - **Desktop**: 60 FPS at 1080p resolution
 - **Mobile**: 60 FPS on mid-range devices, 30 FPS minimum on low-end
 - **Loading**: Initial load under 5 seconds, level transitions under 2 seconds
@@ -2127,18 +2149,21 @@ game-project/
 ## Success Metrics for Game Development
 
 ### Technical Metrics
+
 - Frame rate consistency (>90% of time at target FPS)
 - Memory usage within budgets
 - Loading time targets met
 - Zero critical bugs in core gameplay systems
 
 ### Player Experience Metrics
+
 - Tutorial completion rate >80%
 - Level completion rates appropriate for difficulty curve
 - Average session length meets design targets
 - Player retention and engagement metrics
 
 ### Development Process Metrics
+
 - Story completion within estimated timeframes
 - Code quality metrics (test coverage, linting compliance)
 - Documentation completeness and accuracy
@@ -2147,6 +2172,7 @@ game-project/
 ## Common Game Development Patterns
 
 ### Scene Management
+
 - Boot scene for initial setup and configuration
 - Preload scene for asset loading with progress feedback
 - Menu scene for navigation and settings
@@ -2154,18 +2180,21 @@ game-project/
 - Clean transitions between scenes with proper cleanup
 
 ### Game State Management
+
 - Persistent data (player progress, unlocks, settings)
 - Session data (current level, score, temporary state)
 - Save/load system with error recovery
 - Settings management with platform storage
 
 ### Input Handling
+
 - Cross-platform input abstraction
 - Touch gesture support for mobile
 - Keyboard and gamepad support for desktop
 - Customizable control schemes
 
 ### Performance Optimization
+
 - Object pooling for bullets, effects, enemies
 - Texture atlasing and sprite optimization
 - Audio compression and streaming

package/dist/expansion-packs/expansion-creator/agents/bmad-the-creator.txt

@@ -1742,12 +1742,13 @@ Present these numbered options to the user:
 
 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
+````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
+    - Command
 
 agent:
   name: [AGENT_NAME]
@@ -1768,7 +1769,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
@@ -1869,7 +1872,7 @@ dependencies:
     - 'materials-guide.md  # Construction materials specs'
   utils:
     - 'template-format     # For template processing'
-```
+````
 ==================== END: templates#agent-tmpl ====================
 
 ==================== START: templates#expansion-pack-plan-tmpl ====================