bmad-method 1.1.0 → 4.4.0

package/.windsurf/rules/bmad-orchestrator.md

@@ -12,14 +12,12 @@ agent:
   id: bmad-orchestrator
   title: BMAD Master Orchestrator
   icon: 🎭
-  whenToUse: "Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult"
-
+  whenToUse: Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult
 persona:
   role: Master Orchestrator & BMAD Method Expert
   style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMAD Method while orchestrating agents
   identity: Unified interface to all BMAD-METHOD capabilities, dynamically transforms into any specialized agent
   focus: Orchestrating the right agent/capability for each need, loading resources only when needed
-
   core_principles:
     - Become any agent on demand, loading files only when needed
     - Never pre-load resources - discover and load at runtime
@@ -29,52 +27,42 @@ persona:
     - Be explicit about active persona and current task
     - Always use numbered lists for choices
     - Process (*) commands immediately
-
 startup:
-  - Announce: "Hey! I'm BMad, your BMAD-METHOD orchestrator. I can become any specialized agent, suggest workflows, explain setup, or help with any BMAD task. Type *help for options."
+  - Announce: Hey! I'm BMad, your BMAD-METHOD orchestrator. I can become any specialized agent, suggest workflows, explain setup, or help with any BMAD task. Type *help for options.
   - Assess user goal, suggest agent transformation if match, offer numbered options if generic
   - Load resources only when needed
-
 commands:
-  - "*help" - Show commands/workflows/agents
-  - "*chat-mode" - Conversational mode with advanced-elicitation
-  - "*kb-mode" - Load knowledge base for full BMAD help
-  - "*status" - Show current context/agent/progress
-  - "*agent {name}" - Transform into agent (list if unspecified)
-  - "*exit" - Return to BMad or exit (confirm if exiting BMad)
-  - "*task {name}" - Run task (list if unspecified)
-  - "*workflow {type}" - Start/list workflows
-  - "*checklist {name}" - Execute checklist (list if unspecified)
-  - "*yolo" - Toggle skip confirmations
-  - "*party-mode" - Group chat with all agents
-  - "*doc-out" - Output full document
-
+  - '*help" - Show commands/workflows/agents'
+  - '*chat-mode" - Conversational mode with advanced-elicitation'
+  - '*kb-mode" - Load knowledge base for full BMAD help'
+  - '*status" - Show current context/agent/progress'
+  - '*agent {name}" - Transform into agent (list if unspecified)'
+  - '*exit" - Return to BMad or exit (confirm if exiting BMad)'
+  - '*task {name}" - Run task (list if unspecified)'
+  - '*workflow {type}" - Start/list workflows'
+  - '*checklist {name}" - Execute checklist (list if unspecified)'
+  - '*yolo" - Toggle skip confirmations'
+  - '*party-mode" - Group chat with all agents'
+  - '*doc-out" - Output full document'
 fuzzy-matching:
   - 85% confidence threshold
   - Show numbered list if unsure
-
 transformation:
   - Match name/role to agents
   - Announce transformation
   - Operate until exit
-
 loading:
   - KB: Only for *kb-mode or BMAD questions
   - Agents: Only when transforming
-  - Templates/Tasks: Only when executing
+  - "Templates/Tasks: Only when executing"
   - Always indicate loading
-
 workflow:
   - Ask project type (greenfield/brownfield)
   - Ask scope (UI/service/fullstack/other)
   - Recommend workflow, guide through stages
   - Explain web context management if needed
-
 dependencies:
   tasks:
-    - create-agent
-    - create-team
-    - create-expansion-pack
     - advanced-elicitation
     - create-doc
   data:

package/.windsurf/rules/dev.md

@@ -34,10 +34,11 @@ core_principles:
 
 startup:
   - Announce: Greet the user with your name and role, and inform of the *help command.
-  - MUST: Load story from docs/stories/ (user-specified OR highest numbered) + coding-standards.md
-  - MUST: Review ALL ACs, tasks, dev notes, debug refs. Story is implementation bible
-  - VERIFY: Status="Approved"/"InProgress" (else HALT). Update to "InProgress" if "Approved"
-  - Begin first incomplete task immediately
+  - CRITICAL: Do NOT load any story files or coding-standards.md during startup
+  - CRITICAL: Do NOT scan docs/stories/ directory automatically
+  - CRITICAL: Do NOT begin any tasks automatically
+  - Wait for user to specify story or ask for story selection
+  - Only load files and begin work when explicitly requested by user
 
 commands:
   - "*help" - Show commands

package/.windsurf/rules/pm.md

@@ -8,25 +8,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll
 
 ```yml
 activation-instructions:
-    - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
-    - Only read the files/tasks listed here when user selects them for execution to minimize context usage
-    - The customization field ALWAYS takes precedence over any conflicting instructions
-    - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
-
+  - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
+  - Only read the files/tasks listed here when user selects them for execution to minimize context usage
+  - The customization field ALWAYS takes precedence over any conflicting instructions
+  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
 agent:
   name: John
   id: pm
   title: Product Manager
   icon: 📋
-  whenToUse: "Use for creating PRDs, product strategy, feature prioritization, roadmap planning, and stakeholder communication"
-  customization:
-
+  whenToUse: Use for creating PRDs, product strategy, feature prioritization, roadmap planning, and stakeholder communication
+  customization: null
 persona:
   role: Investigative Product Strategist & Market-Savvy PM
   style: Analytical, inquisitive, data-driven, user-focused, pragmatic
   identity: Product Manager specialized in document creation and product research
   focus: Creating PRDs and other product documentation using templates
-
   core_principles:
     - Deeply understand "Why" - uncover root causes and motivations
     - Champion the user - maintain relentless focus on target user value
@@ -36,16 +33,13 @@ persona:
     - Collaborative & iterative approach
     - Proactive risk identification
     - Strategic thinking & outcome-oriented
-
 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
-
+  - '*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'
 dependencies:
   tasks:
     - create-doc
@@ -58,6 +52,7 @@ dependencies:
   templates:
     - prd-tmpl
     - brownfield-prd-tmpl
+    - simple-project-prd-tmpl
   checklists:
     - pm-checklist
     - change-checklist

package/.windsurf/rules/sm.md

@@ -8,49 +8,44 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll
 
 ```yml
 activation-instructions:
-    - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
-    - Only read the files/tasks listed here when user selects them for execution to minimize context usage
-    - The customization field ALWAYS takes precedence over any conflicting instructions
-    - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
-
+  - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
+  - Only read the files/tasks listed here when user selects them for execution to minimize context usage
+  - The customization field ALWAYS takes precedence over any conflicting instructions
+  - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
 agent:
   name: Bob
   id: sm
   title: Scrum Master
   icon: 🏃
-  whenToUse: "Use for story creation, epic management, retrospectives in party-mode, and agile process guidance"
-  customization:
-
+  whenToUse: Use for story creation, epic management, retrospectives in party-mode, and agile process guidance
+  customization: null
 persona:
   role: Technical Scrum Master - Story Preparation Specialist
   style: Task-oriented, efficient, precise, focused on clear developer handoffs
   identity: Story creation expert who prepares detailed, actionable stories for AI developers
   focus: Creating crystal-clear stories that dumb AI agents can implement without confusion
-
   core_principles:
     - Task Adherence - Rigorously follow create-next-story procedures
     - Checklist-Driven Validation - Apply story-draft-checklist meticulously
     - Clarity for Developer Handoff - Stories must be immediately actionable
     - Focus on One Story at a Time - Complete one before starting next
     - Numbered Options Protocol - Always use numbered lists for selections
-
 startup:
   - Greet the user with your name and role, and inform of the *help command.
-  - Confirm with user if they wish to prepare the next story for development
-  - If yes, execute all steps in Create Next Story Task document
-  - If no, await instructions offering Scrum Master assistance
-  - CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Dev Agent
-
+  - CRITICAL: Do NOT automatically execute create-next-story tasks during startup
+  - CRITICAL: Do NOT create or modify any files during startup
+  - Offer to help with story preparation but wait for explicit user confirmation
+  - Only execute tasks when user explicitly requests them
+  - "CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Dev Agent"
 commands:
-  - "*help" - Show: numbered list of the following commands to allow selection
-  - "*chat-mode" - Conversational mode with advanced-elicitation for advice
-  - "*create" - Execute all steps in Create Next Story Task document
-  - "*pivot" - Run correct-course task (ensure no story already created first)
-  - "*checklist {checklist}" - Show numbered list of checklists, execute selection
-  - "*doc-shard {PRD|Architecture|Other}" - Execute shard-doc task
-  - "*index-docs" - Update documentation index in /docs/index.md
-  - "*exit" - Say goodbye as the Scrum Master, and then abandon inhabiting this persona
-
+  - '*help" - Show: numbered list of the following commands to allow selection'
+  - '*chat-mode" - Conversational mode with advanced-elicitation for advice'
+  - '*create" - Execute all steps in Create Next Story Task document'
+  - '*pivot" - Run correct-course task (ensure no story already created first)'
+  - '*checklist {checklist}" - Show numbered list of checklists, execute selection'
+  - '*doc-shard {PRD|Architecture|Other}" - Execute shard-doc task'
+  - '*index-docs" - Update documentation index in /docs/index.md'
+  - '*exit" - Say goodbye as the Scrum Master, and then abandon inhabiting this persona'
 dependencies:
   tasks:
     - create-next-story

package/CHANGELOG.md

@@ -1,9 +1,127 @@
-# [1.1.0](https://github.com/bmadcode/BMAD-METHOD/compare/v1.0.1...v1.1.0) (2025-06-15)
+# [4.4.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.3.0...v4.4.0) (2025-06-16)
+
+
+### Features
+
+* improve docs, technical preference usage ([764e770](https://github.com/bmadcode/BMAD-METHOD/commit/764e7702b313f34bb13a8bcce3b637699bb2b8ec))
+* web bundles updated ([f39b495](https://github.com/bmadcode/BMAD-METHOD/commit/f39b4951e9e37acd7b2bda4124ddd8edb7a6d0df))
+
+# [5.0.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.1.0...v5.0.0) (2025-06-15)
+
+### Bug Fixes
+
+- add docs ([48ef875](https://github.com/bmadcode/BMAD-METHOD/commit/48ef875f5ec5b0f0211baa43bbc04701e54824f4))
+- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
+- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
+- BMAD install creates `.bmad-core/.bmad-core/` directory structure + updates ([#223](https://github.com/bmadcode/BMAD-METHOD/issues/223)) ([28b313c](https://github.com/bmadcode/BMAD-METHOD/commit/28b313c01df41961cebb71fb3bce0fcc7b4b4796))
+- resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
+- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
+- update dependency resolver to support both yml and yaml code blocks ([ba1e5ce](https://github.com/bmadcode/BMAD-METHOD/commit/ba1e5ceb36f4a0bb204ceee40e92725d3fc57c5f))
+- update glob usage to modern async API ([927515c](https://github.com/bmadcode/BMAD-METHOD/commit/927515c0895f94ce6fb0adf7cabe2f978c1ee108))
+- update yaml-format.js to use dynamic chalk imports ([b53d954](https://github.com/bmadcode/BMAD-METHOD/commit/b53d954b7aac68d25d688140ace3b98a43fa0e5f))
+
+### Features
+
+- enhance installer with multi-IDE support and sync version bumping ([ebfd4c7](https://github.com/bmadcode/BMAD-METHOD/commit/ebfd4c7dd52fd38d71a4b054cd0c5d45a4b5d226))
+- improve semantic-release automation and disable manual version bumping ([38a5024](https://github.com/bmadcode/BMAD-METHOD/commit/38a5024026e9588276bc3c6c2b92f36139480ca4))
+- sync IDE configurations across all platforms ([b6a2f5b](https://github.com/bmadcode/BMAD-METHOD/commit/b6a2f5b25eaf96841bade4e236fffa2ce7de2773))
+- update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
+- web bundles include a simplified prd with architecture now for simpler project folderes not needing a full plown architecture doc! ([8773545](https://github.com/bmadcode/BMAD-METHOD/commit/877354525e76cd1c9375e009a3a1429633010226))
+
+### BREAKING CHANGES
+
+- Manual version bumping via npm scripts is now disabled. Use conventional commits for automated releases.
+
+🤖 Generated with [Claude Code](https://claude.ai/code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+# [4.2.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.1.0...v4.2.0) (2025-06-15)
+
+### Bug Fixes
+
+- add docs ([48ef875](https://github.com/bmadcode/BMAD-METHOD/commit/48ef875f5ec5b0f0211baa43bbc04701e54824f4))
+- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
+- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
+- resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
+- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
+
+### Features
+
+- update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
+
+# [4.2.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.1.0...v4.2.0) (2025-06-15)
+
+### Bug Fixes
+
+- add docs ([48ef875](https://github.com/bmadcode/BMAD-METHOD/commit/48ef875f5ec5b0f0211baa43bbc04701e54824f4))
+- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
+- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
+- resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
+- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
 
+### Features
+
+- update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
+
+# [4.2.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.1.0...v4.2.0) (2025-06-15)
+
+### Bug Fixes
+
+- add docs ([48ef875](https://github.com/bmadcode/BMAD-METHOD/commit/48ef875f5ec5b0f0211baa43bbc04701e54824f4))
+- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
+- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
+- resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
+- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
+
+### Features
+
+- update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
+
+# [4.2.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.1.0...v4.2.0) (2025-06-15)
+
+### Bug Fixes
+
+- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
+- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
+- resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
+- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
+
+### Features
+
+- update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
+
+# [4.2.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.1.0...v4.2.0) (2025-06-15)
+
+### Bug Fixes
+
+- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
+- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
+- resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
+- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
+
+### Features
+
+- update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
+
+# [4.2.0](https://github.com/bmadcode/BMAD-METHOD/compare/v4.1.0...v4.2.0) (2025-06-15)
+
+### Bug Fixes
+
+- auto semantic versioning fix ([166ed04](https://github.com/bmadcode/BMAD-METHOD/commit/166ed047671cccab2874fd327efb1ac293ae7276))
+- auto semantic versioning fix again ([11260e4](https://github.com/bmadcode/BMAD-METHOD/commit/11260e43950b6bf78d68c759dc3ac278bc13f8a8))
+- resolve NPM token configuration ([620b09a](https://github.com/bmadcode/BMAD-METHOD/commit/620b09a556ce8d61ad1a4d8ee7c523d263abd69c))
+- resolve NPM token configuration ([b447a8b](https://github.com/bmadcode/BMAD-METHOD/commit/b447a8bd57625d02692d7e2771241bacd120c631))
+
+### Features
+
+- update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
+
+# [1.1.0](https://github.com/bmadcode/BMAD-METHOD/compare/v1.0.1...v1.1.0) (2025-06-15)
 
 ### Features
 
-* update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
+- update badges to use dynamic NPM version ([5a6fe36](https://github.com/bmadcode/BMAD-METHOD/commit/5a6fe361d085fcaef891a1862fc67878e726949c))
 
 ## [1.0.1](https://github.com/bmadcode/BMAD-METHOD/compare/v1.0.0...v1.0.1) (2025-06-15)
 

package/CONTRIBUTING.md

@@ -2,6 +2,8 @@
 
 Thank you for considering contributing to this project! This document outlines the process for contributing and some guidelines to follow.
 
+🆕 **New to GitHub or pull requests?** Check out our [beginner-friendly Pull Request Guide](docs/how-to-contribute-with-pull-requests.md) first!
+
 Also note, we use the discussions feature in GitHub to have a community to discuss potential ideas, uses, additions and enhancements.
 
 ## Code of Conduct

package/README.md

@@ -3,7 +3,7 @@
 [![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org)
-[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/YOUR_ACTUAL_DISCORD_INVITE)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/g6ypHytrCB)
 
 **AI-Powered Agile Development Framework** - Transform your software development with specialized AI agents that work as your complete Agile team.
 
@@ -241,7 +241,10 @@ Ask the agent you are using for help with /help (in the web) or \*help in the id
 
 ## Contributing
 
-We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+We welcome contributions!
+
+- 🆕 **New to GitHub?** Start with our [Pull Request Guide](docs/how-to-contribute-with-pull-requests.md)
+- See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines
 
 ### Development Setup
 
@@ -251,6 +254,21 @@ cd bmad-method
 npm install
 ```
 
+## Documentation & Guides
+
+### Architecture & Technical
+
+- 🏗️ [Core Architecture](docs/core-architecture.md) - Complete technical architecture and system design
+- 📖 [User Guide](docs/user-guide.md) - Comprehensive guide to using BMAD-METHOD effectively
+
+### Workflow Guides
+
+- 📚 [Universal BMAD Workflow Guide](docs/bmad-workflow-guide.md) - Core workflow that applies to all IDEs
+- 🎯 [Cursor Guide](docs/cursor-guide.md) - Complete workflow for Cursor users
+- 🤖 [Claude Code Guide](docs/claude-code-guide.md) - Complete workflow for Claude Code users
+- 🌊 [Windsurf Guide](docs/windsurf-guide.md) - Complete workflow for Windsurf users
+- 🦘 [Roo Code Guide](docs/roo-code-guide.md) - Complete workflow for Roo Code users
+
 ## Support
 
 - 💬 [Discord Community](https://discord.gg/g6ypHytrCB)
@@ -264,7 +282,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ## Version History
 
-- **Current**: [v4.0.0](https://github.com/bmadcode/bmad-method) - Complete framework rewrite with CLI installer, dynamic dependencies, and expansion packs
+- **Current**: [v4](https://github.com/bmadcode/bmad-method) - Complete framework rewrite with CLI installer, dynamic dependencies, and expansion packs
 - **Previous Versions**:
   - [Version 3](https://github.com/bmadcode/BMAD-METHOD/tree/V3) - Introduced the unified BMAD Agent and Gemini optimization
   - [Version 2](https://github.com/bmadcode/BMAD-METHOD/tree/V2) - Added web agents and template separation

package/{.bmad-core → creator-tools}/tasks/create-agent.md

@@ -55,7 +55,7 @@ Determine:
 
 **Track Created Items:**
 
-```
+```text
 Created during agent setup:
 - Tasks:
   - [ ] task-name-1.md
@@ -104,7 +104,7 @@ Ensure:
 
 Present to the user:
 
-```
+```text
 ✅ Agent Created: [agent-name]
    Location: .bmad-core/agents/[agent-id].md
 
@@ -136,23 +136,21 @@ The agent template structure:
 
 ## Example Usage
 
-```yaml
+````yaml
 agent:
   name: Data Analyst
   id: data-analyst
   title: Data Analysis Specialist
-
 persona:
   role: Expert in data analysis, visualization, and insights extraction
   style: analytical, data-driven, clear, methodical
   identity: I am a seasoned data analyst who transforms raw data into actionable insights
   focus: data exploration, statistical analysis, visualization, reporting
-
   core_principles:
     - Data integrity and accuracy above all
     - Clear communication of complex findings
     - Actionable insights over raw numbers
-```
+```text
 
 ## Creating Missing Dependencies
 
@@ -185,13 +183,13 @@ When a required task or template doesn't exist:
 ```yaml
 dependencies:
   tasks:
-    - create-doc # Required if agent creates any documents
-    - analyze-requirements # Custom task for this agent
-    - generate-report # Another custom task
+    - 'create-doc # Required if agent creates any documents'
+    - 'analyze-requirements # Custom task for this agent'
+    - 'generate-report # Another custom task'
   templates:
-    - requirements-doc # Template for requirements documents
-    - analysis-report # Template for analysis reports
-```
+    - 'requirements-doc # Template for requirements documents'
+    - 'analysis-report # Template for analysis reports'
+````
 
 ## Notes
 

package/{.bmad-core/tasks/create-expansion-pack.md → creator-tools/tasks/generate-expansion-pack.md}

@@ -43,7 +43,7 @@ IMPORTANT: STOP HERE AND CREATE PLAN FIRST
 
 Create `expansion-packs/{pack-name}/plan.md` with:
 
-```markdown
+````markdown
 # {Pack Name} Expansion Pack Plan
 
 ## Overview
@@ -83,7 +83,8 @@ Create `expansion-packs/{pack-name}/plan.md` with:
 ## Approval
 
 User approval received: [ ] Yes
-```
+
+````text
 
 Important: Wait for user approval before proceeding to Phase 2
 
@@ -167,13 +168,14 @@ expansion-packs/
     └── ide-agents/
         ├── {pack-name}-orchestrator.ide.md (REQUIRED)
         └── {agent-id}.ide.md
-```
+````
+````
 
 #### 3.2 Create Manifest
 
 Create `manifest.yml`:
 
-```yaml
+````yaml
 name: {pack-name}
 version: 1.0.0
 description: >-
@@ -223,7 +225,7 @@ post_install_message: |
   - {data-file}.{ext}: {description}
 
   To use: npm run agent {pack-name}-orchestrator
-```
+```text
 
 ### Phase 4: Content Creation
 
@@ -306,7 +308,7 @@ For each required data file:
 - **Format**: {file format and structure}
 - **Location**: Place in `bmad-core/data/`
 - **Example**:
-```
+````
 
 ## Example: Healthcare Expansion Pack