chore(release): 4.26.0 [skip ci]

# [4.26.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.25.1...v4.26.0) (2025-07-06)

### Features

* **trae:** add support for trae ide integration ([#298](https://github.com/bmadcode/BMAD-METHOD/issues/298)) ([fae0f5f](fae0f5ff73))

.gitignore

@@ -21,6 +21,8 @@ CLAUDE.md
 test-project-install/*
 sample-project/*
 .claude
+.windsurf/
+.trae/
 .bmad-core
 .bmad-creator-tools
 .gemini

.vscode/settings.json

@@ -7,7 +7,42 @@
   "chat.tools.autoApprove": false,
   "cSpell.words": [
     "Agentic",
+    "atlasing",
+    "Biostatistician",
+    "Cordova",
+    "customresourcedefinitions",
+    "dashboarded",
+    "Decisioning",
+    "eksctl",
     "elicitations",
-    "Shardable"
+    "filecomplete",
+    "fintech",
+    "fluxcd",
+    "gamedev",
+    "gitops",
+    "implementability",
+    "inclusivity",
+    "ingressgateway",
+    "istioctl",
+    "metroidvania",
+    "NACLs",
+    "nodegroup",
+    "platformconfigs",
+    "Playfocus",
+    "playtesting",
+    "pointerdown",
+    "pointerup",
+    "replayability",
+    "roguelike",
+    "roomodes",
+    "Runbook",
+    "runbooks",
+    "Shardable",
+    "Softlock",
+    "speedrunner",
+    "tekton",
+    "tilemap",
+    "tileset",
+    "VNET"
   ]
 }

CHANGELOG.md

@@ -1,3 +1,36 @@
+# [4.26.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.25.1...v4.26.0) (2025-07-06)
+
+
+### Features
+
+* **trae:** add support for trae ide integration ([#298](https://github.com/bmadcode/BMAD-METHOD/issues/298)) ([fae0f5f](https://github.com/bmadcode/BMAD-METHOD/commit/fae0f5ff73a603dc1aacc29f184e2a4138446524))
+
+## [4.25.1](https://github.com/bmadcode/BMAD-METHOD/compare/v4.25.0...v4.25.1) (2025-07-06)
+
+
+### Bug Fixes
+
+* spelling errors in documentation. ([#297](https://github.com/bmadcode/BMAD-METHOD/issues/297)) ([47b9d9f](https://github.com/bmadcode/BMAD-METHOD/commit/47b9d9f3e87be62c8520ed6cb0048df727a9534f))
+
+# [4.25.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.24.6...v4.25.0) (2025-07-05)
+
+
+### Bug Fixes
+
+* update web bundles ([42684e6](https://github.com/bmadcode/BMAD-METHOD/commit/42684e68af4396797962f3f851147523a6741608))
+
+
+### Features
+
+* improvements to agent task usage, sm story drafting, dev implementation, qa review process, and addition of a new sm independant review of a draft story ([2874a54](https://github.com/bmadcode/BMAD-METHOD/commit/2874a54a9b25b48c199b2e9dc63a9555e716c636))
+
+## [4.24.6](https://github.com/bmadcode/BMAD-METHOD/compare/v4.24.5...v4.24.6) (2025-07-04)
+
+
+### Bug Fixes
+
+* version bump and web build fix ([1c845e5](https://github.com/bmadcode/BMAD-METHOD/commit/1c845e5b2c77a77d887d8216152ba09110c72e40))
+
 ## [4.24.5](https://github.com/bmadcode/BMAD-METHOD/compare/v4.24.4...v4.24.5) (2025-07-04)
 
 

README.md

@@ -155,6 +155,7 @@ The BMad Method works with any IDE, but has built-in integration for:
 - `cline` - Cline Rules integration
 - `gemini-cli` - Gemini with @agent commands
 - `windsurf` - Windsurf with manual rule @agent commands
+- `trae` - Trae with manual rule @agent commands
 - `roo` - Roo Code with custom modes (see `.roomodes`)
 - `github-copilot` - GitHub Copilot agent mode integration
 
@@ -287,6 +288,7 @@ See the **[Core Architecture](docs/core-architecture.md)** for the complete sour
 - 🎯 [Cursor Guide](docs/agentic-tools/cursor-guide.md) - Setup and usage for Cursor
 - 🤖 [Claude Code Guide](docs/agentic-tools/claude-code-guide.md) - Setup and usage for Claude Code
 - 🌊 [Windsurf Guide](docs/agentic-tools/windsurf-guide.md) - Setup and usage for Windsurf
+- 🌊 [Trae Guide](docs/agentic-tools/trae-guide.md) - Setup and usage for Trae
 - 🦘 [Roo Code Guide](docs/agentic-tools/roo-code-guide.md) - Setup and usage for Roo Code
 - 🔧 [Cline Guide](docs/agentic-tools/cline-guide.md) - Setup and usage for Cline (VS Code)
 - ✨ [Gemini CLI Guide](docs/agentic-tools/gemini-cli-guide.md) - Setup and usage for Gemini CLI
@@ -381,6 +383,7 @@ Want to help improve the BMad Method. Fork n' Clone the repo
 git clone https://github.com/bmadcode/bmad-method.git
 cd bmad-method
 
+npm install
 npm run build # rebuild the dist folder
 npm run install:bmad # build and install all to a destination folder
 ```

bmad-core/agents/analyst.md

@@ -37,13 +37,16 @@ persona:
     - 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:  # All commands require * prefix when used (e.g., *help)
+# All commands require * prefix when used (e.g., *help)
+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:

bmad-core/agents/architect.md

@@ -37,12 +37,14 @@ persona:
 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:  # All commands require * prefix when used (e.g., *help)
+# All commands require * prefix when used (e.g., *help)
+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
+  - 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
   - exit: Say goodbye as the Architect, and then abandon inhabiting this persona
 dependencies:
   tasks:

bmad-core/agents/bmad-master.md

@@ -21,36 +21,33 @@ persona:
     - 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
+    - Track execution state and guide multi-step plans
     - Use numbered lists for choices
-    - Process (*) commands immediately
+    - Process (*) commands immediately, All commands require * prefix when used (e.g., *help)
 startup:
   - Greet the user with your name and role, and inform of the *help command.
-  - Check for active workflow plan using utils#plan-management
-  - "If plan exists: Show brief status - Active plan detected: {workflow} - {progress}%"
-  - "If plan exists: Suggest next step based on plan"
-  - CRITICAL: Do NOT scan filesystem or load any resources during startup
+  - Check for active workflow plan using the utils plan-management
+  - If plan exists: Show brief status - Active plan {workflow} in progress
+  - If plan exists: Suggest next step based on plan
+  - CRITICAL: Do NOT scan filesystem or load any resources during startup, ONLY when commanded
   - 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:  # All commands require * prefix when used (e.g., *help)
-  - help: Show commands
-  - chat: Advanced elicitation + KB mode
-  - status: Current context
-  - task {template|util|checklist|workflow}: Execute
-  - list {task|template|util|checklist|workflow}: List resources by type
-  - plan: Create workflow plan (for complex projects)
+
+commands:
+  - help: Show these listed commands in a numbered list
+  - kb: Toggle KB mode off (default) or on, when on will load and reference the data/bmad-kb and converse with the user answering his questions with this informational resource
+  - task {task}: Execute task, if not found or none specified, ONLY list available dependencies/tasks listed below
+  - list {task|template|util|checklist|workflow}: List resources by type ONLY from the corresponding dependencies sub item below
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - execute-checklist {checklist}: Run task execute-checklist (no checklist = ONLY show available checklists listed under dependencies/checklist below)
+  - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
+  - plan: Execute the task Create workflow plan
   - plan-status: Show current workflow plan progress
   - plan-update: Update workflow plan status
+  - yolo: Toggle Yolo Mode off (default) abd on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
   - exit: Exit (confirm)
-  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
-  - doc-out: Output full document
-fuzzy-matching:
-  - 85% confidence threshold
-  - Show numbered list if unsure
 workflow-guidance:
-  - When user asks about workflows, offer: "Would you like me to create a workflow plan first? (*plan)"
+  - When user asks about workflows, offer: "(Experimental-Feature) Would you like me to create a workflow plan first? (*plan)"
   - For complex projects, suggest planning before execution
   - Plan command maps to create-workflow-plan task
 execution:
@@ -65,7 +62,6 @@ dependencies:
     - brainstorming-techniques
     - brownfield-create-epic
     - brownfield-create-story
-    - core-dump
     - correct-course
     - create-deep-research-prompt
     - create-doc
@@ -78,7 +74,6 @@ dependencies:
     - shard-doc
     - update-workflow-plan
   templates:
-    - agent-tmpl
     - architecture-tmpl
     - brownfield-architecture-tmpl
     - brownfield-prd-tmpl

bmad-core/agents/dev.md

@@ -16,10 +16,9 @@ agent:
 
 startup:
   - Announce: Greet the user with your name and role, and inform of the *help command.
-  - CRITICAL: Load .bmad-core/core-config.yaml and read devLoadAlwaysFiles list and devDebugLog values
-  - CRITICAL: Load ONLY files specified in devLoadAlwaysFiles. If any missing, inform user but continue
-  - CRITICAL: Do NOT load any story files during startup unless user requested you do
-  - CRITICAL: Do NOT begin development until told to proceed
+  - CRITICAL: Read the following full files as these are your explicit rules for development standards for this project - {root}/core-config.yaml devLoadAlwaysFiles list
+  - CRITICAL: Do NOT load any other files during startup aside from the assigned story and devLoadAlwaysFiles items, unless user requested you do or the following contradicts
+  - CRITICAL: Do NOT begin development until a story is not in draft mode and you are told to proceed
 
 persona:
   role: Expert Senior Software Engineer & Implementation Specialist
@@ -28,38 +27,31 @@ persona:
   focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
 
 core_principles:
-  - CRITICAL: Story-Centric - Story has ALL info. NEVER load PRD/architecture/other docs files unless explicitly directed in dev notes
-  - CRITICAL: Dev Record Only - ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
-  - Strive for Sequential Task Execution - Complete tasks 1-by-1 and mark [x] as completed
-  - Test-Driven Quality - Write tests alongside code. Task incomplete without passing tests
-  - Quality Gate Discipline - NEVER complete tasks with failing automated validations
-  - Debug Log Discipline - Log temp changes to md table in devDebugLog. Revert after fix.
-  - Block Only When Critical - HALT for: missing approval/ambiguous reqs/3 failures/missing config
-  - Code Excellence - Clean, secure, maintainable code per loaded standards
-  - Numbered Options - Always use numbered lists when presenting choices
+  - CRITICAL: Story has ALL info you will need aside from what you loaded during the startup commands. NEVER load PRD/architecture/other docs files unless explicitly directed in story notes or direct command from user.
+  - CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
+  - CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
+  - Numbered Options - Always use numbered lists when presenting choices to the user
 
-commands:  # All commands require * prefix when used (e.g., *help)
+# All commands require * prefix when used (e.g., *help)
+commands:  
   - help: Show numbered list of the following commands to allow selection
   - run-tests: Execute linting and tests
-  - debug-log: Show debug entries
-  - complete-story: Finalize to "Review"
+  - explain: teach me what and why you did whatever you just did in detail so I can learn. Explain to me as if you were training a junior engineer.
   - exit: Say goodbye as the Developer, and then abandon inhabiting this persona
-
-task-execution:
-  flow: "Read task→Implement→Write tests→Execute validations→Only if ALL pass→Update [x]→Next task"
-  updates-ONLY:
-    - "Checkboxes: [ ] not started | [-] in progress | [x] complete"
-    - "Debug Log: | Task | File | Change | Reverted? |"
-    - "Completion Notes: Deviations from AC or tasks during execution only, <50 words"
-    - "Change Log: Requirement changes only"
-    - "File List: CRITICAL - Maintain complete list of ALL files created/modified during implementation"
-  blocking: "Unapproved deps | Ambiguous after story check | 3 failures | Missing config | Failing validations"
-  done: "Code matches reqs + All validations pass + Follows standards + File List complete"
-  completion: "All [x]→Validations pass→Integration(if noted)→E2E(if noted)→DoD→Update File List→Mark Ready for Review→HALT"
+develop-story:
+  order-of-execution: "Read (first or next) task→Implement Task and its subtasks→Write tests→Execute validations→Only if ALL pass, then update the task checkbox with [x]→Update story section File List to ensure it lists and new or modified or deleted source file→repeat order-of-execution until complete"
+  story-file-updates-ONLY:
+    - CRITICAL: ONLY UPDATE THE STORY FILE WITH UPDATES TO SECTIONS INDICATED BELOW. DO NOT MODIFY ANY OTHER SECTIONS.
+    - CRITICAL: You are ONLY authorized to edit these specific sections of story files - Tasks / Subtasks Checkboxes, Dev Agent Record section and all its subsections, Agent Model Used, Debug Log References, Completion Notes List, File List, Change Log, Status
+    - CRITICAL: DO NOT modify Status, Story, Acceptance Criteria, Dev Notes, Testing sections, or any other sections not listed above
+  blocking: "HALT for: Unapproved deps needed, confirm with user | Ambiguous after story check | 3 failures attempting to implement or fix something repeatedly | Missing config | Failing regression"
+  ready-for-review: "Code matches requirements + All validations pass + Follows standards + File List complete"
+  completion: "All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON'T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: 'Ready for Review'→HALT"
 
 dependencies:
   tasks:
     - execute-checklist
+    - validate-next-story
   checklists:
     - story-dod-checklist
 ```

bmad-core/agents/pm.md

@@ -34,11 +34,13 @@ persona:
     - Strategic thinking & outcome-oriented
 startup:
   - Greet the user with your name and role, and inform of the *help command.
-commands:  # All commands require * prefix when used (e.g., *help)
+# All commands require * prefix when used (e.g., *help)
+commands:  
   - help: Show numbered list of the following commands to allow selection
-  - chat-mode: (Default) Deep conversation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - exit: Say goodbye as the PM, and then abandon inhabiting this persona
+  - 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
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - create-doc

bmad-core/agents/po.md

@@ -36,16 +36,19 @@ persona:
     - Documentation Ecosystem Integrity - Maintain consistency across all documents
 startup:
   - Greet the user with your name and role, and inform of the *help command.
-commands:  # All commands require * prefix when used (e.g., *help)
+# All commands require * prefix when used (e.g., *help)
+commands:  
   - help: Show numbered list of the following commands to allow selection
-  - chat-mode: (Default) Product Owner consultation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - execute-checklist {checklist}: Run validation checklist (default->po-master-checklist)
-  - shard-doc {document}: Break down document into actionable parts
-  - correct-course: Analyze and suggest project course corrections
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
+  - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
+  - correct-course: execute the correct-course task
   - create-epic: Create epic for brownfield projects (task brownfield-create-epic)
   - create-story: Create user story from requirements (task brownfield-create-story)
-  - exit: Say goodbye as the Product Owner, and then abandon inhabiting this persona
+  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
+  - validate-story-draft {story}: run the task validate-next-story against the provided story file
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - execute-checklist
@@ -53,6 +56,7 @@ dependencies:
     - correct-course
     - brownfield-create-epic
     - brownfield-create-story
+    - validate-next-story
   templates:
     - story-tmpl
   checklists:

bmad-core/agents/qa.md

@@ -36,10 +36,16 @@ persona:
     - Architecture & Design Patterns - Ensure proper patterns and maintainable code structure
 startup:
   - Greet the user with your name and role, and inform of the *help command.
-commands:  # All commands require * prefix when used (e.g., *help)
+story-file-permissions:
+  - CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files
+  - CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections
+  - CRITICAL: Your updates must be limited to appending your review results in the QA Results section only
+# All commands require * prefix when used (e.g., *help)
+commands:  
   - help: Show numbered list of the following commands to allow selection
-  - chat-mode: (Default) QA consultation with advanced-elicitation for test strategy
-  - exit: Say goodbye as the QA Test Architect, and then abandon inhabiting this persona
+  - review {story}: execute the task review-story for the highest sequence story in docs/stories unless another is specified - keep any specified technical-preferences in mind as needed
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
 dependencies:
   tasks:
     - review-story

bmad-core/agents/sm.md

@@ -30,18 +30,18 @@ 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
-commands:  # All commands require * prefix when used (e.g., *help)
+# All commands require * prefix when used (e.g., *help)
+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:
     - create-next-story
     - execute-checklist
-    - course-correct
+    - correct-course
   templates:
     - story-tmpl
   checklists:

bmad-core/agents/ux-expert.md

@@ -24,29 +24,24 @@ 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.
 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:  # All commands require * prefix when used (e.g., *help)
+# All commands require * prefix when used (e.g., *help)
+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:

bmad-core/checklists/story-draft-checklist.md

@@ -139,7 +139,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 |
 | ------------------------------------ | ------ | ------ |

bmad-core/core-config.yaml

@@ -1,4 +1,4 @@
-version: 4.22.0
+version: 4.25.0
 markdownExploder: true
 prd:
   prdFile: docs/prd.md

bmad-core/data/bmad-kb.md

@@ -78,7 +78,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 5. Type `/help` to see available commands
 
 #### Option 2: IDE Integration
-**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -91,6 +91,7 @@ npx bmad-method install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
+  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **Github Copilot**: AI-powered coding assistant
@@ -278,11 +279,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:
@@ -362,7 +364,7 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
 
 #### Web UI Environment
 
-- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assest with an orchestrating agent
+- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assets with an orchestrating agent
 - Single text files containing all agent dependencies are in `dist/agents/` - these are unnecessary unless you want to create a web agent that is only a single agent and not a team
 - Created by the web-builder tool for upload to web interfaces
 - Provides complete context in one package

bmad-core/tasks/create-next-story.md

@@ -2,187 +2,62 @@
 
 ## 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
+#### 1.1 Locate Epic Files and Review Existing Stories
 
-- 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)
+- 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}"
 
-#### 1.2 Review Existing Stories
+### 2. Gather Story Requirements and Previous Story Context
 
-- 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:
+- 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
 
-    ```plaintext
-    ALERT: Found incomplete story:
-    File: {lastEpicNum}.{lastStoryNum}.story.md
-    Status: [current status]
+### 3. Gather Architecture Context
 
-    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
+#### 3.1 Determine Architecture Reading Strategy
 
-    Please choose an option (1/2/3):
-    ```
+- **If `architectureVersion: >= v4` and `architectureSharded: true`**: Read `{architectureShardedLocation}/index.md` then follow structured reading order below
+- **Else**: Use monolithic `architectureFile` for similar sections
 
-  - 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:
+#### 3.2 Read Architecture Documents Based on Story Type
 
-    ```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):
-    ```
+**For ALL Stories:** tech-stack.md, unified-project-structure.md, coding-standards.md, testing-strategy.md
 
-  - If there are no more stories in the current epic (e.g., 2.9 was done and there is no 2.10):
+**For Backend/API Stories, additionally:** data-models.md, database-schema.md, backend-architecture.md, rest-api-spec.md, external-apis.md
 
-    ```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):
-    ```
+**For Frontend/UI Stories, additionally:** frontend-architecture.md, components.md, core-workflows.md, data-models.md
 
-  - **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.
+**For Full-Stack Stories:** Read both Backend and Frontend sections above
 
-- **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}".
+#### 3.3 Extract Story-Specific Technical Details
 
-### 2. Gather Core Story Requirements (from Epic)
+Extract ONLY information directly relevant to implementing the current story. Do NOT invent new libraries, patterns, or standards not in the source documents.
 
-- 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.
-
-### 3. Review Previous Story and Extract Dev Notes
-
-[[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 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
-
-### 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.]]
-
-#### 4.1 Determine Architecture Document Strategy
-
-Based on configuration loaded in Step 0:
-
-- **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
-
-#### 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 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:**
-
-- 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
@@ -191,33 +66,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
+ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
 
-[[LLM: ALWAYS cite the source document and section for each technical detail you include. This helps the dev agent verify information if needed.]]
+### 4. Verify Project Structure Alignment
 
-Format references as: `[Source: architecture/{filename}.md#{section}]`
+- 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
 
-### 5. Verify Project Structure Alignment
+### 5. Populate Story Template with Full Context
 
-- 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.
-
-### 6. 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]
@@ -226,52 +90,25 @@ 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.
+- Add notes on project structure alignment or discrepancies found in Step 4
 
-### 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
-
-### 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`

bmad-core/tasks/review-story.md

@@ -17,11 +17,19 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
    - Understand the dev notes and requirements
    - Note any completion notes from the developer
 
-2. **Focus on the File List**
+2. **Verify Implementation Against Dev Notes Guidance**
+   - Review the "Dev Notes" section for specific technical guidance provided to the developer
+   - Verify the developer's implementation follows the architectural patterns specified in Dev Notes
+   - Check that file locations match the project structure guidance in Dev Notes
+   - Confirm any specified libraries, frameworks, or technical approaches were used correctly
+   - Validate that security considerations mentioned in Dev Notes were implemented
+
+3. **Focus on the File List**
    - Verify all files listed were actually created/modified
    - Check for any missing files that should have been updated
+   - Ensure file locations align with the project structure guidance from Dev Notes
 
-3. **Senior Developer Code Review**
+4. **Senior Developer Code Review**
    - Review code with the eye of a senior developer
    - If changes form a cohesive whole, review them together
    - If changes are independent, review incrementally file by file
@@ -33,7 +41,7 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
      - Security concerns
      - Best practices and patterns
 
-4. **Active Refactoring**
+5. **Active Refactoring**
    - As a senior developer, you CAN and SHOULD refactor code where improvements are needed
    - When refactoring:
      - Make the changes directly in the files
@@ -42,30 +50,32 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
      - Ensure all tests still pass after refactoring
      - Update the File List if you modify additional files
 
-5. **Standards Compliance Check**
+6. **Standards Compliance Check**
    - Verify adherence to `docs/coding-standards.md`
    - Check compliance with `docs/unified-project-structure.md`
    - Validate testing approach against `docs/testing-strategy.md`
    - Ensure all guidelines mentioned in the story are followed
 
-6. **Acceptance Criteria Validation**
+7. **Acceptance Criteria Validation**
    - Verify each AC is fully implemented
    - Check for any missing functionality
    - Validate edge cases are handled
 
-7. **Test Coverage Review**
+8. **Test Coverage Review**
    - Ensure unit tests cover edge cases
    - Add missing tests if critical coverage is lacking
    - Verify integration tests (if required) are comprehensive
    - Check that test assertions are meaningful
    - Look for missing test scenarios
 
-8. **Documentation and Comments**
+9. **Documentation and Comments**
    - Verify code is self-documenting where possible
    - Add comments for complex logic if missing
    - Ensure any API changes are documented
 
-## Append Results to Story File
+## Update Story File - QA Results Section ONLY
+
+**CRITICAL**: You are ONLY authorized to update the "QA Results" section of the story file. DO NOT modify any other sections.
 
 After review and any refactoring, append your results to the story file in the QA Results section:
 

bmad-core/tasks/validate-next-story.md

@@ -0,0 +1,134 @@
+# Validate Next Story Task
+
+## Purpose
+
+To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
+
+## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
+
+### 0. Load Core Configuration and Inputs
+
+- 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 validation."
+- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
+- Identify and load the following inputs:
+  - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
+  - **Parent epic**: The epic containing this story's requirements
+  - **Architecture documents**: Based on configuration (sharded or monolithic)
+  - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
+
+### 1. Template Completeness Validation
+
+- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
+- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
+- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
+- **Agent section verification**: Confirm all sections from template exist for future agent use
+- **Structure compliance**: Verify story follows template structure and formatting
+
+### 2. File Structure and Source Tree Validation
+
+- **File paths clarity**: Are new/existing files to be created/modified clearly specified?
+- **Source tree relevance**: Is relevant project structure included in Dev Notes?
+- **Directory structure**: Are new directories/components properly located according to project structure?
+- **File creation sequence**: Do tasks specify where files should be created in logical order?
+- **Path accuracy**: Are file paths consistent with project structure from architecture docs?
+
+### 3. UI/Frontend Completeness Validation (if applicable)
+
+- **Component specifications**: Are UI components sufficiently detailed for implementation?
+- **Styling/design guidance**: Is visual implementation guidance clear?
+- **User interaction flows**: Are UX patterns and behaviors specified?
+- **Responsive/accessibility**: Are these considerations addressed if required?
+- **Integration points**: Are frontend-backend integration points clear?
+
+### 4. Acceptance Criteria Satisfaction Assessment
+
+- **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
+- **AC testability**: Are acceptance criteria measurable and verifiable?
+- **Missing scenarios**: Are edge cases or error conditions covered?
+- **Success definition**: Is "done" clearly defined for each AC?
+- **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
+
+### 5. Validation and Testing Instructions Review
+
+- **Test approach clarity**: Are testing methods clearly specified?
+- **Test scenarios**: Are key test cases identified?
+- **Validation steps**: Are acceptance criteria validation steps clear?
+- **Testing tools/frameworks**: Are required testing tools specified?
+- **Test data requirements**: Are test data needs identified?
+
+### 6. Security Considerations Assessment (if applicable)
+
+- **Security requirements**: Are security needs identified and addressed?
+- **Authentication/authorization**: Are access controls specified?
+- **Data protection**: Are sensitive data handling requirements clear?
+- **Vulnerability prevention**: Are common security issues addressed?
+- **Compliance requirements**: Are regulatory/compliance needs addressed?
+
+### 7. Tasks/Subtasks Sequence Validation
+
+- **Logical order**: Do tasks follow proper implementation sequence?
+- **Dependencies**: Are task dependencies clear and correct?
+- **Granularity**: Are tasks appropriately sized and actionable?
+- **Completeness**: Do tasks cover all requirements and acceptance criteria?
+- **Blocking issues**: Are there any tasks that would block others?
+
+### 8. Anti-Hallucination Verification
+
+- **Source verification**: Every technical claim must be traceable to source documents
+- **Architecture alignment**: Dev Notes content matches architecture specifications
+- **No invented details**: Flag any technical decisions not supported by source documents
+- **Reference accuracy**: Verify all source references are correct and accessible
+- **Fact checking**: Cross-reference claims against epic and architecture documents
+
+### 9. Dev Agent Implementation Readiness
+
+- **Self-contained context**: Can the story be implemented without reading external docs?
+- **Clear instructions**: Are implementation steps unambiguous?
+- **Complete technical context**: Are all required technical details present in Dev Notes?
+- **Missing information**: Identify any critical information gaps
+- **Actionability**: Are all tasks actionable by a development agent?
+
+### 10. Generate Validation Report
+
+Provide a structured validation report including:
+
+#### Template Compliance Issues
+
+- Missing sections from story template
+- Unfilled placeholders or template variables
+- Structural formatting issues
+
+#### Critical Issues (Must Fix - Story Blocked)
+
+- Missing essential information for implementation
+- Inaccurate or unverifiable technical claims
+- Incomplete acceptance criteria coverage
+- Missing required sections
+
+#### Should-Fix Issues (Important Quality Improvements)
+
+- Unclear implementation guidance
+- Missing security considerations
+- Task sequencing problems
+- Incomplete testing instructions
+
+#### Nice-to-Have Improvements (Optional Enhancements)
+
+- Additional context that would help implementation
+- Clarifications that would improve efficiency
+- Documentation improvements
+
+#### Anti-Hallucination Findings
+
+- Unverifiable technical claims
+- Missing source references
+- Inconsistencies with architecture documents
+- Invented libraries, patterns, or standards
+
+#### Final Assessment
+
+- **GO**: Story is ready for implementation
+- **NO-GO**: Story requires fixes before implementation
+- **Implementation Readiness Score**: 1-10 scale
+- **Confidence Level**: High/Medium/Low for successful implementation

bmad-core/templates/project-brief-tmpl.md

@@ -1,6 +1,8 @@
-# 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.
 

bmad-core/templates/story-tmpl.md

@@ -1,14 +1,29 @@
+---
+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 }}
 
@@ -23,20 +38,12 @@
 
 ## 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:
+## Change Log
 
-- [ ] {{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]]
-
-{{ 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
 
@@ -44,26 +51,8 @@ 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]]

dist/agents/analyst.txt

@@ -77,11 +77,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:
@@ -1157,9 +1159,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.
 
@@ -2030,7 +2034,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 5. Type `/help` to see available commands
 
 #### Option 2: IDE Integration
-**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -2043,6 +2047,7 @@ npx bmad-method install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
+  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **Github Copilot**: AI-powered coding assistant
@@ -2230,11 +2235,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:
@@ -2314,7 +2320,7 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
 
 #### Web UI Environment
 
-- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assest with an orchestrating agent
+- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assets with an orchestrating agent
 - Single text files containing all agent dependencies are in `dist/agents/` - these are unnecessary unless you want to create a web agent that is only a single agent and not a team
 - Created by the web-builder tool for upload to web interfaces
 - Provides complete context in one package

dist/agents/architect.txt

@@ -77,10 +77,11 @@ startup:
   - 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
+  - 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
   - exit: Say goodbye as the Architect, and then abandon inhabiting this persona
 dependencies:
   tasks:

dist/agents/bmad-master.txt

@@ -59,36 +59,32 @@ persona:
     - 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
+    - Track execution state and guide multi-step plans
     - Use numbered lists for choices
-    - Process (*) commands immediately
+    - Process (*) commands immediately, All commands require * prefix when used (e.g., *help)
 startup:
   - Greet the user with your name and role, and inform of the *help command.
-  - Check for active workflow plan using utils#plan-management
-  - 'If plan exists: Show brief status - Active plan detected: {workflow} - {progress}%'
-  - 'If plan exists: Suggest next step based on plan'
-  - CRITICAL: Do NOT scan filesystem or load any resources during startup
+  - Check for active workflow plan using the utils plan-management
+  - If plan exists: Show brief status - Active plan {workflow} in progress
+  - If plan exists: Suggest next step based on plan
+  - CRITICAL: Do NOT scan filesystem or load any resources during startup, ONLY when commanded
   - 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}: Execute
-  - list {task|template|util|checklist|workflow}: List resources by type
-  - plan: Create workflow plan (for complex projects)
+  - help: Show these listed commands in a numbered list
+  - kb: Toggle KB mode off (default) or on, when on will load and reference the data/bmad-kb and converse with the user answering his questions with this informational resource
+  - task {task}: Execute task, if not found or none specified, ONLY list available dependencies/tasks listed below
+  - list {task|template|util|checklist|workflow}: List resources by type ONLY from the corresponding dependencies sub item below
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - execute-checklist {checklist}: Run task execute-checklist (no checklist = ONLY show available checklists listed under dependencies/checklist below)
+  - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
+  - plan: Execute the task Create workflow plan
   - plan-status: Show current workflow plan progress
   - plan-update: Update workflow plan status
+  - yolo: Toggle Yolo Mode off (default) abd on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
   - exit: Exit (confirm)
-  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
-  - doc-out: Output full document
-fuzzy-matching:
-  - 85% confidence threshold
-  - Show numbered list if unsure
 workflow-guidance:
-  - When user asks about workflows, offer: Would you like me to create a workflow plan first? (*plan)
+  - When user asks about workflows, offer: (Experimental-Feature) Would you like me to create a workflow plan first? (*plan)
   - For complex projects, suggest planning before execution
   - Plan command maps to create-workflow-plan task
 execution:
@@ -103,7 +99,6 @@ dependencies:
     - brainstorming-techniques
     - brownfield-create-epic
     - brownfield-create-story
-    - core-dump
     - correct-course
     - create-deep-research-prompt
     - create-doc
@@ -116,7 +111,6 @@ dependencies:
     - shard-doc
     - update-workflow-plan
   templates:
-    - agent-tmpl
     - architecture-tmpl
     - brownfield-architecture-tmpl
     - brownfield-prd-tmpl
@@ -1892,187 +1886,62 @@ Apply the advanced elicitation task after major sections to refine based on user
 
 ## 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
+#### 1.1 Locate Epic Files and Review Existing Stories
 
-- 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)
+- 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}"
 
-#### 1.2 Review Existing Stories
+### 2. Gather Story Requirements and Previous Story Context
 
-- 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:
+- 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
 
-    ```plaintext
-    ALERT: Found incomplete story:
-    File: {lastEpicNum}.{lastStoryNum}.story.md
-    Status: [current status]
+### 3. Gather Architecture Context
 
-    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
+#### 3.1 Determine Architecture Reading Strategy
 
-    Please choose an option (1/2/3):
-    ```
+- **If `architectureVersion: >= v4` and `architectureSharded: true`**: Read `{architectureShardedLocation}/index.md` then follow structured reading order below
+- **Else**: Use monolithic `architectureFile` for similar sections
 
-  - 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:
+#### 3.2 Read Architecture Documents Based on Story Type
 
-    ```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):
-    ```
+**For ALL Stories:** tech-stack.md, unified-project-structure.md, coding-standards.md, testing-strategy.md
 
-  - If there are no more stories in the current epic (e.g., 2.9 was done and there is no 2.10):
+**For Backend/API Stories, additionally:** data-models.md, database-schema.md, backend-architecture.md, rest-api-spec.md, external-apis.md
 
-    ```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):
-    ```
+**For Frontend/UI Stories, additionally:** frontend-architecture.md, components.md, core-workflows.md, data-models.md
 
-  - **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.
+**For Full-Stack Stories:** Read both Backend and Frontend sections above
 
-- **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}".
+#### 3.3 Extract Story-Specific Technical Details
 
-### 2. Gather Core Story Requirements (from Epic)
+Extract ONLY information directly relevant to implementing the current story. Do NOT invent new libraries, patterns, or standards not in the source documents.
 
-- 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.
-
-### 3. Review Previous Story and Extract Dev Notes
-
-[[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 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
-
-### 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.]]
-
-#### 4.1 Determine Architecture Document Strategy
-
-Based on configuration loaded in Step 0:
-
-- **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
-
-#### 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 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:**
-
-- 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
@@ -2081,33 +1950,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
+ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
 
-[[LLM: ALWAYS cite the source document and section for each technical detail you include. This helps the dev agent verify information if needed.]]
+### 4. Verify Project Structure Alignment
 
-Format references as: `[Source: architecture/{filename}.md#{section}]`
+- 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
 
-### 5. Verify Project Structure Alignment
+### 5. Populate Story Template with Full Context
 
-- 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.
-
-### 6. 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]
@@ -2116,55 +1974,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.
+- Add notes on project structure alignment or discrepancies found in Step 4
 
-### 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
-
-### 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 ====================
@@ -6920,9 +6751,11 @@ so that {{benefit}}.
 ==================== END: templates#prd-tmpl ====================
 
 ==================== 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.
 
@@ -7153,17 +6986,32 @@ These replace the standard elicitation options when working on project brief doc
 ==================== END: templates#project-brief-tmpl ====================
 
 ==================== 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 }}
 
@@ -7178,20 +7026,12 @@ These replace the standard elicitation options when working on project brief doc
 
 ## 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:
+## Change Log
 
-- [ ] {{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]]
-
-{{ 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
 
@@ -7199,29 +7039,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#architect-checklist ====================
@@ -8923,7 +8745,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 |
 | ------------------------------------ | ------ | ------ |
@@ -9021,7 +8843,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 5. Type `/help` to see available commands
 
 #### Option 2: IDE Integration
-**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -9034,6 +8856,7 @@ npx bmad-method install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
+  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **Github Copilot**: AI-powered coding assistant
@@ -9221,11 +9044,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:
@@ -9305,7 +9129,7 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
 
 #### Web UI Environment
 
-- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assest with an orchestrating agent
+- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assets with an orchestrating agent
 - Single text files containing all agent dependencies are in `dist/agents/` - these are unnecessary unless you want to create a web agent that is only a single agent and not a team
 - Created by the web-builder tool for upload to web interfaces
 - Provides complete context in one package

dist/agents/bmad-orchestrator.txt

@@ -1063,7 +1063,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 5. Type `/help` to see available commands
 
 #### Option 2: IDE Integration
-**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -1076,6 +1076,7 @@ npx bmad-method install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
+  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **Github Copilot**: AI-powered coding assistant
@@ -1263,11 +1264,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:
@@ -1347,7 +1349,7 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
 
 #### Web UI Environment
 
-- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assest with an orchestrating agent
+- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assets with an orchestrating agent
 - Single text files containing all agent dependencies are in `dist/agents/` - these are unnecessary unless you want to create a web agent that is only a single agent and not a team
 - Created by the web-builder tool for upload to web interfaces
 - Provides complete context in one package

dist/agents/dev.txt

@@ -53,45 +53,37 @@ agent:
   customization: null
 startup:
   - Announce: Greet the user with your name and role, and inform of the *help command.
-  - CRITICAL: Load .bmad-core/core-config.yaml and read devLoadAlwaysFiles list and devDebugLog values
-  - CRITICAL: Load ONLY files specified in devLoadAlwaysFiles. If any missing, inform user but continue
-  - CRITICAL: Do NOT load any story files during startup unless user requested you do
-  - CRITICAL: Do NOT begin development until told to proceed
+  - CRITICAL: Read the following full files as these are your explicit rules for development standards for this project - {root}/core-config.yaml devLoadAlwaysFiles list
+  - CRITICAL: Do NOT load any other files during startup aside from the assigned story and devLoadAlwaysFiles items, unless user requested you do or the following contradicts
+  - CRITICAL: Do NOT begin development until a story is not in draft mode and you are told to proceed
 persona:
   role: Expert Senior Software Engineer & Implementation Specialist
   style: Extremely concise, pragmatic, detail-oriented, solution-focused
   identity: Expert who implements stories by reading requirements and executing tasks sequentially with comprehensive testing
   focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
 core_principles:
-  - CRITICAL: Story-Centric - Story has ALL info. NEVER load PRD/architecture/other docs files unless explicitly directed in dev notes
-  - CRITICAL: Dev Record Only - ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
-  - Strive for Sequential Task Execution - Complete tasks 1-by-1 and mark [x] as completed
-  - Test-Driven Quality - Write tests alongside code. Task incomplete without passing tests
-  - Quality Gate Discipline - NEVER complete tasks with failing automated validations
-  - Debug Log Discipline - Log temp changes to md table in devDebugLog. Revert after fix.
-  - Block Only When Critical - HALT for: missing approval/ambiguous reqs/3 failures/missing config
-  - Code Excellence - Clean, secure, maintainable code per loaded standards
-  - Numbered Options - Always use numbered lists when presenting choices
+  - CRITICAL: Story has ALL info you will need aside from what you loaded during the startup commands. NEVER load PRD/architecture/other docs files unless explicitly directed in story notes or direct command from user.
+  - CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
+  - CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
+  - Numbered Options - Always use numbered lists when presenting choices to the user
 commands:
   - help: Show numbered list of the following commands to allow selection
   - run-tests: Execute linting and tests
-  - debug-log: Show debug entries
-  - complete-story: Finalize to "Review"
+  - explain: teach me what and why you did whatever you just did in detail so I can learn. Explain to me as if you were training a junior engineer.
   - exit: Say goodbye as the Developer, and then abandon inhabiting this persona
-task-execution:
-  flow: Read task→Implement→Write tests→Execute validations→Only if ALL pass→Update [x]→Next task
-  updates-ONLY:
-    - 'Checkboxes: [ ] not started | [-] in progress | [x] complete'
-    - 'Debug Log: | Task | File | Change | Reverted? |'
-    - 'Completion Notes: Deviations from AC or tasks during execution only, <50 words'
-    - 'Change Log: Requirement changes only'
-    - 'File List: CRITICAL - Maintain complete list of ALL files created/modified during implementation'
-  blocking: Unapproved deps | Ambiguous after story check | 3 failures | Missing config | Failing validations
-  done: Code matches reqs + All validations pass + Follows standards + File List complete
-  completion: All [x]→Validations pass→Integration(if noted)→E2E(if noted)→DoD→Update File List→Mark Ready for Review→HALT
+develop-story:
+  order-of-execution: Read (first or next) task→Implement Task and its subtasks→Write tests→Execute validations→Only if ALL pass, then update the task checkbox with [x]→Update story section File List to ensure it lists and new or modified or deleted source file→repeat order-of-execution until complete
+  story-file-updates-ONLY:
+    - CRITICAL: ONLY UPDATE THE STORY FILE WITH UPDATES TO SECTIONS INDICATED BELOW. DO NOT MODIFY ANY OTHER SECTIONS.
+    - CRITICAL: You are ONLY authorized to edit these specific sections of story files - Tasks / Subtasks Checkboxes, Dev Agent Record section and all its subsections, Agent Model Used, Debug Log References, Completion Notes List, File List, Change Log, Status
+    - CRITICAL: DO NOT modify Status, Story, Acceptance Criteria, Dev Notes, Testing sections, or any other sections not listed above
+  blocking: 'HALT for: Unapproved deps needed, confirm with user | Ambiguous after story check | 3 failures attempting to implement or fix something repeatedly | Missing config | Failing regression'
+  ready-for-review: Code matches requirements + All validations pass + Follows standards + File List complete
+  completion: 'All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON''T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: ''Ready for Review''→HALT'
 dependencies:
   tasks:
     - execute-checklist
+    - validate-next-story
   checklists:
     - story-dod-checklist
 ```
@@ -193,6 +185,143 @@ The LLM will:
 - Offer to provide detailed analysis of any section, especially those with warnings or failures
 ==================== END: tasks#execute-checklist ====================
 
+==================== START: tasks#validate-next-story ====================
+# Validate Next Story Task
+
+## Purpose
+
+To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
+
+## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
+
+### 0. Load Core Configuration and Inputs
+
+- 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 validation."
+- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
+- Identify and load the following inputs:
+  - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
+  - **Parent epic**: The epic containing this story's requirements
+  - **Architecture documents**: Based on configuration (sharded or monolithic)
+  - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
+
+### 1. Template Completeness Validation
+
+- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
+- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
+- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
+- **Agent section verification**: Confirm all sections from template exist for future agent use
+- **Structure compliance**: Verify story follows template structure and formatting
+
+### 2. File Structure and Source Tree Validation
+
+- **File paths clarity**: Are new/existing files to be created/modified clearly specified?
+- **Source tree relevance**: Is relevant project structure included in Dev Notes?
+- **Directory structure**: Are new directories/components properly located according to project structure?
+- **File creation sequence**: Do tasks specify where files should be created in logical order?
+- **Path accuracy**: Are file paths consistent with project structure from architecture docs?
+
+### 3. UI/Frontend Completeness Validation (if applicable)
+
+- **Component specifications**: Are UI components sufficiently detailed for implementation?
+- **Styling/design guidance**: Is visual implementation guidance clear?
+- **User interaction flows**: Are UX patterns and behaviors specified?
+- **Responsive/accessibility**: Are these considerations addressed if required?
+- **Integration points**: Are frontend-backend integration points clear?
+
+### 4. Acceptance Criteria Satisfaction Assessment
+
+- **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
+- **AC testability**: Are acceptance criteria measurable and verifiable?
+- **Missing scenarios**: Are edge cases or error conditions covered?
+- **Success definition**: Is "done" clearly defined for each AC?
+- **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
+
+### 5. Validation and Testing Instructions Review
+
+- **Test approach clarity**: Are testing methods clearly specified?
+- **Test scenarios**: Are key test cases identified?
+- **Validation steps**: Are acceptance criteria validation steps clear?
+- **Testing tools/frameworks**: Are required testing tools specified?
+- **Test data requirements**: Are test data needs identified?
+
+### 6. Security Considerations Assessment (if applicable)
+
+- **Security requirements**: Are security needs identified and addressed?
+- **Authentication/authorization**: Are access controls specified?
+- **Data protection**: Are sensitive data handling requirements clear?
+- **Vulnerability prevention**: Are common security issues addressed?
+- **Compliance requirements**: Are regulatory/compliance needs addressed?
+
+### 7. Tasks/Subtasks Sequence Validation
+
+- **Logical order**: Do tasks follow proper implementation sequence?
+- **Dependencies**: Are task dependencies clear and correct?
+- **Granularity**: Are tasks appropriately sized and actionable?
+- **Completeness**: Do tasks cover all requirements and acceptance criteria?
+- **Blocking issues**: Are there any tasks that would block others?
+
+### 8. Anti-Hallucination Verification
+
+- **Source verification**: Every technical claim must be traceable to source documents
+- **Architecture alignment**: Dev Notes content matches architecture specifications
+- **No invented details**: Flag any technical decisions not supported by source documents
+- **Reference accuracy**: Verify all source references are correct and accessible
+- **Fact checking**: Cross-reference claims against epic and architecture documents
+
+### 9. Dev Agent Implementation Readiness
+
+- **Self-contained context**: Can the story be implemented without reading external docs?
+- **Clear instructions**: Are implementation steps unambiguous?
+- **Complete technical context**: Are all required technical details present in Dev Notes?
+- **Missing information**: Identify any critical information gaps
+- **Actionability**: Are all tasks actionable by a development agent?
+
+### 10. Generate Validation Report
+
+Provide a structured validation report including:
+
+#### Template Compliance Issues
+
+- Missing sections from story template
+- Unfilled placeholders or template variables
+- Structural formatting issues
+
+#### Critical Issues (Must Fix - Story Blocked)
+
+- Missing essential information for implementation
+- Inaccurate or unverifiable technical claims
+- Incomplete acceptance criteria coverage
+- Missing required sections
+
+#### Should-Fix Issues (Important Quality Improvements)
+
+- Unclear implementation guidance
+- Missing security considerations
+- Task sequencing problems
+- Incomplete testing instructions
+
+#### Nice-to-Have Improvements (Optional Enhancements)
+
+- Additional context that would help implementation
+- Clarifications that would improve efficiency
+- Documentation improvements
+
+#### Anti-Hallucination Findings
+
+- Unverifiable technical claims
+- Missing source references
+- Inconsistencies with architecture documents
+- Invented libraries, patterns, or standards
+
+#### Final Assessment
+
+- **GO**: Story is ready for implementation
+- **NO-GO**: Story requires fixes before implementation
+- **Implementation Readiness Score**: 1-10 scale
+- **Confidence Level**: High/Medium/Low for successful implementation
+==================== END: tasks#validate-next-story ====================
+
 ==================== START: checklists#story-dod-checklist ====================
 # Story Definition of Done (DoD) Checklist
 

dist/agents/pm.txt

@@ -74,9 +74,10 @@ 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) Deep conversation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - exit: Say goodbye as the PM, and then abandon inhabiting this persona
+  - 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
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - create-doc

dist/agents/po.txt

@@ -76,14 +76,16 @@ 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) Product Owner consultation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - execute-checklist {checklist}: Run validation checklist (default->po-master-checklist)
-  - shard-doc {document}: Break down document into actionable parts
-  - correct-course: Analyze and suggest project course corrections
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
+  - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
+  - correct-course: execute the correct-course task
   - create-epic: Create epic for brownfield projects (task brownfield-create-epic)
   - create-story: Create user story from requirements (task brownfield-create-story)
-  - exit: Say goodbye as the Product Owner, and then abandon inhabiting this persona
+  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
+  - validate-story-draft {story}: run the task validate-next-story against the provided story file
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - execute-checklist
@@ -91,6 +93,7 @@ dependencies:
     - correct-course
     - brownfield-create-epic
     - brownfield-create-story
+    - validate-next-story
   templates:
     - story-tmpl
   checklists:
@@ -780,18 +783,170 @@ The story creation is successful when:
 - Stories should take no more than 4 hours of focused development work
 ==================== END: tasks#brownfield-create-story ====================
 
+==================== START: tasks#validate-next-story ====================
+# Validate Next Story Task
+
+## Purpose
+
+To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
+
+## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
+
+### 0. Load Core Configuration and Inputs
+
+- 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 validation."
+- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
+- Identify and load the following inputs:
+  - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
+  - **Parent epic**: The epic containing this story's requirements
+  - **Architecture documents**: Based on configuration (sharded or monolithic)
+  - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
+
+### 1. Template Completeness Validation
+
+- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
+- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
+- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
+- **Agent section verification**: Confirm all sections from template exist for future agent use
+- **Structure compliance**: Verify story follows template structure and formatting
+
+### 2. File Structure and Source Tree Validation
+
+- **File paths clarity**: Are new/existing files to be created/modified clearly specified?
+- **Source tree relevance**: Is relevant project structure included in Dev Notes?
+- **Directory structure**: Are new directories/components properly located according to project structure?
+- **File creation sequence**: Do tasks specify where files should be created in logical order?
+- **Path accuracy**: Are file paths consistent with project structure from architecture docs?
+
+### 3. UI/Frontend Completeness Validation (if applicable)
+
+- **Component specifications**: Are UI components sufficiently detailed for implementation?
+- **Styling/design guidance**: Is visual implementation guidance clear?
+- **User interaction flows**: Are UX patterns and behaviors specified?
+- **Responsive/accessibility**: Are these considerations addressed if required?
+- **Integration points**: Are frontend-backend integration points clear?
+
+### 4. Acceptance Criteria Satisfaction Assessment
+
+- **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
+- **AC testability**: Are acceptance criteria measurable and verifiable?
+- **Missing scenarios**: Are edge cases or error conditions covered?
+- **Success definition**: Is "done" clearly defined for each AC?
+- **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
+
+### 5. Validation and Testing Instructions Review
+
+- **Test approach clarity**: Are testing methods clearly specified?
+- **Test scenarios**: Are key test cases identified?
+- **Validation steps**: Are acceptance criteria validation steps clear?
+- **Testing tools/frameworks**: Are required testing tools specified?
+- **Test data requirements**: Are test data needs identified?
+
+### 6. Security Considerations Assessment (if applicable)
+
+- **Security requirements**: Are security needs identified and addressed?
+- **Authentication/authorization**: Are access controls specified?
+- **Data protection**: Are sensitive data handling requirements clear?
+- **Vulnerability prevention**: Are common security issues addressed?
+- **Compliance requirements**: Are regulatory/compliance needs addressed?
+
+### 7. Tasks/Subtasks Sequence Validation
+
+- **Logical order**: Do tasks follow proper implementation sequence?
+- **Dependencies**: Are task dependencies clear and correct?
+- **Granularity**: Are tasks appropriately sized and actionable?
+- **Completeness**: Do tasks cover all requirements and acceptance criteria?
+- **Blocking issues**: Are there any tasks that would block others?
+
+### 8. Anti-Hallucination Verification
+
+- **Source verification**: Every technical claim must be traceable to source documents
+- **Architecture alignment**: Dev Notes content matches architecture specifications
+- **No invented details**: Flag any technical decisions not supported by source documents
+- **Reference accuracy**: Verify all source references are correct and accessible
+- **Fact checking**: Cross-reference claims against epic and architecture documents
+
+### 9. Dev Agent Implementation Readiness
+
+- **Self-contained context**: Can the story be implemented without reading external docs?
+- **Clear instructions**: Are implementation steps unambiguous?
+- **Complete technical context**: Are all required technical details present in Dev Notes?
+- **Missing information**: Identify any critical information gaps
+- **Actionability**: Are all tasks actionable by a development agent?
+
+### 10. Generate Validation Report
+
+Provide a structured validation report including:
+
+#### Template Compliance Issues
+
+- Missing sections from story template
+- Unfilled placeholders or template variables
+- Structural formatting issues
+
+#### Critical Issues (Must Fix - Story Blocked)
+
+- Missing essential information for implementation
+- Inaccurate or unverifiable technical claims
+- Incomplete acceptance criteria coverage
+- Missing required sections
+
+#### Should-Fix Issues (Important Quality Improvements)
+
+- Unclear implementation guidance
+- Missing security considerations
+- Task sequencing problems
+- Incomplete testing instructions
+
+#### Nice-to-Have Improvements (Optional Enhancements)
+
+- Additional context that would help implementation
+- Clarifications that would improve efficiency
+- Documentation improvements
+
+#### Anti-Hallucination Findings
+
+- Unverifiable technical claims
+- Missing source references
+- Inconsistencies with architecture documents
+- Invented libraries, patterns, or standards
+
+#### Final Assessment
+
+- **GO**: Story is ready for implementation
+- **NO-GO**: Story requires fixes before implementation
+- **Implementation Readiness Score**: 1-10 scale
+- **Confidence Level**: High/Medium/Low for successful implementation
+==================== END: tasks#validate-next-story ====================
+
 ==================== 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 }}
 
@@ -806,20 +961,12 @@ The story creation is successful when:
 
 ## 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:
+## Change Log
 
-- [ ] {{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]]
-
-{{ 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
 
@@ -827,29 +974,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#po-master-checklist ====================

dist/agents/qa.txt

@@ -74,10 +74,15 @@ persona:
     - Architecture & Design Patterns - Ensure proper patterns and maintainable code structure
 startup:
   - Greet the user with your name and role, and inform of the *help command.
+story-file-permissions:
+  - CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files
+  - CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections
+  - CRITICAL: Your updates must be limited to appending your review results in the QA Results section only
 commands:
   - help: Show numbered list of the following commands to allow selection
-  - chat-mode: (Default) QA consultation with advanced-elicitation for test strategy
-  - exit: Say goodbye as the QA Test Architect, and then abandon inhabiting this persona
+  - review {story}: execute the task review-story for the highest sequence story in docs/stories unless another is specified - keep any specified technical-preferences in mind as needed
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
 dependencies:
   tasks:
     - review-story
@@ -108,11 +113,19 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
    - Understand the dev notes and requirements
    - Note any completion notes from the developer
 
-2. **Focus on the File List**
+2. **Verify Implementation Against Dev Notes Guidance**
+   - Review the "Dev Notes" section for specific technical guidance provided to the developer
+   - Verify the developer's implementation follows the architectural patterns specified in Dev Notes
+   - Check that file locations match the project structure guidance in Dev Notes
+   - Confirm any specified libraries, frameworks, or technical approaches were used correctly
+   - Validate that security considerations mentioned in Dev Notes were implemented
+
+3. **Focus on the File List**
    - Verify all files listed were actually created/modified
    - Check for any missing files that should have been updated
+   - Ensure file locations align with the project structure guidance from Dev Notes
 
-3. **Senior Developer Code Review**
+4. **Senior Developer Code Review**
    - Review code with the eye of a senior developer
    - If changes form a cohesive whole, review them together
    - If changes are independent, review incrementally file by file
@@ -124,7 +137,7 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
      - Security concerns
      - Best practices and patterns
 
-4. **Active Refactoring**
+5. **Active Refactoring**
    - As a senior developer, you CAN and SHOULD refactor code where improvements are needed
    - When refactoring:
      - Make the changes directly in the files
@@ -133,30 +146,32 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
      - Ensure all tests still pass after refactoring
      - Update the File List if you modify additional files
 
-5. **Standards Compliance Check**
+6. **Standards Compliance Check**
    - Verify adherence to `docs/coding-standards.md`
    - Check compliance with `docs/unified-project-structure.md`
    - Validate testing approach against `docs/testing-strategy.md`
    - Ensure all guidelines mentioned in the story are followed
 
-6. **Acceptance Criteria Validation**
+7. **Acceptance Criteria Validation**
    - Verify each AC is fully implemented
    - Check for any missing functionality
    - Validate edge cases are handled
 
-7. **Test Coverage Review**
+8. **Test Coverage Review**
    - Ensure unit tests cover edge cases
    - Add missing tests if critical coverage is lacking
    - Verify integration tests (if required) are comprehensive
    - Check that test assertions are meaningful
    - Look for missing test scenarios
 
-8. **Documentation and Comments**
+9. **Documentation and Comments**
    - Verify code is self-documenting where possible
    - Add comments for complex logic if missing
    - Ensure any API changes are documented
 
-## Append Results to Story File
+## Update Story File - QA Results Section ONLY
+
+**CRITICAL**: You are ONLY authorized to update the "QA Results" section of the story file. DO NOT modify any other sections.
 
 After review and any refactoring, append your results to the story file in the QA Results section:
 

dist/agents/sm.txt

@@ -70,16 +70,15 @@ 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:
     - create-next-story
     - execute-checklist
-    - course-correct
+    - correct-course
   templates:
     - story-tmpl
   checklists:
@@ -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
+#### 1.1 Locate Epic Files and Review Existing Stories
 
-- 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)
+- 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}"
 
-#### 1.2 Review Existing Stories
+### 2. Gather Story Requirements and Previous Story Context
 
-- 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:
+- 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
 
-    ```plaintext
-    ALERT: Found incomplete story:
-    File: {lastEpicNum}.{lastStoryNum}.story.md
-    Status: [current status]
+### 3. Gather Architecture Context
 
-    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
+#### 3.1 Determine Architecture Reading Strategy
 
-    Please choose an option (1/2/3):
-    ```
+- **If `architectureVersion: >= v4` and `architectureSharded: true`**: Read `{architectureShardedLocation}/index.md` then follow structured reading order below
+- **Else**: Use monolithic `architectureFile` for similar sections
 
-  - 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:
+#### 3.2 Read Architecture Documents Based on Story Type
 
-    ```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):
-    ```
+**For ALL Stories:** tech-stack.md, unified-project-structure.md, coding-standards.md, testing-strategy.md
 
-  - If there are no more stories in the current epic (e.g., 2.9 was done and there is no 2.10):
+**For Backend/API Stories, additionally:** data-models.md, database-schema.md, backend-architecture.md, rest-api-spec.md, external-apis.md
 
-    ```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):
-    ```
+**For Frontend/UI Stories, additionally:** frontend-architecture.md, components.md, core-workflows.md, data-models.md
 
-  - **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.
+**For Full-Stack Stories:** Read both Backend and Frontend sections above
 
-- **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}".
+#### 3.3 Extract Story-Specific Technical Details
 
-### 2. Gather Core Story Requirements (from Epic)
+Extract ONLY information directly relevant to implementing the current story. Do NOT invent new libraries, patterns, or standards not in the source documents.
 
-- 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.
-
-### 3. Review Previous Story and Extract Dev Notes
-
-[[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 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
-
-### 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.]]
-
-#### 4.1 Determine Architecture Document Strategy
-
-Based on configuration loaded in Step 0:
-
-- **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
-
-#### 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 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:**
-
-- 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
+ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
 
-[[LLM: ALWAYS cite the source document and section for each technical detail you include. This helps the dev agent verify information if needed.]]
+### 4. Verify Project Structure Alignment
 
-Format references as: `[Source: architecture/{filename}.md#{section}]`
+- 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
 
-### 5. Verify Project Structure Alignment
+### 5. Populate Story Template with Full Context
 
-- 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.
-
-### 6. 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.
+- Add notes on project structure alignment or discrepancies found in Step 4
 
-### 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
-
-### 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 ====================
@@ -465,18 +301,109 @@ The LLM will:
 - Offer to provide detailed analysis of any section, especially those with warnings or failures
 ==================== END: tasks#execute-checklist ====================
 
+==================== START: tasks#correct-course ====================
+# Correct Course Task
+
+## Purpose
+
+- Guide a structured response to a change trigger using the `change-checklist`.
+- Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
+- Explore potential solutions (e.g., adjust scope, rollback elements, rescope features) as prompted by the checklist.
+- Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
+- Produce a consolidated "Sprint Change Proposal" document that contains the impact analysis and the clearly drafted proposed edits for user review and approval.
+- Ensure a clear handoff path if the nature of the changes necessitates fundamental replanning by other core agents (like PM or Architect).
+
+## Instructions
+
+### 1. Initial Setup & Mode Selection
+
+- **Acknowledge Task & Inputs:**
+  - Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
+  - Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
+  - Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `change-checklist` (e.g., `change-checklist`).
+- **Establish Interaction Mode:**
+  - Ask the user their preferred interaction mode for this task:
+    - **"Incrementally (Default & Recommended):** Shall we work through the `change-checklist` section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
+    - **"YOLO Mode (Batch Processing):** Or, would you prefer I conduct a more batched analysis based on the checklist and then present a consolidated set of findings and proposed changes for a broader review? This can be quicker for initial assessment but might require more extensive review of the combined proposals."
+  - Request the user to select their preferred mode.
+  - Once the user chooses, confirm the selected mode (e.g., "Okay, we will proceed in Incremental mode."). This chosen mode will govern how subsequent steps in this task are executed.
+- **Explain Process:** Briefly inform the user: "We will now use the `change-checklist` to analyze the change and draft proposed updates. I will guide you through the checklist items based on our chosen interaction mode."
+  <rule>When asking multiple questions or presenting multiple points for user input at once, number them clearly (e.g., 1., 2a., 2b.) to make it easier for the user to provide specific responses.</rule>
+
+### 2. Execute Checklist Analysis (Iteratively or Batched, per Interaction Mode)
+
+- Systematically work through Sections 1-4 of the `change-checklist` (typically covering Change Context, Epic/Story Impact Analysis, Artifact Conflict Resolution, and Path Evaluation/Recommendation).
+- For each checklist item or logical group of items (depending on interaction mode):
+  - Present the relevant prompt(s) or considerations from the checklist to the user.
+  - Request necessary information and actively analyze the relevant project artifacts (PRD, epics, architecture documents, story history, etc.) to assess the impact.
+  - Discuss your findings for each item with the user.
+  - Record the status of each checklist item (e.g., `[x] Addressed`, `[N/A]`, `[!] Further Action Needed`) and any pertinent notes or decisions.
+  - Collaboratively agree on the "Recommended Path Forward" as prompted by Section 4 of the checklist.
+
+### 3. Draft Proposed Changes (Iteratively or Batched)
+
+- Based on the completed checklist analysis (Sections 1-4) and the agreed "Recommended Path Forward" (excluding scenarios requiring fundamental replans that would necessitate immediate handoff to PM/Architect):
+  - Identify the specific project artifacts that require updates (e.g., specific epics, user stories, PRD sections, architecture document components, diagrams).
+  - **Draft the proposed changes directly and explicitly for each identified artifact.** Examples include:
+    - Revising user story text, acceptance criteria, or priority.
+    - Adding, removing, reordering, or splitting user stories within epics.
+    - Proposing modified architecture diagram snippets (e.g., providing an updated Mermaid diagram block or a clear textual description of the change to an existing diagram).
+    - Updating technology lists, configuration details, or specific sections within the PRD or architecture documents.
+    - Drafting new, small supporting artifacts if necessary (e.g., a brief addendum for a specific decision).
+  - If in "Incremental Mode," discuss and refine these proposed edits for each artifact or small group of related artifacts with the user as they are drafted.
+  - If in "YOLO Mode," compile all drafted edits for presentation in the next step.
+
+### 4. Generate "Sprint Change Proposal" with Edits
+
+- Synthesize the complete `change-checklist` analysis (covering findings from Sections 1-4) and all the agreed-upon proposed edits (from Instruction 3) into a single document titled "Sprint Change Proposal." This proposal should align with the structure suggested by Section 5 of the `change-checklist` (Proposal Components).
+- The proposal must clearly present:
+  - **Analysis Summary:** A concise overview of the original issue, its analyzed impact (on epics, artifacts, MVP scope), and the rationale for the chosen path forward.
+  - **Specific Proposed Edits:** For each affected artifact, clearly show or describe the exact changes (e.g., "Change Story X.Y from: [old text] To: [new text]", "Add new Acceptance Criterion to Story A.B: [new AC]", "Update Section 3.2 of Architecture Document as follows: [new/modified text or diagram description]").
+- Present the complete draft of the "Sprint Change Proposal" to the user for final review and feedback. Incorporate any final adjustments requested by the user.
+
+### 5. Finalize & Determine Next Steps
+
+- Obtain explicit user approval for the "Sprint Change Proposal," including all the specific edits documented within it.
+- Provide the finalized "Sprint Change Proposal" document to the user.
+- **Based on the nature of the approved changes:**
+  - **If the approved edits sufficiently address the change and can be implemented directly or organized by a PO/SM:** State that the "Correct Course Task" is complete regarding analysis and change proposal, and the user can now proceed with implementing or logging these changes (e.g., updating actual project documents, backlog items). Suggest handoff to a PO/SM agent for backlog organization if appropriate.
+  - **If the analysis and proposed path (as per checklist Section 4 and potentially Section 6) indicate that the change requires a more fundamental replan (e.g., significant scope change, major architectural rework):** Clearly state this conclusion. Advise the user that the next step involves engaging the primary PM or Architect agents, using the "Sprint Change Proposal" as critical input and context for that deeper replanning effort.
+
+## Output Deliverables
+
+- **Primary:** A "Sprint Change Proposal" document (in markdown format). This document will contain:
+  - A summary of the `change-checklist` analysis (issue, impact, rationale for the chosen path).
+  - Specific, clearly drafted proposed edits for all affected project artifacts.
+- **Implicit:** An annotated `change-checklist` (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
+==================== 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 }}
 
@@ -491,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:
+## Change Log
 
-- [ ] {{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]]
-
-{{ 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
 
@@ -512,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 ====================
@@ -679,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 |
 | ------------------------------------ | ------ | ------ |

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:

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.
 

dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt

@@ -41,7 +41,7 @@ These references map directly to bundle sections:
 ==================== START: agents#infra-devops-platform ====================
 # infra-devops-platform
 
-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:
+CRITICAL: Read the full YAML, 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:

dist/teams/team-all.txt

@@ -233,11 +233,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:
@@ -297,10 +299,11 @@ startup:
   - 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
+  - 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
   - exit: Say goodbye as the Architect, and then abandon inhabiting this persona
 dependencies:
   tasks:
@@ -337,45 +340,37 @@ agent:
   customization: null
 startup:
   - Announce: Greet the user with your name and role, and inform of the *help command.
-  - CRITICAL: Load .bmad-core/core-config.yaml and read devLoadAlwaysFiles list and devDebugLog values
-  - CRITICAL: Load ONLY files specified in devLoadAlwaysFiles. If any missing, inform user but continue
-  - CRITICAL: Do NOT load any story files during startup unless user requested you do
-  - CRITICAL: Do NOT begin development until told to proceed
+  - CRITICAL: Read the following full files as these are your explicit rules for development standards for this project - {root}/core-config.yaml devLoadAlwaysFiles list
+  - CRITICAL: Do NOT load any other files during startup aside from the assigned story and devLoadAlwaysFiles items, unless user requested you do or the following contradicts
+  - CRITICAL: Do NOT begin development until a story is not in draft mode and you are told to proceed
 persona:
   role: Expert Senior Software Engineer & Implementation Specialist
   style: Extremely concise, pragmatic, detail-oriented, solution-focused
   identity: Expert who implements stories by reading requirements and executing tasks sequentially with comprehensive testing
   focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
 core_principles:
-  - CRITICAL: Story-Centric - Story has ALL info. NEVER load PRD/architecture/other docs files unless explicitly directed in dev notes
-  - CRITICAL: Dev Record Only - ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
-  - Strive for Sequential Task Execution - Complete tasks 1-by-1 and mark [x] as completed
-  - Test-Driven Quality - Write tests alongside code. Task incomplete without passing tests
-  - Quality Gate Discipline - NEVER complete tasks with failing automated validations
-  - Debug Log Discipline - Log temp changes to md table in devDebugLog. Revert after fix.
-  - Block Only When Critical - HALT for: missing approval/ambiguous reqs/3 failures/missing config
-  - Code Excellence - Clean, secure, maintainable code per loaded standards
-  - Numbered Options - Always use numbered lists when presenting choices
+  - CRITICAL: Story has ALL info you will need aside from what you loaded during the startup commands. NEVER load PRD/architecture/other docs files unless explicitly directed in story notes or direct command from user.
+  - CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
+  - CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
+  - Numbered Options - Always use numbered lists when presenting choices to the user
 commands:
   - help: Show numbered list of the following commands to allow selection
   - run-tests: Execute linting and tests
-  - debug-log: Show debug entries
-  - complete-story: Finalize to "Review"
+  - explain: teach me what and why you did whatever you just did in detail so I can learn. Explain to me as if you were training a junior engineer.
   - exit: Say goodbye as the Developer, and then abandon inhabiting this persona
-task-execution:
-  flow: Read task→Implement→Write tests→Execute validations→Only if ALL pass→Update [x]→Next task
-  updates-ONLY:
-    - 'Checkboxes: [ ] not started | [-] in progress | [x] complete'
-    - 'Debug Log: | Task | File | Change | Reverted? |'
-    - 'Completion Notes: Deviations from AC or tasks during execution only, <50 words'
-    - 'Change Log: Requirement changes only'
-    - 'File List: CRITICAL - Maintain complete list of ALL files created/modified during implementation'
-  blocking: Unapproved deps | Ambiguous after story check | 3 failures | Missing config | Failing validations
-  done: Code matches reqs + All validations pass + Follows standards + File List complete
-  completion: All [x]→Validations pass→Integration(if noted)→E2E(if noted)→DoD→Update File List→Mark Ready for Review→HALT
+develop-story:
+  order-of-execution: Read (first or next) task→Implement Task and its subtasks→Write tests→Execute validations→Only if ALL pass, then update the task checkbox with [x]→Update story section File List to ensure it lists and new or modified or deleted source file→repeat order-of-execution until complete
+  story-file-updates-ONLY:
+    - CRITICAL: ONLY UPDATE THE STORY FILE WITH UPDATES TO SECTIONS INDICATED BELOW. DO NOT MODIFY ANY OTHER SECTIONS.
+    - CRITICAL: You are ONLY authorized to edit these specific sections of story files - Tasks / Subtasks Checkboxes, Dev Agent Record section and all its subsections, Agent Model Used, Debug Log References, Completion Notes List, File List, Change Log, Status
+    - CRITICAL: DO NOT modify Status, Story, Acceptance Criteria, Dev Notes, Testing sections, or any other sections not listed above
+  blocking: 'HALT for: Unapproved deps needed, confirm with user | Ambiguous after story check | 3 failures attempting to implement or fix something repeatedly | Missing config | Failing regression'
+  ready-for-review: Code matches requirements + All validations pass + Follows standards + File List complete
+  completion: 'All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON''T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: ''Ready for Review''→HALT'
 dependencies:
   tasks:
     - execute-checklist
+    - validate-next-story
   checklists:
     - story-dod-checklist
 ```
@@ -417,9 +412,10 @@ 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) Deep conversation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - exit: Say goodbye as the PM, and then abandon inhabiting this persona
+  - 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
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - create-doc
@@ -480,14 +476,16 @@ 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) Product Owner consultation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - execute-checklist {checklist}: Run validation checklist (default->po-master-checklist)
-  - shard-doc {document}: Break down document into actionable parts
-  - correct-course: Analyze and suggest project course corrections
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
+  - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
+  - correct-course: execute the correct-course task
   - create-epic: Create epic for brownfield projects (task brownfield-create-epic)
   - create-story: Create user story from requirements (task brownfield-create-story)
-  - exit: Say goodbye as the Product Owner, and then abandon inhabiting this persona
+  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
+  - validate-story-draft {story}: run the task validate-next-story against the provided story file
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - execute-checklist
@@ -495,6 +493,7 @@ dependencies:
     - correct-course
     - brownfield-create-epic
     - brownfield-create-story
+    - validate-next-story
   templates:
     - story-tmpl
   checklists:
@@ -541,10 +540,15 @@ persona:
     - Architecture & Design Patterns - Ensure proper patterns and maintainable code structure
 startup:
   - Greet the user with your name and role, and inform of the *help command.
+story-file-permissions:
+  - CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files
+  - CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections
+  - CRITICAL: Your updates must be limited to appending your review results in the QA Results section only
 commands:
   - help: Show numbered list of the following commands to allow selection
-  - chat-mode: (Default) QA consultation with advanced-elicitation for test strategy
-  - exit: Say goodbye as the QA Test Architect, and then abandon inhabiting this persona
+  - review {story}: execute the task review-story for the highest sequence story in docs/stories unless another is specified - keep any specified technical-preferences in mind as needed
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
 dependencies:
   tasks:
     - review-story
@@ -587,16 +591,15 @@ 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:
     - create-next-story
     - execute-checklist
-    - course-correct
+    - correct-course
   templates:
     - story-tmpl
   checklists:
@@ -630,16 +633,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.
@@ -648,11 +646,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:
@@ -1555,7 +1552,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 5. Type `/help` to see available commands
 
 #### Option 2: IDE Integration
-**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -1568,6 +1565,7 @@ npx bmad-method install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
+  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **Github Copilot**: AI-powered coding assistant
@@ -1755,11 +1753,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:
@@ -1839,7 +1838,7 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
 
 #### Web UI Environment
 
-- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assest with an orchestrating agent
+- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assets with an orchestrating agent
 - Single text files containing all agent dependencies are in `dist/agents/` - these are unnecessary unless you want to create a web agent that is only a single agent and not a team
 - Created by the web-builder tool for upload to web interfaces
 - Provides complete context in one package
@@ -3419,9 +3418,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.
 
@@ -7284,6 +7285,143 @@ After presenting the report, ask the user if they would like detailed analysis o
 None Listed
 ==================== END: data#technical-preferences ====================
 
+==================== START: tasks#validate-next-story ====================
+# Validate Next Story Task
+
+## Purpose
+
+To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
+
+## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
+
+### 0. Load Core Configuration and Inputs
+
+- 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 validation."
+- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
+- Identify and load the following inputs:
+  - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
+  - **Parent epic**: The epic containing this story's requirements
+  - **Architecture documents**: Based on configuration (sharded or monolithic)
+  - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
+
+### 1. Template Completeness Validation
+
+- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
+- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
+- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
+- **Agent section verification**: Confirm all sections from template exist for future agent use
+- **Structure compliance**: Verify story follows template structure and formatting
+
+### 2. File Structure and Source Tree Validation
+
+- **File paths clarity**: Are new/existing files to be created/modified clearly specified?
+- **Source tree relevance**: Is relevant project structure included in Dev Notes?
+- **Directory structure**: Are new directories/components properly located according to project structure?
+- **File creation sequence**: Do tasks specify where files should be created in logical order?
+- **Path accuracy**: Are file paths consistent with project structure from architecture docs?
+
+### 3. UI/Frontend Completeness Validation (if applicable)
+
+- **Component specifications**: Are UI components sufficiently detailed for implementation?
+- **Styling/design guidance**: Is visual implementation guidance clear?
+- **User interaction flows**: Are UX patterns and behaviors specified?
+- **Responsive/accessibility**: Are these considerations addressed if required?
+- **Integration points**: Are frontend-backend integration points clear?
+
+### 4. Acceptance Criteria Satisfaction Assessment
+
+- **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
+- **AC testability**: Are acceptance criteria measurable and verifiable?
+- **Missing scenarios**: Are edge cases or error conditions covered?
+- **Success definition**: Is "done" clearly defined for each AC?
+- **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
+
+### 5. Validation and Testing Instructions Review
+
+- **Test approach clarity**: Are testing methods clearly specified?
+- **Test scenarios**: Are key test cases identified?
+- **Validation steps**: Are acceptance criteria validation steps clear?
+- **Testing tools/frameworks**: Are required testing tools specified?
+- **Test data requirements**: Are test data needs identified?
+
+### 6. Security Considerations Assessment (if applicable)
+
+- **Security requirements**: Are security needs identified and addressed?
+- **Authentication/authorization**: Are access controls specified?
+- **Data protection**: Are sensitive data handling requirements clear?
+- **Vulnerability prevention**: Are common security issues addressed?
+- **Compliance requirements**: Are regulatory/compliance needs addressed?
+
+### 7. Tasks/Subtasks Sequence Validation
+
+- **Logical order**: Do tasks follow proper implementation sequence?
+- **Dependencies**: Are task dependencies clear and correct?
+- **Granularity**: Are tasks appropriately sized and actionable?
+- **Completeness**: Do tasks cover all requirements and acceptance criteria?
+- **Blocking issues**: Are there any tasks that would block others?
+
+### 8. Anti-Hallucination Verification
+
+- **Source verification**: Every technical claim must be traceable to source documents
+- **Architecture alignment**: Dev Notes content matches architecture specifications
+- **No invented details**: Flag any technical decisions not supported by source documents
+- **Reference accuracy**: Verify all source references are correct and accessible
+- **Fact checking**: Cross-reference claims against epic and architecture documents
+
+### 9. Dev Agent Implementation Readiness
+
+- **Self-contained context**: Can the story be implemented without reading external docs?
+- **Clear instructions**: Are implementation steps unambiguous?
+- **Complete technical context**: Are all required technical details present in Dev Notes?
+- **Missing information**: Identify any critical information gaps
+- **Actionability**: Are all tasks actionable by a development agent?
+
+### 10. Generate Validation Report
+
+Provide a structured validation report including:
+
+#### Template Compliance Issues
+
+- Missing sections from story template
+- Unfilled placeholders or template variables
+- Structural formatting issues
+
+#### Critical Issues (Must Fix - Story Blocked)
+
+- Missing essential information for implementation
+- Inaccurate or unverifiable technical claims
+- Incomplete acceptance criteria coverage
+- Missing required sections
+
+#### Should-Fix Issues (Important Quality Improvements)
+
+- Unclear implementation guidance
+- Missing security considerations
+- Task sequencing problems
+- Incomplete testing instructions
+
+#### Nice-to-Have Improvements (Optional Enhancements)
+
+- Additional context that would help implementation
+- Clarifications that would improve efficiency
+- Documentation improvements
+
+#### Anti-Hallucination Findings
+
+- Unverifiable technical claims
+- Missing source references
+- Inconsistencies with architecture documents
+- Invented libraries, patterns, or standards
+
+#### Final Assessment
+
+- **GO**: Story is ready for implementation
+- **NO-GO**: Story requires fixes before implementation
+- **Implementation Readiness Score**: 1-10 scale
+- **Confidence Level**: High/Medium/Low for successful implementation
+==================== END: tasks#validate-next-story ====================
+
 ==================== START: checklists#story-dod-checklist ====================
 # Story Definition of Done (DoD) Checklist
 
@@ -9009,17 +9147,32 @@ Keep it action-oriented and forward-looking.]]
 ==================== END: checklists#change-checklist ====================
 
 ==================== 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 }}
 
@@ -9034,20 +9187,12 @@ Keep it action-oriented and forward-looking.]]
 
 ## 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:
+## Change Log
 
-- [ ] {{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]]
-
-{{ 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
 
@@ -9055,29 +9200,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#po-master-checklist ====================
@@ -9544,11 +9671,19 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
    - Understand the dev notes and requirements
    - Note any completion notes from the developer
 
-2. **Focus on the File List**
+2. **Verify Implementation Against Dev Notes Guidance**
+   - Review the "Dev Notes" section for specific technical guidance provided to the developer
+   - Verify the developer's implementation follows the architectural patterns specified in Dev Notes
+   - Check that file locations match the project structure guidance in Dev Notes
+   - Confirm any specified libraries, frameworks, or technical approaches were used correctly
+   - Validate that security considerations mentioned in Dev Notes were implemented
+
+3. **Focus on the File List**
    - Verify all files listed were actually created/modified
    - Check for any missing files that should have been updated
+   - Ensure file locations align with the project structure guidance from Dev Notes
 
-3. **Senior Developer Code Review**
+4. **Senior Developer Code Review**
    - Review code with the eye of a senior developer
    - If changes form a cohesive whole, review them together
    - If changes are independent, review incrementally file by file
@@ -9560,7 +9695,7 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
      - Security concerns
      - Best practices and patterns
 
-4. **Active Refactoring**
+5. **Active Refactoring**
    - As a senior developer, you CAN and SHOULD refactor code where improvements are needed
    - When refactoring:
      - Make the changes directly in the files
@@ -9569,30 +9704,32 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
      - Ensure all tests still pass after refactoring
      - Update the File List if you modify additional files
 
-5. **Standards Compliance Check**
+6. **Standards Compliance Check**
    - Verify adherence to `docs/coding-standards.md`
    - Check compliance with `docs/unified-project-structure.md`
    - Validate testing approach against `docs/testing-strategy.md`
    - Ensure all guidelines mentioned in the story are followed
 
-6. **Acceptance Criteria Validation**
+7. **Acceptance Criteria Validation**
    - Verify each AC is fully implemented
    - Check for any missing functionality
    - Validate edge cases are handled
 
-7. **Test Coverage Review**
+8. **Test Coverage Review**
    - Ensure unit tests cover edge cases
    - Add missing tests if critical coverage is lacking
    - Verify integration tests (if required) are comprehensive
    - Check that test assertions are meaningful
    - Look for missing test scenarios
 
-8. **Documentation and Comments**
+9. **Documentation and Comments**
    - Verify code is self-documenting where possible
    - Add comments for complex logic if missing
    - Ensure any API changes are documented
 
-## Append Results to Story File
+## Update Story File - QA Results Section ONLY
+
+**CRITICAL**: You are ONLY authorized to update the "QA Results" section of the story file. DO NOT modify any other sections.
 
 After review and any refactoring, append your results to the story file in the QA Results section:
 
@@ -9667,187 +9804,62 @@ After review:
 
 ## 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
+#### 1.1 Locate Epic Files and Review Existing Stories
 
-- 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)
+- 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}"
 
-#### 1.2 Review Existing Stories
+### 2. Gather Story Requirements and Previous Story Context
 
-- 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:
+- 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
 
-    ```plaintext
-    ALERT: Found incomplete story:
-    File: {lastEpicNum}.{lastStoryNum}.story.md
-    Status: [current status]
+### 3. Gather Architecture Context
 
-    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
+#### 3.1 Determine Architecture Reading Strategy
 
-    Please choose an option (1/2/3):
-    ```
+- **If `architectureVersion: >= v4` and `architectureSharded: true`**: Read `{architectureShardedLocation}/index.md` then follow structured reading order below
+- **Else**: Use monolithic `architectureFile` for similar sections
 
-  - 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:
+#### 3.2 Read Architecture Documents Based on Story Type
 
-    ```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):
-    ```
+**For ALL Stories:** tech-stack.md, unified-project-structure.md, coding-standards.md, testing-strategy.md
 
-  - If there are no more stories in the current epic (e.g., 2.9 was done and there is no 2.10):
+**For Backend/API Stories, additionally:** data-models.md, database-schema.md, backend-architecture.md, rest-api-spec.md, external-apis.md
 
-    ```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):
-    ```
+**For Frontend/UI Stories, additionally:** frontend-architecture.md, components.md, core-workflows.md, data-models.md
 
-  - **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.
+**For Full-Stack Stories:** Read both Backend and Frontend sections above
 
-- **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}".
+#### 3.3 Extract Story-Specific Technical Details
 
-### 2. Gather Core Story Requirements (from Epic)
+Extract ONLY information directly relevant to implementing the current story. Do NOT invent new libraries, patterns, or standards not in the source documents.
 
-- 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.
-
-### 3. Review Previous Story and Extract Dev Notes
-
-[[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 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
-
-### 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.]]
-
-#### 4.1 Determine Architecture Document Strategy
-
-Based on configuration loaded in Step 0:
-
-- **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
-
-#### 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 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:**
-
-- 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
@@ -9856,33 +9868,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
+ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
 
-[[LLM: ALWAYS cite the source document and section for each technical detail you include. This helps the dev agent verify information if needed.]]
+### 4. Verify Project Structure Alignment
 
-Format references as: `[Source: architecture/{filename}.md#{section}]`
+- 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
 
-### 5. Verify Project Structure Alignment
+### 5. Populate Story Template with Full Context
 
-- 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.
-
-### 6. 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]
@@ -9891,55 +9892,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.
+- Add notes on project structure alignment or discrepancies found in Step 4
 
-### 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
-
-### 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: checklists#story-draft-checklist ====================
@@ -10084,7 +10058,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 |
 | ------------------------------------ | ------ | ------ |

dist/teams/team-fullstack.txt

@@ -237,11 +237,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:
@@ -298,9 +300,10 @@ 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) Deep conversation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - exit: Say goodbye as the PM, and then abandon inhabiting this persona
+  - 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
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - create-doc
@@ -347,16 +350,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.
@@ -365,11 +363,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:
@@ -425,10 +422,11 @@ startup:
   - 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
+  - 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
   - exit: Say goodbye as the Architect, and then abandon inhabiting this persona
 dependencies:
   tasks:
@@ -488,14 +486,16 @@ 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) Product Owner consultation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - execute-checklist {checklist}: Run validation checklist (default->po-master-checklist)
-  - shard-doc {document}: Break down document into actionable parts
-  - correct-course: Analyze and suggest project course corrections
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
+  - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
+  - correct-course: execute the correct-course task
   - create-epic: Create epic for brownfield projects (task brownfield-create-epic)
   - create-story: Create user story from requirements (task brownfield-create-story)
-  - exit: Say goodbye as the Product Owner, and then abandon inhabiting this persona
+  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
+  - validate-story-draft {story}: run the task validate-next-story against the provided story file
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - execute-checklist
@@ -503,6 +503,7 @@ dependencies:
     - correct-course
     - brownfield-create-epic
     - brownfield-create-story
+    - validate-next-story
   templates:
     - story-tmpl
   checklists:
@@ -1399,7 +1400,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 5. Type `/help` to see available commands
 
 #### Option 2: IDE Integration
-**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -1412,6 +1413,7 @@ npx bmad-method install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
+  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **Github Copilot**: AI-powered coding assistant
@@ -1599,11 +1601,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:
@@ -1683,7 +1686,7 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
 
 #### Web UI Environment
 
-- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assest with an orchestrating agent
+- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assets with an orchestrating agent
 - Single text files containing all agent dependencies are in `dist/agents/` - these are unnecessary unless you want to create a web agent that is only a single agent and not a team
 - Created by the web-builder tool for upload to web interfaces
 - Provides complete context in one package
@@ -3263,9 +3266,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.
 
@@ -9218,18 +9223,170 @@ Now that you've completed the checklist, generate a comprehensive validation rep
 After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
 ==================== END: checklists#architect-checklist ====================
 
+==================== START: tasks#validate-next-story ====================
+# Validate Next Story Task
+
+## Purpose
+
+To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
+
+## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
+
+### 0. Load Core Configuration and Inputs
+
+- 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 validation."
+- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
+- Identify and load the following inputs:
+  - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
+  - **Parent epic**: The epic containing this story's requirements
+  - **Architecture documents**: Based on configuration (sharded or monolithic)
+  - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
+
+### 1. Template Completeness Validation
+
+- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
+- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
+- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
+- **Agent section verification**: Confirm all sections from template exist for future agent use
+- **Structure compliance**: Verify story follows template structure and formatting
+
+### 2. File Structure and Source Tree Validation
+
+- **File paths clarity**: Are new/existing files to be created/modified clearly specified?
+- **Source tree relevance**: Is relevant project structure included in Dev Notes?
+- **Directory structure**: Are new directories/components properly located according to project structure?
+- **File creation sequence**: Do tasks specify where files should be created in logical order?
+- **Path accuracy**: Are file paths consistent with project structure from architecture docs?
+
+### 3. UI/Frontend Completeness Validation (if applicable)
+
+- **Component specifications**: Are UI components sufficiently detailed for implementation?
+- **Styling/design guidance**: Is visual implementation guidance clear?
+- **User interaction flows**: Are UX patterns and behaviors specified?
+- **Responsive/accessibility**: Are these considerations addressed if required?
+- **Integration points**: Are frontend-backend integration points clear?
+
+### 4. Acceptance Criteria Satisfaction Assessment
+
+- **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
+- **AC testability**: Are acceptance criteria measurable and verifiable?
+- **Missing scenarios**: Are edge cases or error conditions covered?
+- **Success definition**: Is "done" clearly defined for each AC?
+- **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
+
+### 5. Validation and Testing Instructions Review
+
+- **Test approach clarity**: Are testing methods clearly specified?
+- **Test scenarios**: Are key test cases identified?
+- **Validation steps**: Are acceptance criteria validation steps clear?
+- **Testing tools/frameworks**: Are required testing tools specified?
+- **Test data requirements**: Are test data needs identified?
+
+### 6. Security Considerations Assessment (if applicable)
+
+- **Security requirements**: Are security needs identified and addressed?
+- **Authentication/authorization**: Are access controls specified?
+- **Data protection**: Are sensitive data handling requirements clear?
+- **Vulnerability prevention**: Are common security issues addressed?
+- **Compliance requirements**: Are regulatory/compliance needs addressed?
+
+### 7. Tasks/Subtasks Sequence Validation
+
+- **Logical order**: Do tasks follow proper implementation sequence?
+- **Dependencies**: Are task dependencies clear and correct?
+- **Granularity**: Are tasks appropriately sized and actionable?
+- **Completeness**: Do tasks cover all requirements and acceptance criteria?
+- **Blocking issues**: Are there any tasks that would block others?
+
+### 8. Anti-Hallucination Verification
+
+- **Source verification**: Every technical claim must be traceable to source documents
+- **Architecture alignment**: Dev Notes content matches architecture specifications
+- **No invented details**: Flag any technical decisions not supported by source documents
+- **Reference accuracy**: Verify all source references are correct and accessible
+- **Fact checking**: Cross-reference claims against epic and architecture documents
+
+### 9. Dev Agent Implementation Readiness
+
+- **Self-contained context**: Can the story be implemented without reading external docs?
+- **Clear instructions**: Are implementation steps unambiguous?
+- **Complete technical context**: Are all required technical details present in Dev Notes?
+- **Missing information**: Identify any critical information gaps
+- **Actionability**: Are all tasks actionable by a development agent?
+
+### 10. Generate Validation Report
+
+Provide a structured validation report including:
+
+#### Template Compliance Issues
+
+- Missing sections from story template
+- Unfilled placeholders or template variables
+- Structural formatting issues
+
+#### Critical Issues (Must Fix - Story Blocked)
+
+- Missing essential information for implementation
+- Inaccurate or unverifiable technical claims
+- Incomplete acceptance criteria coverage
+- Missing required sections
+
+#### Should-Fix Issues (Important Quality Improvements)
+
+- Unclear implementation guidance
+- Missing security considerations
+- Task sequencing problems
+- Incomplete testing instructions
+
+#### Nice-to-Have Improvements (Optional Enhancements)
+
+- Additional context that would help implementation
+- Clarifications that would improve efficiency
+- Documentation improvements
+
+#### Anti-Hallucination Findings
+
+- Unverifiable technical claims
+- Missing source references
+- Inconsistencies with architecture documents
+- Invented libraries, patterns, or standards
+
+#### Final Assessment
+
+- **GO**: Story is ready for implementation
+- **NO-GO**: Story requires fixes before implementation
+- **Implementation Readiness Score**: 1-10 scale
+- **Confidence Level**: High/Medium/Low for successful implementation
+==================== END: tasks#validate-next-story ====================
+
 ==================== 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 }}
 
@@ -9244,20 +9401,12 @@ After presenting the report, ask the user if they would like detailed analysis o
 
 ## 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:
+## Change Log
 
-- [ ] {{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]]
-
-{{ 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
 
@@ -9265,29 +9414,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#po-master-checklist ====================

dist/teams/team-ide-minimal.txt

@@ -228,14 +228,16 @@ 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) Product Owner consultation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - execute-checklist {checklist}: Run validation checklist (default->po-master-checklist)
-  - shard-doc {document}: Break down document into actionable parts
-  - correct-course: Analyze and suggest project course corrections
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
+  - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
+  - correct-course: execute the correct-course task
   - create-epic: Create epic for brownfield projects (task brownfield-create-epic)
   - create-story: Create user story from requirements (task brownfield-create-story)
-  - exit: Say goodbye as the Product Owner, and then abandon inhabiting this persona
+  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
+  - validate-story-draft {story}: run the task validate-next-story against the provided story file
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - execute-checklist
@@ -243,6 +245,7 @@ dependencies:
     - correct-course
     - brownfield-create-epic
     - brownfield-create-story
+    - validate-next-story
   templates:
     - story-tmpl
   checklists:
@@ -285,16 +288,15 @@ 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:
     - create-next-story
     - execute-checklist
-    - course-correct
+    - correct-course
   templates:
     - story-tmpl
   checklists:
@@ -319,45 +321,37 @@ agent:
   customization: null
 startup:
   - Announce: Greet the user with your name and role, and inform of the *help command.
-  - CRITICAL: Load .bmad-core/core-config.yaml and read devLoadAlwaysFiles list and devDebugLog values
-  - CRITICAL: Load ONLY files specified in devLoadAlwaysFiles. If any missing, inform user but continue
-  - CRITICAL: Do NOT load any story files during startup unless user requested you do
-  - CRITICAL: Do NOT begin development until told to proceed
+  - CRITICAL: Read the following full files as these are your explicit rules for development standards for this project - {root}/core-config.yaml devLoadAlwaysFiles list
+  - CRITICAL: Do NOT load any other files during startup aside from the assigned story and devLoadAlwaysFiles items, unless user requested you do or the following contradicts
+  - CRITICAL: Do NOT begin development until a story is not in draft mode and you are told to proceed
 persona:
   role: Expert Senior Software Engineer & Implementation Specialist
   style: Extremely concise, pragmatic, detail-oriented, solution-focused
   identity: Expert who implements stories by reading requirements and executing tasks sequentially with comprehensive testing
   focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
 core_principles:
-  - CRITICAL: Story-Centric - Story has ALL info. NEVER load PRD/architecture/other docs files unless explicitly directed in dev notes
-  - CRITICAL: Dev Record Only - ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
-  - Strive for Sequential Task Execution - Complete tasks 1-by-1 and mark [x] as completed
-  - Test-Driven Quality - Write tests alongside code. Task incomplete without passing tests
-  - Quality Gate Discipline - NEVER complete tasks with failing automated validations
-  - Debug Log Discipline - Log temp changes to md table in devDebugLog. Revert after fix.
-  - Block Only When Critical - HALT for: missing approval/ambiguous reqs/3 failures/missing config
-  - Code Excellence - Clean, secure, maintainable code per loaded standards
-  - Numbered Options - Always use numbered lists when presenting choices
+  - CRITICAL: Story has ALL info you will need aside from what you loaded during the startup commands. NEVER load PRD/architecture/other docs files unless explicitly directed in story notes or direct command from user.
+  - CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
+  - CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
+  - Numbered Options - Always use numbered lists when presenting choices to the user
 commands:
   - help: Show numbered list of the following commands to allow selection
   - run-tests: Execute linting and tests
-  - debug-log: Show debug entries
-  - complete-story: Finalize to "Review"
+  - explain: teach me what and why you did whatever you just did in detail so I can learn. Explain to me as if you were training a junior engineer.
   - exit: Say goodbye as the Developer, and then abandon inhabiting this persona
-task-execution:
-  flow: Read task→Implement→Write tests→Execute validations→Only if ALL pass→Update [x]→Next task
-  updates-ONLY:
-    - 'Checkboxes: [ ] not started | [-] in progress | [x] complete'
-    - 'Debug Log: | Task | File | Change | Reverted? |'
-    - 'Completion Notes: Deviations from AC or tasks during execution only, <50 words'
-    - 'Change Log: Requirement changes only'
-    - 'File List: CRITICAL - Maintain complete list of ALL files created/modified during implementation'
-  blocking: Unapproved deps | Ambiguous after story check | 3 failures | Missing config | Failing validations
-  done: Code matches reqs + All validations pass + Follows standards + File List complete
-  completion: All [x]→Validations pass→Integration(if noted)→E2E(if noted)→DoD→Update File List→Mark Ready for Review→HALT
+develop-story:
+  order-of-execution: Read (first or next) task→Implement Task and its subtasks→Write tests→Execute validations→Only if ALL pass, then update the task checkbox with [x]→Update story section File List to ensure it lists and new or modified or deleted source file→repeat order-of-execution until complete
+  story-file-updates-ONLY:
+    - CRITICAL: ONLY UPDATE THE STORY FILE WITH UPDATES TO SECTIONS INDICATED BELOW. DO NOT MODIFY ANY OTHER SECTIONS.
+    - CRITICAL: You are ONLY authorized to edit these specific sections of story files - Tasks / Subtasks Checkboxes, Dev Agent Record section and all its subsections, Agent Model Used, Debug Log References, Completion Notes List, File List, Change Log, Status
+    - CRITICAL: DO NOT modify Status, Story, Acceptance Criteria, Dev Notes, Testing sections, or any other sections not listed above
+  blocking: 'HALT for: Unapproved deps needed, confirm with user | Ambiguous after story check | 3 failures attempting to implement or fix something repeatedly | Missing config | Failing regression'
+  ready-for-review: Code matches requirements + All validations pass + Follows standards + File List complete
+  completion: 'All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON''T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: ''Ready for Review''→HALT'
 dependencies:
   tasks:
     - execute-checklist
+    - validate-next-story
   checklists:
     - story-dod-checklist
 ```
@@ -399,10 +393,15 @@ persona:
     - Architecture & Design Patterns - Ensure proper patterns and maintainable code structure
 startup:
   - Greet the user with your name and role, and inform of the *help command.
+story-file-permissions:
+  - CRITICAL: When reviewing stories, you are ONLY authorized to update the "QA Results" section of story files
+  - CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections
+  - CRITICAL: Your updates must be limited to appending your review results in the QA Results section only
 commands:
   - help: Show numbered list of the following commands to allow selection
-  - chat-mode: (Default) QA consultation with advanced-elicitation for test strategy
-  - exit: Say goodbye as the QA Test Architect, and then abandon inhabiting this persona
+  - review {story}: execute the task review-story for the highest sequence story in docs/stories unless another is specified - keep any specified technical-preferences in mind as needed
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
 dependencies:
   tasks:
     - review-story
@@ -1299,7 +1298,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 5. Type `/help` to see available commands
 
 #### Option 2: IDE Integration
-**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -1312,6 +1311,7 @@ npx bmad-method install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
+  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **Github Copilot**: AI-powered coding assistant
@@ -1499,11 +1499,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:
@@ -1583,7 +1584,7 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
 
 #### Web UI Environment
 
-- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assest with an orchestrating agent
+- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assets with an orchestrating agent
 - Single text files containing all agent dependencies are in `dist/agents/` - these are unnecessary unless you want to create a web agent that is only a single agent and not a team
 - Created by the web-builder tool for upload to web interfaces
 - Provides complete context in one package
@@ -2976,18 +2977,170 @@ The story creation is successful when:
 - Stories should take no more than 4 hours of focused development work
 ==================== END: tasks#brownfield-create-story ====================
 
+==================== START: tasks#validate-next-story ====================
+# Validate Next Story Task
+
+## Purpose
+
+To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
+
+## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
+
+### 0. Load Core Configuration and Inputs
+
+- 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 validation."
+- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
+- Identify and load the following inputs:
+  - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
+  - **Parent epic**: The epic containing this story's requirements
+  - **Architecture documents**: Based on configuration (sharded or monolithic)
+  - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
+
+### 1. Template Completeness Validation
+
+- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
+- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
+- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
+- **Agent section verification**: Confirm all sections from template exist for future agent use
+- **Structure compliance**: Verify story follows template structure and formatting
+
+### 2. File Structure and Source Tree Validation
+
+- **File paths clarity**: Are new/existing files to be created/modified clearly specified?
+- **Source tree relevance**: Is relevant project structure included in Dev Notes?
+- **Directory structure**: Are new directories/components properly located according to project structure?
+- **File creation sequence**: Do tasks specify where files should be created in logical order?
+- **Path accuracy**: Are file paths consistent with project structure from architecture docs?
+
+### 3. UI/Frontend Completeness Validation (if applicable)
+
+- **Component specifications**: Are UI components sufficiently detailed for implementation?
+- **Styling/design guidance**: Is visual implementation guidance clear?
+- **User interaction flows**: Are UX patterns and behaviors specified?
+- **Responsive/accessibility**: Are these considerations addressed if required?
+- **Integration points**: Are frontend-backend integration points clear?
+
+### 4. Acceptance Criteria Satisfaction Assessment
+
+- **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
+- **AC testability**: Are acceptance criteria measurable and verifiable?
+- **Missing scenarios**: Are edge cases or error conditions covered?
+- **Success definition**: Is "done" clearly defined for each AC?
+- **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
+
+### 5. Validation and Testing Instructions Review
+
+- **Test approach clarity**: Are testing methods clearly specified?
+- **Test scenarios**: Are key test cases identified?
+- **Validation steps**: Are acceptance criteria validation steps clear?
+- **Testing tools/frameworks**: Are required testing tools specified?
+- **Test data requirements**: Are test data needs identified?
+
+### 6. Security Considerations Assessment (if applicable)
+
+- **Security requirements**: Are security needs identified and addressed?
+- **Authentication/authorization**: Are access controls specified?
+- **Data protection**: Are sensitive data handling requirements clear?
+- **Vulnerability prevention**: Are common security issues addressed?
+- **Compliance requirements**: Are regulatory/compliance needs addressed?
+
+### 7. Tasks/Subtasks Sequence Validation
+
+- **Logical order**: Do tasks follow proper implementation sequence?
+- **Dependencies**: Are task dependencies clear and correct?
+- **Granularity**: Are tasks appropriately sized and actionable?
+- **Completeness**: Do tasks cover all requirements and acceptance criteria?
+- **Blocking issues**: Are there any tasks that would block others?
+
+### 8. Anti-Hallucination Verification
+
+- **Source verification**: Every technical claim must be traceable to source documents
+- **Architecture alignment**: Dev Notes content matches architecture specifications
+- **No invented details**: Flag any technical decisions not supported by source documents
+- **Reference accuracy**: Verify all source references are correct and accessible
+- **Fact checking**: Cross-reference claims against epic and architecture documents
+
+### 9. Dev Agent Implementation Readiness
+
+- **Self-contained context**: Can the story be implemented without reading external docs?
+- **Clear instructions**: Are implementation steps unambiguous?
+- **Complete technical context**: Are all required technical details present in Dev Notes?
+- **Missing information**: Identify any critical information gaps
+- **Actionability**: Are all tasks actionable by a development agent?
+
+### 10. Generate Validation Report
+
+Provide a structured validation report including:
+
+#### Template Compliance Issues
+
+- Missing sections from story template
+- Unfilled placeholders or template variables
+- Structural formatting issues
+
+#### Critical Issues (Must Fix - Story Blocked)
+
+- Missing essential information for implementation
+- Inaccurate or unverifiable technical claims
+- Incomplete acceptance criteria coverage
+- Missing required sections
+
+#### Should-Fix Issues (Important Quality Improvements)
+
+- Unclear implementation guidance
+- Missing security considerations
+- Task sequencing problems
+- Incomplete testing instructions
+
+#### Nice-to-Have Improvements (Optional Enhancements)
+
+- Additional context that would help implementation
+- Clarifications that would improve efficiency
+- Documentation improvements
+
+#### Anti-Hallucination Findings
+
+- Unverifiable technical claims
+- Missing source references
+- Inconsistencies with architecture documents
+- Invented libraries, patterns, or standards
+
+#### Final Assessment
+
+- **GO**: Story is ready for implementation
+- **NO-GO**: Story requires fixes before implementation
+- **Implementation Readiness Score**: 1-10 scale
+- **Confidence Level**: High/Medium/Low for successful implementation
+==================== END: tasks#validate-next-story ====================
+
 ==================== 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 }}
 
@@ -3002,20 +3155,12 @@ The story creation is successful when:
 
 ## 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:
+## Change Log
 
-- [ ] {{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]]
-
-{{ 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
 
@@ -3023,29 +3168,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#po-master-checklist ====================
@@ -3682,187 +3809,62 @@ Keep it action-oriented and forward-looking.]]
 
 ## 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
+#### 1.1 Locate Epic Files and Review Existing Stories
 
-- 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)
+- 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}"
 
-#### 1.2 Review Existing Stories
+### 2. Gather Story Requirements and Previous Story Context
 
-- 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:
+- 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
 
-    ```plaintext
-    ALERT: Found incomplete story:
-    File: {lastEpicNum}.{lastStoryNum}.story.md
-    Status: [current status]
+### 3. Gather Architecture Context
 
-    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
+#### 3.1 Determine Architecture Reading Strategy
 
-    Please choose an option (1/2/3):
-    ```
+- **If `architectureVersion: >= v4` and `architectureSharded: true`**: Read `{architectureShardedLocation}/index.md` then follow structured reading order below
+- **Else**: Use monolithic `architectureFile` for similar sections
 
-  - 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:
+#### 3.2 Read Architecture Documents Based on Story Type
 
-    ```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):
-    ```
+**For ALL Stories:** tech-stack.md, unified-project-structure.md, coding-standards.md, testing-strategy.md
 
-  - If there are no more stories in the current epic (e.g., 2.9 was done and there is no 2.10):
+**For Backend/API Stories, additionally:** data-models.md, database-schema.md, backend-architecture.md, rest-api-spec.md, external-apis.md
 
-    ```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):
-    ```
+**For Frontend/UI Stories, additionally:** frontend-architecture.md, components.md, core-workflows.md, data-models.md
 
-  - **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.
+**For Full-Stack Stories:** Read both Backend and Frontend sections above
 
-- **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}".
+#### 3.3 Extract Story-Specific Technical Details
 
-### 2. Gather Core Story Requirements (from Epic)
+Extract ONLY information directly relevant to implementing the current story. Do NOT invent new libraries, patterns, or standards not in the source documents.
 
-- 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.
-
-### 3. Review Previous Story and Extract Dev Notes
-
-[[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 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
-
-### 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.]]
-
-#### 4.1 Determine Architecture Document Strategy
-
-Based on configuration loaded in Step 0:
-
-- **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
-
-#### 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 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:**
-
-- 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
@@ -3871,33 +3873,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
+ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
 
-[[LLM: ALWAYS cite the source document and section for each technical detail you include. This helps the dev agent verify information if needed.]]
+### 4. Verify Project Structure Alignment
 
-Format references as: `[Source: architecture/{filename}.md#{section}]`
+- 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
 
-### 5. Verify Project Structure Alignment
+### 5. Populate Story Template with Full Context
 
-- 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.
-
-### 6. 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]
@@ -3906,55 +3897,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.
+- Add notes on project structure alignment or discrepancies found in Step 4
 
-### 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
-
-### 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: checklists#story-draft-checklist ====================
@@ -4099,7 +4063,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 |
 | ------------------------------------ | ------ | ------ |
@@ -4240,11 +4204,19 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
    - Understand the dev notes and requirements
    - Note any completion notes from the developer
 
-2. **Focus on the File List**
+2. **Verify Implementation Against Dev Notes Guidance**
+   - Review the "Dev Notes" section for specific technical guidance provided to the developer
+   - Verify the developer's implementation follows the architectural patterns specified in Dev Notes
+   - Check that file locations match the project structure guidance in Dev Notes
+   - Confirm any specified libraries, frameworks, or technical approaches were used correctly
+   - Validate that security considerations mentioned in Dev Notes were implemented
+
+3. **Focus on the File List**
    - Verify all files listed were actually created/modified
    - Check for any missing files that should have been updated
+   - Ensure file locations align with the project structure guidance from Dev Notes
 
-3. **Senior Developer Code Review**
+4. **Senior Developer Code Review**
    - Review code with the eye of a senior developer
    - If changes form a cohesive whole, review them together
    - If changes are independent, review incrementally file by file
@@ -4256,7 +4228,7 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
      - Security concerns
      - Best practices and patterns
 
-4. **Active Refactoring**
+5. **Active Refactoring**
    - As a senior developer, you CAN and SHOULD refactor code where improvements are needed
    - When refactoring:
      - Make the changes directly in the files
@@ -4265,30 +4237,32 @@ When a developer marks a story as "Ready for Review", perform a comprehensive se
      - Ensure all tests still pass after refactoring
      - Update the File List if you modify additional files
 
-5. **Standards Compliance Check**
+6. **Standards Compliance Check**
    - Verify adherence to `docs/coding-standards.md`
    - Check compliance with `docs/unified-project-structure.md`
    - Validate testing approach against `docs/testing-strategy.md`
    - Ensure all guidelines mentioned in the story are followed
 
-6. **Acceptance Criteria Validation**
+7. **Acceptance Criteria Validation**
    - Verify each AC is fully implemented
    - Check for any missing functionality
    - Validate edge cases are handled
 
-7. **Test Coverage Review**
+8. **Test Coverage Review**
    - Ensure unit tests cover edge cases
    - Add missing tests if critical coverage is lacking
    - Verify integration tests (if required) are comprehensive
    - Check that test assertions are meaningful
    - Look for missing test scenarios
 
-8. **Documentation and Comments**
+9. **Documentation and Comments**
    - Verify code is self-documenting where possible
    - Add comments for complex logic if missing
    - Ensure any API changes are documented
 
-## Append Results to Story File
+## Update Story File - QA Results Section ONLY
+
+**CRITICAL**: You are ONLY authorized to update the "QA Results" section of the story file. DO NOT modify any other sections.
 
 After review and any refactoring, append your results to the story file in the QA Results section:
 

dist/teams/team-no-ui.txt

@@ -232,11 +232,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:
@@ -293,9 +295,10 @@ 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) Deep conversation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - exit: Say goodbye as the PM, and then abandon inhabiting this persona
+  - 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
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - create-doc
@@ -357,10 +360,11 @@ startup:
   - 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
+  - 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
   - exit: Say goodbye as the Architect, and then abandon inhabiting this persona
 dependencies:
   tasks:
@@ -420,14 +424,16 @@ 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) Product Owner consultation with advanced-elicitation
-  - create-doc {template}: Create doc (no template = show available templates)
-  - execute-checklist {checklist}: Run validation checklist (default->po-master-checklist)
-  - shard-doc {document}: Break down document into actionable parts
-  - correct-course: Analyze and suggest project course corrections
+  - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
+  - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
+  - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
+  - correct-course: execute the correct-course task
   - create-epic: Create epic for brownfield projects (task brownfield-create-epic)
   - create-story: Create user story from requirements (task brownfield-create-story)
-  - exit: Say goodbye as the Product Owner, and then abandon inhabiting this persona
+  - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
+  - doc-out: Output full document to current destination file
+  - validate-story-draft {story}: run the task validate-next-story against the provided story file
+  - exit: Exit (confirm)
 dependencies:
   tasks:
     - execute-checklist
@@ -435,6 +441,7 @@ dependencies:
     - correct-course
     - brownfield-create-epic
     - brownfield-create-story
+    - validate-next-story
   templates:
     - story-tmpl
   checklists:
@@ -1331,7 +1338,7 @@ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 5. Type `/help` to see available commands
 
 #### Option 2: IDE Integration
-**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -1344,6 +1351,7 @@ npx bmad-method install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
+  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **Github Copilot**: AI-powered coding assistant
@@ -1531,11 +1539,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:
@@ -1615,7 +1624,7 @@ The BMad-Method is built around a modular architecture centered on the `bmad-cor
 
 #### Web UI Environment
 
-- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assest with an orchestrating agent
+- Uses pre-built bundles from `dist/teams` for stand alone 1 upload files for all agents and their assets with an orchestrating agent
 - Single text files containing all agent dependencies are in `dist/agents/` - these are unnecessary unless you want to create a web agent that is only a single agent and not a team
 - Created by the web-builder tool for upload to web interfaces
 - Provides complete context in one package
@@ -3195,9 +3204,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.
 
@@ -8680,18 +8691,170 @@ Now that you've completed the checklist, generate a comprehensive validation rep
 After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
 ==================== END: checklists#architect-checklist ====================
 
+==================== START: tasks#validate-next-story ====================
+# Validate Next Story Task
+
+## Purpose
+
+To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
+
+## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
+
+### 0. Load Core Configuration and Inputs
+
+- 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 validation."
+- Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
+- Identify and load the following inputs:
+  - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
+  - **Parent epic**: The epic containing this story's requirements
+  - **Architecture documents**: Based on configuration (sharded or monolithic)
+  - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
+
+### 1. Template Completeness Validation
+
+- Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
+- **Missing sections check**: Compare story sections against template sections to verify all required sections are present
+- **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
+- **Agent section verification**: Confirm all sections from template exist for future agent use
+- **Structure compliance**: Verify story follows template structure and formatting
+
+### 2. File Structure and Source Tree Validation
+
+- **File paths clarity**: Are new/existing files to be created/modified clearly specified?
+- **Source tree relevance**: Is relevant project structure included in Dev Notes?
+- **Directory structure**: Are new directories/components properly located according to project structure?
+- **File creation sequence**: Do tasks specify where files should be created in logical order?
+- **Path accuracy**: Are file paths consistent with project structure from architecture docs?
+
+### 3. UI/Frontend Completeness Validation (if applicable)
+
+- **Component specifications**: Are UI components sufficiently detailed for implementation?
+- **Styling/design guidance**: Is visual implementation guidance clear?
+- **User interaction flows**: Are UX patterns and behaviors specified?
+- **Responsive/accessibility**: Are these considerations addressed if required?
+- **Integration points**: Are frontend-backend integration points clear?
+
+### 4. Acceptance Criteria Satisfaction Assessment
+
+- **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
+- **AC testability**: Are acceptance criteria measurable and verifiable?
+- **Missing scenarios**: Are edge cases or error conditions covered?
+- **Success definition**: Is "done" clearly defined for each AC?
+- **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
+
+### 5. Validation and Testing Instructions Review
+
+- **Test approach clarity**: Are testing methods clearly specified?
+- **Test scenarios**: Are key test cases identified?
+- **Validation steps**: Are acceptance criteria validation steps clear?
+- **Testing tools/frameworks**: Are required testing tools specified?
+- **Test data requirements**: Are test data needs identified?
+
+### 6. Security Considerations Assessment (if applicable)
+
+- **Security requirements**: Are security needs identified and addressed?
+- **Authentication/authorization**: Are access controls specified?
+- **Data protection**: Are sensitive data handling requirements clear?
+- **Vulnerability prevention**: Are common security issues addressed?
+- **Compliance requirements**: Are regulatory/compliance needs addressed?
+
+### 7. Tasks/Subtasks Sequence Validation
+
+- **Logical order**: Do tasks follow proper implementation sequence?
+- **Dependencies**: Are task dependencies clear and correct?
+- **Granularity**: Are tasks appropriately sized and actionable?
+- **Completeness**: Do tasks cover all requirements and acceptance criteria?
+- **Blocking issues**: Are there any tasks that would block others?
+
+### 8. Anti-Hallucination Verification
+
+- **Source verification**: Every technical claim must be traceable to source documents
+- **Architecture alignment**: Dev Notes content matches architecture specifications
+- **No invented details**: Flag any technical decisions not supported by source documents
+- **Reference accuracy**: Verify all source references are correct and accessible
+- **Fact checking**: Cross-reference claims against epic and architecture documents
+
+### 9. Dev Agent Implementation Readiness
+
+- **Self-contained context**: Can the story be implemented without reading external docs?
+- **Clear instructions**: Are implementation steps unambiguous?
+- **Complete technical context**: Are all required technical details present in Dev Notes?
+- **Missing information**: Identify any critical information gaps
+- **Actionability**: Are all tasks actionable by a development agent?
+
+### 10. Generate Validation Report
+
+Provide a structured validation report including:
+
+#### Template Compliance Issues
+
+- Missing sections from story template
+- Unfilled placeholders or template variables
+- Structural formatting issues
+
+#### Critical Issues (Must Fix - Story Blocked)
+
+- Missing essential information for implementation
+- Inaccurate or unverifiable technical claims
+- Incomplete acceptance criteria coverage
+- Missing required sections
+
+#### Should-Fix Issues (Important Quality Improvements)
+
+- Unclear implementation guidance
+- Missing security considerations
+- Task sequencing problems
+- Incomplete testing instructions
+
+#### Nice-to-Have Improvements (Optional Enhancements)
+
+- Additional context that would help implementation
+- Clarifications that would improve efficiency
+- Documentation improvements
+
+#### Anti-Hallucination Findings
+
+- Unverifiable technical claims
+- Missing source references
+- Inconsistencies with architecture documents
+- Invented libraries, patterns, or standards
+
+#### Final Assessment
+
+- **GO**: Story is ready for implementation
+- **NO-GO**: Story requires fixes before implementation
+- **Implementation Readiness Score**: 1-10 scale
+- **Confidence Level**: High/Medium/Low for successful implementation
+==================== END: tasks#validate-next-story ====================
+
 ==================== 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 }}
 
@@ -8706,20 +8869,12 @@ After presenting the report, ask the user if they would like detailed analysis o
 
 ## 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:
+## Change Log
 
-- [ ] {{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]]
-
-{{ 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
 
@@ -8727,29 +8882,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#po-master-checklist ====================

docs/agentic-tools/trae-guide.md

@@ -0,0 +1,14 @@
+# BMad Method Guide for Trae
+
+For the complete workflow, see the [BMad Workflow Guide](../bmad-workflow-guide.md).
+
+## Installation
+
+When running `npx bmad-method install`, select **Trae** as your IDE. This creates:
+
+- `.bmad-core/` folder with all agents
+- `.trae/rules/` folder with agent rule files (`.md`)
+
+## Using BMad Agents in Trae
+
+Type `@agent-name` in chat to activate an agent.

docs/bmad-workflow-guide.md

@@ -22,7 +22,7 @@ The BMad Method follows a structured approach to AI-assisted software developmen
    ```
 
    - Choose "Complete installation"
-   - Select your IDE (Cursor, Claude Code, Windsurf, Roo Code, or Github Copilot)
+   - Select your IDE (Cursor, Claude Code, Windsurf, Trae, Roo Code, or Github Copilot)
 
 2. **Verify installation**:
    - `.bmad-core/` folder created with all agents
@@ -112,12 +112,13 @@ Follow the SM → Dev cycle for systematic story development:
 - **Claude Code**: `/agent-name` (e.g., `/bmad-master`)
 - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
 - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
+- **Trae**: `@agent-name` (e.g., `@bmad-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
 - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 ### Chat Management:
 
-- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 ## Available Agents

docs/user-guide.md

@@ -120,7 +120,7 @@ dependencies:
 **In IDE:**
 
 ```bash
-# Cursor or Windsurf (manual rules - loaded with @)
+# Cursor, Windsurf, or Trae (manual rules - loaded with @)
 @pm Create a PRD for a task management app
 @architect Design the system architecture
 @dev Implement the user authentication
@@ -275,7 +275,7 @@ graph TD
 **Critical Transition Point**: Once the PO confirms document alignment, you must switch from web UI to IDE to begin the development workflow:
 
 1. **Copy Documents to Project**: Ensure `docs/prd.md` and `docs/architecture.md` are in your project
-2. **Switch to IDE**: Open your project in your preferred IDE (Cursor, Claude Code, Windsurf)
+2. **Switch to IDE**: Open your project in your preferred IDE (Cursor, Claude Code, Windsurf, Trae)
 3. **Document Sharding**: Use PO agent to shard large documents into manageable pieces
 4. **Begin Development**: Start the SM/Dev cycle for implementation
 

expansion-packs/bmad-2d-phaser-game-dev/config.yaml

@@ -1,5 +1,5 @@
 name: bmad-2d-phaser-game-dev
-version: 1.3.0
+version: 1.6.0
 short-title: 2D game development with Phaser 3 & TypeScript
 description: >-
   2D Game Development expansion pack for BMad Method - Phaser 3 & TypeScript

expansion-packs/bmad-creator-tools/config.yaml

@@ -1,5 +1,5 @@
 name: bmad-creator-tools
-version: 1.2.0
+version: 1.5.0
 short-title: Tools for creating BMad framework components
 description: Tools for creating and extending BMad framework components.
 author: Brian (BMad)

expansion-packs/bmad-infrastructure-devops/config.yaml

@@ -1,5 +1,5 @@
 name: bmad-infrastructure-devops
-version: 1.2.0
+version: 1.5.0
 short-title: Infrastructure and DevOps capabilities
 description: >-
   This expansion pack extends BMad Method with comprehensive infrastructure and

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "bmad-method",
-  "version": "4.24.5",
+  "version": "4.26.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "bmad-method",
-      "version": "4.24.5",
+      "version": "4.26.0",
       "license": "MIT",
       "dependencies": {
         "@kayvan/markdown-tree-parser": "^1.5.0",

package.json

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

tools/installer/bin/bmad.js

@@ -50,7 +50,7 @@ program
   .option('-f, --full', 'Install complete BMad Method')
   .option('-x, --expansion-only', 'Install only expansion packs (no bmad-core)')
   .option('-d, --directory <path>', 'Installation directory')
-  .option('-i, --ide <ide...>', 'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, roo, cline, gemini, github-copilot, other)')
+  .option('-i, --ide <ide...>', 'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, trae, roo, cline, gemini, github-copilot, other)')
   .option('-e, --expansion-packs <packs...>', 'Install specific expansion packs (can specify multiple)')
   .action(async (options) => {
     try {
@@ -234,6 +234,7 @@ async function promptInstallation() {
         { name: 'Cursor', value: 'cursor' },
         { name: 'Claude Code', value: 'claude-code' },
         { name: 'Windsurf', value: 'windsurf' },
+        { name: 'Trae', value: 'trae' }, // { name: 'Trae', value: 'trae'}
         { name: 'Roo Code', value: 'roo' },
         { name: 'Cline', value: 'cline' },
         { name: 'Gemini CLI', value: 'gemini' },

tools/installer/config/install.config.yaml

@@ -37,6 +37,15 @@ ide-configurations:
       # To use BMad agents in Windsurf:
       # 1. Type @agent-name (e.g., "@dev", "@pm")
       # 2. Windsurf will adopt that agent's persona
+  trae:
+    name: Trae
+    rule-dir: .trae/rules/
+    format: multi-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents in Trae:
+      # 1. Type @agent-name (e.g., "@dev", "@pm", "@architect")
+      # 2. Trae will adopt that agent's persona
   roo:
     name: Roo Code
     format: custom-modes

tools/installer/lib/ide-setup.js

@@ -57,6 +57,8 @@ class IdeSetup {
         return this.setupClaudeCode(installDir, selectedAgent);
       case "windsurf":
         return this.setupWindsurf(installDir, selectedAgent);
+      case "trae":
+        return this.setupTrae(installDir, selectedAgent);
       case "roo":
         return this.setupRoo(installDir, selectedAgent);
       case "cline":
@@ -210,6 +212,55 @@ class IdeSetup {
     return true;
   }
 
+  async setupTrae(installDir, selectedAgent) {
+    const traeRulesDir = path.join(installDir, ".trae", "rules");
+    const agents = selectedAgent? [selectedAgent] : await this.getAllAgentIds(installDir);
+    
+    await fileManager.ensureDirectory(traeRulesDir);
+    
+    for (const agentId of agents) {
+      // Find the agent file
+      const agentPath = await this.findAgentPath(agentId, installDir);
+      
+      if (agentPath) {
+        const agentContent = await fileManager.readFile(agentPath);
+        const mdPath = path.join(traeRulesDir, `${agentId}.md`);
+        
+        // Create MD content (similar to Cursor but without frontmatter)
+        let mdContent = `# ${agentId.toUpperCase()} Agent Rule\n\n`;
+        mdContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${await this.getAgentTitle(
+          agentId,
+          installDir
+        )} agent persona.\n\n`;
+        mdContent += "## Agent Activation\n\n";
+        mdContent +=
+          "CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:\n\n";
+        mdContent += "```yaml\n";
+        // Extract just the YAML content from the agent file
+        const yamlContent = extractYamlFromAgent(agentContent);
+        if (yamlContent) {
+          mdContent += yamlContent;
+        }
+        else {
+          // If no YAML found, include the whole content minus the header
+          mdContent += agentContent.replace(/^#.*$/m, "").trim();
+        }
+        mdContent += "\n```\n\n";
+        mdContent += "## File Reference\n\n";
+        const relativePath = path.relative(installDir, agentPath).replace(/\\/g, '/');
+        mdContent += `The complete agent definition is available in [${relativePath}](${relativePath}).\n\n`;
+        mdContent += "## Usage\n\n";
+        mdContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
+          agentId,
+          installDir
+        )} persona and follow all instructions defined in the YAML configuration above.\n`;
+        
+        await fileManager.writeFile(mdPath, mdContent);
+        console.log(chalk.green(`✓ Created rule: ${agentId}.md`));
+      }
+    }
+  }
+
   async findAgentPath(agentId, installDir) {
     // Try to find the agent file in various locations
     const possiblePaths = [

tools/installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.24.5",
+  "version": "4.26.0",
   "description": "BMad Method installer - AI-powered Agile development framework",
   "main": "lib/installer.js",
   "bin": {

tools/upgraders/v3-to-v4-upgrader.js

@@ -560,6 +560,7 @@ class V3ToV4Upgrader {
         cursor: "Rules created in .cursor/rules/",
         "claude-code": "Commands created in .claude/commands/",
         windsurf: "Rules created in .windsurf/rules/",
+        trae: "Rules created in.trae/rules/",
         roo: "Custom modes created in .roomodes",
         cline: "Rules created in .clinerules/",
       };