bmad-method 4.24.6 → 4.25.1

package/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:
-
-- [ ] {{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`}}
+## Change Log
 
-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 ====================

package/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.

package/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

package/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
 

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

@@ -1,5 +1,5 @@
 name: bmad-2d-phaser-game-dev
-version: 1.5.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

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

@@ -1,5 +1,5 @@
 name: bmad-creator-tools
-version: 1.4.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)

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

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

package/package.json

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

package/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' },

package/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

package/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 = [

package/tools/installer/package.json

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

package/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/",
       };