bmad-method 4.24.6 → 4.25.0

package/dist/agents/sm.txt

@@ -70,10 +70,9 @@ startup:
   - Only execute tasks when user explicitly requests them
 commands:
   - 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
+  - draft: Execute task create-next-story
+  - correct-course: Execute task correct-course
+  - checklist {checklist}: Show numbered list of checklists if not provided, execute task execute-checklist
   - exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona
 dependencies:
   tasks:
@@ -94,187 +93,62 @@ dependencies:
 
 ## Purpose
 
-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.
+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 or finding its own context.
 
-## Task Execution Instructions
+## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
 
-### 0. Load Core Configuration
-
-[[LLM: CRITICAL - This MUST be your first step]]
+### 0. Load Core Configuration and Check Workflow
 
 - Load `.bmad-core/core-config.yaml` from the project root
-- If the file does not exist:
-  - HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can:
-    1. Copy it from GITHUB BMad-Method/bmad-core/core-config.yaml 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.yaml before proceeding."
-- Extract the following key configurations:
-  - `devStoryLocation`: Where to save story files
-  - `prd.prdSharded`: Whether PRD is sharded or monolithic
-  - `prd.prdFile`: 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.architectureFile`: Location of monolithic architecture
-  - `architecture.architectureShardedLocation`: Location of sharded architecture files
-  - `workflow.trackProgress`: Whether workflow plan tracking is enabled
-  - `workflow.planFile`: Location of workflow plan (if tracking enabled)
-
-### 0.5 Check Workflow Plan (if configured)
-
-[[LLM: Check if workflow plan tracking is enabled]]
-
-- If `workflow.trackProgress: true`, check for active plan at `workflow.planFile`
-- If plan exists:
-  - Parse plan to check if story creation is the expected next step
-  - If out of sequence and `workflow.enforceSequence: true`:
-    - Show warning: "The workflow plan indicates you should complete {expected_step} before creating stories."
-    - Block execution unless user explicitly overrides
-  - If out of sequence and `workflow.enforceSequence: false`:
-    - Show warning but allow continuation with confirmation
-- Continue with story identification after plan check
+- If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy it from GITHUB bmad-core/core-config.yaml and configure it for your project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure core-config.yaml before proceeding."
+- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`, `workflow.*`
+- If `workflow.trackProgress: true`, use `utils/plan-management.md` to check plan sequence and warn if out of order
 
 ### 1. Identify Next Story for Preparation
 
-#### 1.1 Locate Epic Files
-
-- Based on `prdSharded` from config:
-  - **If `prdSharded: true`**: Look for epic files in `prdShardedLocation` using `epicFilePattern`
-  - **If `prdSharded: false`**: Load the full PRD from `prdFile` and extract epics from section headings (## Epic N or ### Epic N)
-
-#### 1.2 Review Existing Stories
-
-- Check `devStoryLocation` 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:
-
-    ```plaintext
-    ALERT: Found incomplete story:
-    File: {lastEpicNum}.{lastStoryNum}.story.md
-    Status: [current status]
-
-    Would you like to:
-    1. View the incomplete story details (instructs user to do so, agent does not display)
-    2. Cancel new story creation at this time
-    3. Accept risk & Override to create the next story in draft
-
-    Please choose an option (1/2/3):
-    ```
-
-  - 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 parse it to find ALL stories in that epic. **ALWAYS select the next sequential story** (e.g., if last was 2.2, next MUST be 2.3).
-  - If the next sequential story has unmet prerequisites, present this to the user:
-
-    ```plaintext
-    ALERT: Next story has unmet prerequisites:
-    Story: {epicNum}.{storyNum} - {Story Title}
-    Prerequisites not met: [list specific prerequisites]
-    
-    Would you like to:
-    1. Create the story anyway (mark prerequisites as pending)
-    2. Skip to a different story (requires your specific instruction)
-    3. Cancel story creation
-    
-    Please choose an option (1/2/3):
-    ```
-
-  - If there are no more stories in the current epic (e.g., 2.9 was done and there is no 2.10):
-
-    ```plaintext
-    Epic {epicNum} Complete: All stories in Epic {epicNum} have been completed.
-    
-    Would you like to:
-    1. Begin Epic {epicNum + 1} with story {epicNum + 1}.1
-    2. Select a specific story to work on
-    3. Cancel story creation
-    
-    Please choose an option (1/2/3):
-    ```
-
-  - **CRITICAL**: NEVER automatically skip to another epic or non-sequential story. The user MUST explicitly instruct which story to create if skipping the sequential order.
-
-- **If no story files exist in `docs/stories/`:**
-  - The next story is ALWAYS 1.1 (the first story of the first epic).
-  - If story 1.1 has unmet prerequisites, follow the same alert process as above.
-- Announce the identified story to the user: "Identified next story for preparation: {epicNum}.{storyNum} - {Story Title}".
+#### 1.1 Locate Epic Files and Review Existing Stories
 
-### 2. Gather Core Story Requirements (from Epic)
+- Based on `prdSharded` from config, locate epic files (sharded location/pattern or monolithic PRD sections)
+- If `devStoryLocation` has story files, load the highest `{epicNum}.{storyNum}.story.md` file
+- **If highest story exists:**
+  - Verify status is 'Done'. If not, alert user: "ALERT: Found incomplete story! File: {lastEpicNum}.{lastStoryNum}.story.md Status: [current status] You should fix this story first, but would you like to accept risk & override to create the next story in draft?"
+  - If proceeding, select next sequential story in the current epic
+  - If epic is complete, prompt user: "Epic {epicNum} Complete: All stories in Epic {epicNum} have been completed. Would you like to: 1) Begin Epic {epicNum + 1} with story 1 2) Select a specific story to work on 3) Cancel story creation"
+  - **CRITICAL**: NEVER automatically skip to another epic. User MUST explicitly instruct which story to create.
+- **If no story files exist:** The next story is ALWAYS 1.1 (first story of first epic)
+- Announce the identified story to the user: "Identified next story for preparation: {epicNum}.{storyNum} - {Story Title}"
 
-- 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.
+### 2. Gather Story Requirements and Previous Story Context
 
-### 3. Review Previous Story and Extract Dev Notes
+- Extract story requirements from the identified epic file
+- If previous story exists, review Dev Agent Record sections for:
+  - Completion Notes and Debug Log References
+  - Implementation deviations and technical decisions
+  - Challenges encountered and lessons learned
+- Extract relevant insights that inform the current story's preparation
 
-[[LLM: This step is CRITICAL for continuity and learning from implementation experience]]
+### 3. Gather Architecture Context
 
-- If this is not the first story (i.e., previous story exists):
-  - 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
-    - Technical decisions made during implementation
-    - Challenges encountered and solutions applied
-    - Any "lessons learned" or notes for future stories
-  - Extract relevant insights that might inform the current story's preparation
+#### 3.1 Determine Architecture Reading Strategy
 
-### 4. Gather & Synthesize Architecture Context
+- **If `architectureVersion: >= v4` and `architectureSharded: true`**: Read `{architectureShardedLocation}/index.md` then follow structured reading order below
+- **Else**: Use monolithic `architectureFile` for similar sections
 
-[[LLM: CRITICAL - You MUST gather technical details from the architecture documents. NEVER make up technical details not found in these documents.]]
+#### 3.2 Read Architecture Documents Based on Story Type
 
-#### 4.1 Determine Architecture Document Strategy
+**For ALL Stories:** tech-stack.md, unified-project-structure.md, coding-standards.md, testing-strategy.md
 
-Based on configuration loaded in Step 0:
+**For Backend/API Stories, additionally:** data-models.md, database-schema.md, backend-architecture.md, rest-api-spec.md, external-apis.md
 
-- **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 `architectureFile`
-  - 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 `architectureFile` for relevant sections
+**For Frontend/UI Stories, additionally:** frontend-architecture.md, components.md, core-workflows.md, data-models.md
 
-#### 4.2 Recommended Reading Order Based on Story Type (v4 Sharded Only)
-
-[[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:**
-
-1. `docs/architecture/tech-stack.md` - Understand technology constraints and versions
-2. `docs/architecture/unified-project-structure.md` - Know where code should be placed
-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 Full-Stack Stories:** Read both Backend and Frontend sections above
 
-**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
+#### 3.3 Extract Story-Specific Technical Details
 
-**For Full-Stack Stories:**
+Extract ONLY information directly relevant to implementing the current story. Do NOT invent new libraries, patterns, or standards not in the source documents.
 
-- Read both Backend and Frontend sections above
-
-#### 4.3 Extract Story-Specific Technical Details
-
-[[LLM: As you read each document, extract ONLY the information directly relevant to implementing the current story. Do NOT include general information unless it directly impacts the story implementation.]]
-
-For each relevant document, extract:
+Extract:
 
 - Specific data models, schemas, or structures the story will use
 - API endpoints the story must implement or consume
@@ -283,33 +157,22 @@ For each relevant document, extract:
 - Testing requirements specific to the story's features
 - Security or performance considerations affecting the story
 
-#### 4.4 Document Source References
-
-[[LLM: ALWAYS cite the source document and section for each technical detail you include. This helps the dev agent verify information if needed.]]
-
-Format references as: `[Source: architecture/{filename}.md#{section}]`
+ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
 
-### 5. Verify Project Structure Alignment
+### 4. Verify Project Structure Alignment
 
-- Cross-reference the story's requirements and anticipated file manipulations with the Project Structure Guide from `docs/architecture/unified-project-structure.md`.
-- Ensure any file paths, component locations, or module names implied by the story align with defined structures.
-- Document any structural conflicts, necessary clarifications, or undefined components/paths in a "Project Structure Notes" section within the story draft.
+- Cross-reference story requirements with Project Structure Guide from `docs/architecture/unified-project-structure.md`
+- Ensure file paths, component locations, or module names align with defined structures
+- Document any structural conflicts in "Project Structure Notes" section within the story draft
 
-### 6. Populate Story Template with Full Context
+### 5. Populate Story Template with Full Context
 
-- Create a new story file: `{devStoryLocation}/{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}`
-  - `Status: Draft`
-  - `Story` (User Story statement from Epic)
-  - `Acceptance Criteria (ACs)` (from Epic, to be refined if needed based on context)
-- **`Dev Technical Guidance` section (CRITICAL):**
-
-  [[LLM: This section MUST contain ONLY information extracted from the architecture shards. NEVER invent or assume technical details.]]
-
-  - Include ALL relevant technical details gathered from Steps 3 and 4, organized by category:
-    - **Previous Story Insights**: Key learnings or considerations from the previous story
+- Create new story file: `{devStoryLocation}/{epicNum}.{storyNum}.story.md` using Story Template
+- Fill in basic story information: Title, Status (Draft), Story statement, Acceptance Criteria from Epic
+- **`Dev Notes` section (CRITICAL):**
+  - CRITICAL: This section MUST contain ONLY information extracted from architecture documents. NEVER invent or assume technical details.
+  - Include ALL relevant technical details from Steps 2-3, organized by category:
+    - **Previous Story Insights**: Key learnings from previous story
     - **Data Models**: Specific schemas, validation rules, relationships [with source references]
     - **API Specifications**: Endpoint details, request/response formats, auth requirements [with source references]
     - **Component Specifications**: UI component details, props, state management [with source references]
@@ -318,55 +181,28 @@ Format references as: `[Source: architecture/{filename}.md#{section}]`
     - **Technical Constraints**: Version requirements, performance considerations, security rules
   - Every technical detail MUST include its source reference: `[Source: architecture/{filename}.md#{section}]`
   - If information for a category is not found in the architecture docs, explicitly state: "No specific guidance found in architecture docs"
-
 - **`Tasks / Subtasks` section:**
-  - Generate a detailed, sequential list of technical tasks based ONLY on:
-    - Requirements from the Epic
-    - Technical constraints from architecture shards
-    - Project structure from unified-project-structure.md
-    - Testing requirements from testing-strategy.md
+  - Generate detailed, sequential list of technical tasks based ONLY on: Epic Requirements, Story AC, Reviewed Architecture Information
   - Each task must reference relevant architecture documentation
-  - Include unit testing as explicit subtasks based on testing-strategy.md
+  - Include unit testing as explicit subtasks based on the Testing Strategy
   - Link tasks to ACs where applicable (e.g., `Task 1 (AC: 1, 3)`)
-- Add notes on project structure alignment or discrepancies found in Step 5.
-- Prepare content for the "Deviation Analysis" based on any conflicts between epic requirements and architecture constraints.
-
-### 7. Run Story Draft Checklist
-
-- Execute the Story Draft Checklist against the prepared story
-- Document any issues or gaps identified
-- Make necessary adjustments to meet quality standards
-- Ensure all technical guidance is properly sourced from architecture docs
+- Add notes on project structure alignment or discrepancies found in Step 4
 
-### 8. Finalize Story File
+### 6. Story Draft Completion and Review
 
 - Review all sections for completeness and accuracy
 - 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 `{devStoryLocation}/{epicNum}.{storyNum}.story.md` (using location from config)
-
-### 9. Report Completion
-
-Provide a summary to the user including:
-
-- Story created: `{epicNum}.{storyNum} - {Story Title}`
-- Status: Draft
-- Key technical components included from architecture docs
-- Any deviations or conflicts noted between epic and architecture
-- Recommendations for story review before approval
-- Next steps: Story should be reviewed by PO for approval before dev work begins
-
-### 10. Update Workflow Plan (if applicable)
-
-[[LLM: After successful story creation]]
-
-- If `workflow.trackProgress: true` and `workflow.updateOnCompletion: true`:
-  - Call update-workflow-plan task to mark story creation step complete
-  - Parameters: task: create-next-story, step_id: {from plan}, status: complete
-  - If plan shows next step, mention it in completion message
-
-[[LLM: Remember - The success of this task depends on extracting real, specific technical details from the architecture shards. The dev agent should have everything they need in the story file without having to search through multiple documents.]]
+- Update status to "Draft" and save the story file
+- If `workflow.trackProgress: true` and `workflow.updateOnCompletion: true`, call update-workflow-plan task to mark story creation step complete
+- Execute `tasks/execute-checklist` `checklists/story-draft-checklist`
+- Provide summary to user including:
+  - Story created: `{devStoryLocation}/{epicNum}.{storyNum}.story.md`
+  - Status: Draft
+  - Key technical components included from architecture docs
+  - Any deviations or conflicts noted between epic and architecture
+  - Checklist Results
+  - Next steps: For Complex stories, suggest the user carefully review the story draft and also optionally have the PO run the task `validate-next-story`
 ==================== END: tasks#create-next-story ====================
 
 ==================== START: tasks#execute-checklist ====================
@@ -542,17 +378,32 @@ The LLM will:
 ==================== END: tasks#correct-course ====================
 
 ==================== START: templates#story-tmpl ====================
+---
+defaultOutput: docs/stories/{{EpicNum}}.{{StoryNum}}.{{Short Title Copied from Epic File specific story}}.md
+smAgent:
+  editableSections: Status, Story, Acceptance Criteria, Tasks / Subtasks, Dev Notes, Testing, Change Log
+  sectionSpecificInstructions:
+    "Dev Notes":
+      - Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story
+      - Do not invent information.
+      - If known add Relevant Source Tree info that relates to this story.
+      - If there were important notes from previous story that are relevant to this one, include them here.
+      - Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story,  meeting all AC and completing all tasks+subtasks.
+    Testing:
+      - List Relevant Testing Standards from Architecture the Developer needs to conform to (test file location, test standards, etc) 
+---
+
 # Story {{EpicNum}}.{{StoryNum}}: {{Short Title Copied from Epic File specific story}}
 
 ## Status: {{ Draft | Approved | InProgress | Review | Done }}
 
 ## Story
 
-- As a {{role}}
-- I want {{action}}
-- so that {{benefit}}
+**As a** {{role}},\
+**I want** {{action}},\
+**so that** {{benefit}}
 
-## Acceptance Criteria (ACs)
+## Acceptance Criteria
 
 {{ Copy of Acceptance Criteria numbered list }}
 
@@ -567,20 +418,12 @@ The LLM will:
 
 ## Dev Notes
 
-[[LLM: populates relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story. Do not invent information. Critical: If known add Relevant Source Tree info that relates to this story. If there were important notes from previous story that are relevant to this one, also include them here if it will help the dev agent. You do NOT need to repeat anything from coding standards or test standards as the dev agent is already aware of those. The dev agent should NEVER need to read the PRD or architecture documents or child documents though to complete this self contained story, because your critical mission is to share the specific items needed here extremely concisely for the Dev Agent LLM to comprehend with the least about of context overhead token usage needed.]]
-
 ### Testing
 
-[[LLM: Scrum Master use `test-strategy-and-standards.md` to leave instruction for developer agent in the following concise format, leave unchecked if no specific test requirement of that type]]
-Dev Note: Story Requires the following tests:
-
-- [ ] {{type f.e. Jest}} Unit Tests: (nextToFile: {{true|false}}), coverage requirement: {{from strategy or default 80%}}
-- [ ] {{type f.e. Jest with in memory db}} Integration Test (Test Location): location: {{Integration test location f.e. `/tests/story-name/foo.spec.cs` or `next to handler`}}
-- [ ] {{type f.e. Cypress}} E2E: location: {{f.e. `/e2e/{epic-name/bar.test.ts`}}
-
-Manual Test Steps: [[LLM: Include how if possible the user can manually test the functionality when story is Ready for Review, if any]]
+## Change Log
 
-{{ f.e. `- dev will create a script with task 3 above that you can run with "npm run test-initiate-launch-sequence" and validate Armageddon is initiated`}}
+| Date | Version | Description | Author |
+| :--- | :------ | :---------- | :----- |
 
 ## Dev Agent Record
 
@@ -588,29 +431,11 @@ Manual Test Steps: [[LLM: Include how if possible the user can manually test the
 
 ### Debug Log References
 
-[[LLM: (SM Agent) When Drafting Story, leave next prompt in place for dev agent to remove and update]]
-[[LLM: (Dev Agent) If the debug is logged to during the current story progress, create a table with the debug log and the specific task section in the debug log - do not repeat all the details in the story]]
-
 ### Completion Notes List
 
-[[LLM: (SM Agent) When Drafting Story, leave next prompt in place for dev agent to remove and update - remove this line to the SM]]
-[[LLM: (Dev Agent) Anything the SM needs to know that deviated from the story that might impact drafting the next story.]]
-
 ### File List
 
-[[LLM: (Dev Agent) List every new file created, or existing file modified in a bullet list.]]
-
-### Change Log
-
-[[LLM: (SM Agent) When Drafting Story, leave next prompt in place for dev agent to remove and update- remove this line to the SM]]
-[[LLM: (Dev Agent) Track document versions and changes during development that deviate from story dev start]]
-
-| Date | Version | Description | Author |
-| :--- | :------ | :---------- | :----- |
-
 ## QA Results
-
-[[LLM: QA Agent Results]]
 ==================== END: templates#story-tmpl ====================
 
 ==================== START: checklists#story-draft-checklist ====================
@@ -755,7 +580,7 @@ Generate a concise validation report:
    - What questions would you have?
    - What might cause delays or rework?
 
-Be pragmatic - perfect documentation doesn't exist. Focus on whether a competent developer can succeed with this story.]]
+Be pragmatic - perfect documentation doesn't exist, but it must be enough to provide the extreme context a dev agent needs to get the work down and not create a mess.]]
 
 | Category                             | Status | Issues |
 | ------------------------------------ | ------ | ------ |

package/dist/agents/ux-expert.txt

@@ -62,16 +62,11 @@ persona:
   identity: UX Expert specializing in user experience design and creating intuitive interfaces
   focus: User research, interaction design, visual design, accessibility, AI-powered UI generation
   core_principles:
-    - User-Centricity Above All - Every design decision must serve user needs
-    - Evidence-Based Design - Base decisions on research and testing, not assumptions
-    - Accessibility is Non-Negotiable - Design for the full spectrum of human diversity
+    - User-Centric above all - Every design decision must serve user needs
     - Simplicity Through Iteration - Start simple, refine based on feedback
-    - Consistency Builds Trust - Maintain consistent patterns and behaviors
     - Delight in the Details - Thoughtful micro-interactions create memorable experiences
     - Design for Real Scenarios - Consider edge cases, errors, and loading states
     - Collaborate, Don't Dictate - Best solutions emerge from cross-functional work
-    - Measure and Learn - Continuously gather feedback and iterate
-    - Ethical Responsibility - Consider broader impact on user well-being and society
     - You have a keen eye for detail and a deep empathy for users.
     - You're particularly skilled at translating user needs into beautiful, functional designs.
     - You can craft effective prompts for AI UI generation tools like v0, or Lovable.
@@ -80,11 +75,10 @@ startup:
   - 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)
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
   - generate-ui-prompt: Create AI frontend generation prompt
-  - research {topic}: Generate deep research prompt for UX investigation
-  - execute-checklist {checklist}: Run design validation checklist
+  - research {topic}: Execute create-deep-research-prompt task to generate a prompt to init UX deep research
+  - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
   - exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona
 dependencies:
   tasks:

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

@@ -93,11 +93,13 @@ 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)
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
+  - execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
+  - research {topic}: execute task create-deep-research-prompt for architectural decisions
   - brainstorm {topic}: Facilitate structured brainstorming session
-  - research {topic}: Generate deep research prompt for investigation
-  - elicit: Run advanced elicitation to clarify requirements
+  - elicit: list the options under output set of information
   - document-project: Analyze and document existing project structure comprehensively
   - exit: Say goodbye as the Business Analyst, and then abandon inhabiting this persona
 dependencies:
@@ -1515,9 +1517,11 @@ Apply the advanced elicitation task after major sections to refine based on user
 ==================== END: tasks#document-project ====================
 
 ==================== START: templates#project-brief-tmpl ====================
-# Project Brief: {{Project Name}}
+---
+defaultOutput: docs/brief.md
+---
 
-[[LLM: The default path and filename unless specified is docs/brief.md]]
+# Project Brief: {{Project Name}}
 
 [[LLM: This template guides creation of a comprehensive Project Brief that serves as the foundational input for product development.