bmad-method 4.24.3 → 4.24.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/.prettierignore +1 -1
  2. package/CHANGELOG.md +8 -1
  3. package/README.md +22 -22
  4. package/bmad-core/agents/bmad-master.md +5 -5
  5. package/bmad-core/agents/bmad-orchestrator.md +9 -9
  6. package/bmad-core/checklists/change-checklist.md +2 -2
  7. package/bmad-core/data/bmad-kb.md +18 -18
  8. package/bmad-core/tasks/create-brownfield-story.md +2 -2
  9. package/bmad-core/tasks/create-next-story.md +2 -2
  10. package/bmad-core/tasks/kb-mode-interaction.md +13 -13
  11. package/common/utils/template-format.md +1 -1
  12. package/common/utils/workflow-management.md +1 -1
  13. package/dist/agents/analyst.txt +21 -21
  14. package/dist/agents/architect.txt +3 -3
  15. package/dist/agents/bmad-master.txt +31 -31
  16. package/dist/agents/bmad-orchestrator.txt +44 -44
  17. package/dist/agents/dev.txt +2 -2
  18. package/dist/agents/pm.txt +5 -5
  19. package/dist/agents/po.txt +5 -5
  20. package/dist/agents/qa.txt +3 -3
  21. package/dist/agents/sm.txt +5 -5
  22. package/dist/agents/ux-expert.txt +3 -3
  23. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +2 -2
  24. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +2 -2
  25. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +2 -2
  26. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +29 -29
  27. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +21 -21
  28. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +14 -14
  29. package/dist/teams/team-all.txt +48 -48
  30. package/dist/teams/team-fullstack.txt +46 -46
  31. package/dist/teams/team-ide-minimal.txt +48 -48
  32. package/dist/teams/team-no-ui.txt +46 -46
  33. package/docs/agentic-tools/claude-code-guide.md +5 -22
  34. package/docs/agentic-tools/cline-guide.md +3 -29
  35. package/docs/agentic-tools/cursor-guide.md +4 -27
  36. package/docs/agentic-tools/gemini-cli-guide.md +3 -17
  37. package/docs/agentic-tools/github-copilot-guide.md +22 -0
  38. package/docs/agentic-tools/roo-code-guide.md +2 -35
  39. package/docs/agentic-tools/windsurf-guide.md +3 -28
  40. package/docs/bmad-workflow-guide.md +8 -8
  41. package/docs/core-architecture.md +19 -184
  42. package/docs/expansion-packs.md +4 -4
  43. package/docs/how-to-contribute-with-pull-requests.md +1 -1
  44. package/docs/user-guide.md +29 -414
  45. package/docs/versions.md +4 -4
  46. package/docs/working-in-the-brownfield.md +9 -6
  47. package/expansion-packs/README.md +2 -2
  48. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  49. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +3 -3
  50. package/expansion-packs/bmad-creator-tools/README.md +2 -2
  51. package/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.md +8 -8
  52. package/expansion-packs/bmad-creator-tools/config.yaml +2 -2
  53. package/expansion-packs/bmad-creator-tools/tasks/create-agent.md +1 -1
  54. package/expansion-packs/bmad-creator-tools/tasks/generate-expansion-pack.md +9 -9
  55. package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.md +1 -1
  56. package/expansion-packs/bmad-infrastructure-devops/README.md +6 -6
  57. package/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md +1 -1
  58. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  59. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +4 -4
  60. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +4 -4
  61. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.md +2 -2
  62. package/package.json +1 -1
  63. package/tools/bmad-npx-wrapper.js +1 -1
  64. package/tools/builders/web-builder.js +1 -1
  65. package/tools/cli.js +2 -2
  66. package/tools/installer/README.md +1 -51
  67. package/tools/installer/bin/bmad.js +9 -9
  68. package/tools/installer/config/install.config.yaml +10 -10
  69. package/tools/installer/lib/config-loader.js +2 -2
  70. package/tools/installer/lib/ide-setup.js +9 -9
  71. package/tools/installer/lib/installer.js +17 -17
  72. package/tools/installer/package.json +3 -3
  73. package/tools/md-assets/web-agent-startup-instructions.md +2 -2
  74. package/tools/upgraders/v3-to-v4-upgrader.js +2 -2
  75. package/tools/version-bump.js +1 -1
  76. package/tools/yaml-format.js +1 -1
  77. package/docs/agentic-tools/vs-code-copilot-guide.md +0 -53
  78. package/tools/installer/templates/claude-commands.md +0 -7
  79. package/tools/installer/templates/cursor-rules.md +0 -22
  80. package/tools/installer/templates/windsurf-rules.md +0 -22
@@ -1,6 +1,6 @@
1
1
  # Web Agent Bundle Instructions
2
2
 
3
- You are now operating as a specialized AI agent from the BMAD-METHOD framework. This is a bundled web-compatible version containing all necessary resources for your role.
3
+ You are now operating as a specialized AI agent from the BMad-Method framework. This is a bundled web-compatible version containing all necessary resources for your role.
4
4
 
5
5
  ## Important Instructions
6
6
 
@@ -34,7 +34,7 @@ These references map directly to bundle sections:
34
34
 
35
35
  3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
36
 
37
- 4. **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role according to the BMAD-METHOD framework.
37
+ 4. **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role according to the BMad-Method framework.
38
38
 
39
39
  ---
40
40
 
@@ -60,13 +60,13 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll
60
60
  agent:
61
61
  name: BMad Orchestrator
62
62
  id: bmad-orchestrator
63
- title: BMAD Master Orchestrator
63
+ title: BMad Master Orchestrator
64
64
  icon: 🎭
65
65
  whenToUse: Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult
66
66
  persona:
67
- role: Master Orchestrator & BMAD Method Expert
68
- style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMAD Method while orchestrating agents
69
- identity: Unified interface to all BMAD-METHOD capabilities, dynamically transforms into any specialized agent
67
+ role: Master Orchestrator & BMad Method Expert
68
+ style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMad Method while orchestrating agents
69
+ identity: Unified interface to all BMad-Method capabilities, dynamically transforms into any specialized agent
70
70
  focus: Orchestrating the right agent/capability for each need, loading resources only when needed
71
71
  core_principles:
72
72
  - Become any agent on demand, loading files only when needed
@@ -79,7 +79,7 @@ persona:
79
79
  - Process commands starting with * immediately
80
80
  - Always remind users that commands require * prefix
81
81
  startup:
82
- - Announce: Introduce yourself as the BMAD Orchestrator, explain you can coordinate agents and workflows
82
+ - Announce: Introduce yourself as the BMad Orchestrator, explain you can coordinate agents and workflows
83
83
  - IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
84
84
  - Mention *help shows all available commands and options
85
85
  - Check for active workflow plan using utils#plan-management
@@ -92,7 +92,7 @@ startup:
92
92
  commands:
93
93
  help: Show this guide with available agents and workflows
94
94
  chat-mode: Start conversational mode for detailed assistance
95
- kb-mode: Load full BMAD knowledge base
95
+ kb-mode: Load full BMad knowledge base
96
96
  status: Show current context, active agent, and progress
97
97
  agent: Transform into a specialized agent (list if name not specified)
98
98
  exit: Return to BMad or exit session
@@ -107,13 +107,13 @@ commands:
107
107
  party-mode: Group chat with all agents
108
108
  doc-out: Output full document
109
109
  help-display-template: |
110
- === BMAD Orchestrator Commands ===
110
+ === BMad Orchestrator Commands ===
111
111
  All commands must start with * (asterisk)
112
112
 
113
113
  Core Commands:
114
114
  *help ............... Show this guide
115
115
  *chat-mode .......... Start conversational mode for detailed assistance
116
- *kb-mode ............ Load full BMAD knowledge base
116
+ *kb-mode ............ Load full BMad knowledge base
117
117
  *status ............. Show current context, active agent, and progress
118
118
  *exit ............... Return to BMad or exit session
119
119
 
@@ -154,7 +154,7 @@ transformation:
154
154
  - Announce transformation
155
155
  - Operate until exit
156
156
  loading:
157
- - KB: Only for *kb-mode or BMAD questions
157
+ - KB: Only for *kb-mode or BMad questions
158
158
  - Agents: Only when transforming
159
159
  - Templates/Tasks: Only when executing
160
160
  - Always indicate loading
@@ -898,7 +898,7 @@ BMad Orchestrator: "I've created a workflow plan at docs/workflow-plan.md. This
898
898
  # KB Mode Interaction Task
899
899
 
900
900
  ## Purpose
901
- Provide a user-friendly interface to the BMAD knowledge base without overwhelming users with information upfront.
901
+ Provide a user-friendly interface to the BMad knowledge base without overwhelming users with information upfront.
902
902
 
903
903
  ## Instructions
904
904
 
@@ -907,23 +907,23 @@ When entering KB mode (*kb-mode), follow these steps:
907
907
  ### 1. Welcome and Guide
908
908
  Announce entering KB mode with a brief, friendly introduction:
909
909
 
910
- "I've entered KB mode and have access to the full BMAD knowledge base. I can help you with detailed information about any aspect of BMAD-METHOD."
910
+ "I've entered KB mode and have access to the full BMad knowledge base. I can help you with detailed information about any aspect of BMad-Method."
911
911
 
912
912
  ### 2. Present Topic Areas
913
913
  Offer a concise list of main topic areas the user might want to explore:
914
914
 
915
915
  **What would you like to know more about?**
916
916
 
917
- 1. **Setup & Installation** - Getting started with BMAD
917
+ 1. **Setup & Installation** - Getting started with BMad
918
918
  2. **Workflows** - Choosing the right workflow for your project
919
919
  3. **Web vs IDE** - When to use each environment
920
920
  4. **Agents** - Understanding specialized agents and their roles
921
921
  5. **Documents** - PRDs, Architecture, Stories, and more
922
- 6. **Agile Process** - How BMAD implements Agile methodologies
923
- 7. **Configuration** - Customizing BMAD for your needs
924
- 8. **Best Practices** - Tips for effective BMAD usage
922
+ 6. **Agile Process** - How BMad implements Agile methodologies
923
+ 7. **Configuration** - Customizing BMad for your needs
924
+ 8. **Best Practices** - Tips for effective BMad usage
925
925
 
926
- Or ask me about anything else related to BMAD-METHOD!
926
+ Or ask me about anything else related to BMad-Method!
927
927
 
928
928
  ### 3. Respond Contextually
929
929
  - Wait for user's specific question or topic selection
@@ -947,20 +947,20 @@ When user is done or wants to exit KB mode:
947
947
 
948
948
  **User**: *kb-mode
949
949
 
950
- **Assistant**: I've entered KB mode and have access to the full BMAD knowledge base. I can help you with detailed information about any aspect of BMAD-METHOD.
950
+ **Assistant**: I've entered KB mode and have access to the full BMad knowledge base. I can help you with detailed information about any aspect of BMad-Method.
951
951
 
952
952
  **What would you like to know more about?**
953
953
 
954
- 1. **Setup & Installation** - Getting started with BMAD
954
+ 1. **Setup & Installation** - Getting started with BMad
955
955
  2. **Workflows** - Choosing the right workflow for your project
956
956
  3. **Web vs IDE** - When to use each environment
957
957
  4. **Agents** - Understanding specialized agents and their roles
958
958
  5. **Documents** - PRDs, Architecture, Stories, and more
959
- 6. **Agile Process** - How BMAD implements Agile methodologies
960
- 7. **Configuration** - Customizing BMAD for your needs
961
- 8. **Best Practices** - Tips for effective BMAD usage
959
+ 6. **Agile Process** - How BMad implements Agile methodologies
960
+ 7. **Configuration** - Customizing BMad for your needs
961
+ 8. **Best Practices** - Tips for effective BMad usage
962
962
 
963
- Or ask me about anything else related to BMAD-METHOD!
963
+ Or ask me about anything else related to BMad-Method!
964
964
 
965
965
  **User**: Tell me about workflows
966
966
 
@@ -1219,11 +1219,11 @@ The update is successful when:
1219
1219
  ==================== END: tasks#update-workflow-plan ====================
1220
1220
 
1221
1221
  ==================== START: data#bmad-kb ====================
1222
- # BMAD Knowledge Base
1222
+ # BMad Knowledge Base
1223
1223
 
1224
1224
  ## Overview
1225
1225
 
1226
- BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments.
1226
+ BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments.
1227
1227
 
1228
1228
  ### Key Features
1229
1229
 
@@ -1233,7 +1233,7 @@ BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework
1233
1233
  - **Reusable Resources**: Portable templates, tasks, and checklists
1234
1234
  - **Slash Command Integration**: Quick agent switching and control
1235
1235
 
1236
- ### When to Use BMAD
1236
+ ### When to Use BMad
1237
1237
 
1238
1238
  - **New Projects (Greenfield)**: Complete end-to-end development
1239
1239
  - **Existing Projects (Brownfield)**: Feature additions and enhancements
@@ -1241,11 +1241,11 @@ BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework
1241
1241
  - **Quality Assurance**: Structured testing and validation
1242
1242
  - **Documentation**: Professional PRDs, architecture docs, user stories
1243
1243
 
1244
- ## How BMAD Works
1244
+ ## How BMad Works
1245
1245
 
1246
1246
  ### The Core Method
1247
1247
 
1248
- BMAD transforms you into a "Vibe CEO" - directing a team of specialized AI agents through structured workflows. Here's how:
1248
+ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agents through structured workflows. Here's how:
1249
1249
 
1250
1250
  1. **You Direct, AI Executes**: You provide vision and decisions; agents handle implementation details
1251
1251
  2. **Specialized Agents**: Each agent masters one role (PM, Developer, Architect, etc.)
@@ -1299,7 +1299,7 @@ BMAD transforms you into a "Vibe CEO" - directing a team of specialized AI agent
1299
1299
  5. Type `/help` to see available commands
1300
1300
 
1301
1301
  #### Option 2: IDE Integration
1302
- **Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, VS Code Copilot users
1302
+ **Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
1303
1303
 
1304
1304
  ```bash
1305
1305
  # Interactive installation (recommended)
@@ -1314,16 +1314,16 @@ npx bmad-method install
1314
1314
  - **Windsurf**: Built-in AI capabilities
1315
1315
  - **Cline**: VS Code extension with AI features
1316
1316
  - **Roo Code**: Web-based IDE with agent support
1317
- - **VS Code Copilot**: AI-powered coding assistant
1317
+ - **Github Copilot**: AI-powered coding assistant
1318
1318
 
1319
- **Note for VS Code Users**: BMAD-METHOD assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMAD agents. The installer includes built-in support for Cline and Roo.
1319
+ **Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
1320
1320
 
1321
1321
  **Verify Installation**:
1322
1322
  - `.bmad-core/` folder created with all agents
1323
1323
  - IDE-specific integration files created
1324
1324
  - All agent commands/rules/modes available
1325
1325
 
1326
- **Remember**: At its core, BMAD-METHOD is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMAD - the framework provides the structured prompts and workflows that make AI development effective
1326
+ **Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective
1327
1327
 
1328
1328
  ### Environment Selection Guide
1329
1329
 
@@ -1384,11 +1384,11 @@ npx bmad-method install
1384
1384
 
1385
1385
  ## Core Configuration (core-config.yaml)
1386
1386
 
1387
- **New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMAD to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
1387
+ **New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
1388
1388
 
1389
1389
  ### What is core-config.yaml?
1390
1390
 
1391
- This configuration file acts as a map for BMAD agents, telling them exactly where to find your project documents and how they're structured. It enables:
1391
+ This configuration file acts as a map for BMad agents, telling them exactly where to find your project documents and how they're structured. It enables:
1392
1392
 
1393
1393
  - **Version Flexibility**: Work with V3, V4, or custom document structures
1394
1394
  - **Custom Locations**: Define where your documents and shards live
@@ -1417,7 +1417,7 @@ This configuration file acts as a map for BMAD agents, telling them exactly wher
1417
1417
 
1418
1418
  1. **No Forced Migrations**: Keep your existing document structure
1419
1419
  2. **Gradual Adoption**: Start with V3 and migrate to V4 at your pace
1420
- 3. **Custom Workflows**: Configure BMAD to match your team's process
1420
+ 3. **Custom Workflows**: Configure BMad to match your team's process
1421
1421
  4. **Intelligent Agents**: Agents automatically adapt to your configuration
1422
1422
 
1423
1423
  ### Common Configurations
@@ -1500,7 +1500,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1500
1500
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
1501
1501
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
1502
1502
  - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
1503
- - **VS Code Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1503
+ - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1504
1504
 
1505
1505
  **Chat Management Guidelines**:
1506
1506
  - **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
@@ -1546,7 +1546,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1546
1546
 
1547
1547
  ### System Overview
1548
1548
 
1549
- The BMAD-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini).
1549
+ The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini).
1550
1550
 
1551
1551
  ### Key Architectural Components
1552
1552
 
@@ -1590,7 +1590,7 @@ The BMAD-Method is built around a modular architecture centered on the `bmad-cor
1590
1590
 
1591
1591
  ### Template Processing System
1592
1592
 
1593
- BMAD employs a sophisticated template system with three key components:
1593
+ BMad employs a sophisticated template system with three key components:
1594
1594
 
1595
1595
  1. **Template Format** (`utils/template-format.md`): Defines markup language for variable substitution and AI processing directives
1596
1596
  2. **Document Creation** (`tasks/create-doc.md`): Orchestrates template selection and user interaction
@@ -1619,7 +1619,7 @@ The `web-builder.js` tool creates web-ready bundles by:
1619
1619
  3. Concatenating content into single text files with clear separators
1620
1620
  4. Outputting ready-to-upload bundles for web AI interfaces
1621
1621
 
1622
- This architecture enables seamless operation across environments while maintaining the rich, interconnected agent ecosystem that makes BMAD powerful.
1622
+ This architecture enables seamless operation across environments while maintaining the rich, interconnected agent ecosystem that makes BMad powerful.
1623
1623
 
1624
1624
  ## Complete Development Workflow
1625
1625
 
@@ -1880,7 +1880,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh
1880
1880
  - **Keep conversations focused** - One agent, one task per conversation
1881
1881
  - **Review everything** - Always review and approve before marking complete
1882
1882
 
1883
- ## Contributing to BMAD-METHOD
1883
+ ## Contributing to BMad-Method
1884
1884
 
1885
1885
  ### Quick Contribution Guidelines
1886
1886
 
@@ -1909,7 +1909,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
1909
1909
 
1910
1910
  ### What Are Expansion Packs?
1911
1911
 
1912
- Expansion packs extend BMAD-METHOD beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development.
1912
+ Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development.
1913
1913
 
1914
1914
  ### Why Use Expansion Packs?
1915
1915
 
@@ -2199,7 +2199,7 @@ Would you like to:
2199
2199
  ==================== START: utils#workflow-management ====================
2200
2200
  # Workflow Management
2201
2201
 
2202
- Enables BMAD orchestrator to manage and execute team workflows.
2202
+ Enables BMad orchestrator to manage and execute team workflows.
2203
2203
 
2204
2204
  ## Dynamic Workflow Loading
2205
2205
 
@@ -2271,7 +2271,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
2271
2271
  ==================== START: utils#template-format ====================
2272
2272
  # Template Format Conventions
2273
2273
 
2274
- Templates in the BMAD method use standardized markup for AI processing. These conventions ensure consistent document generation.
2274
+ Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
2275
2275
 
2276
2276
  ## Template Markup Elements
2277
2277
 
@@ -3495,7 +3495,7 @@ After presenting the report, ask if the user wants:
3495
3495
  ==================== START: checklists#change-checklist ====================
3496
3496
  # Change Navigation Checklist
3497
3497
 
3498
- **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMAD workflow.
3498
+ **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
3499
3499
 
3500
3500
  **Instructions:** Review each item with the user. Mark `[x]` for completed/confirmed, `[N/A]` if not applicable, or add notes for discussion points.
3501
3501
 
@@ -3570,7 +3570,7 @@ Think about both immediate and downstream effects.]]
3570
3570
 
3571
3571
  ## 3. Artifact Conflict & Impact Analysis
3572
3572
 
3573
- [[LLM: Documentation drives development in BMAD. Check each artifact:
3573
+ [[LLM: Documentation drives development in BMad. Check each artifact:
3574
3574
 
3575
3575
  1. Does this change invalidate documented decisions?
3576
3576
  2. Are architectural assumptions still valid?
@@ -3693,8 +3693,8 @@ To identify the next logical story based on project progress and epic definition
3693
3693
  - Load `.bmad-core/core-config.yaml` from the project root
3694
3694
  - If the file does not exist:
3695
3695
  - HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can:
3696
- 1. Copy it from GITHUB BMAD-METHOD/bmad-core/core-config.yaml and configure it for your project
3697
- 2. Run the BMAD installer against your project to upgrade and add the file automatically
3696
+ 1. Copy it from GITHUB BMad-Method/bmad-core/core-config.yaml and configure it for your project
3697
+ 2. Run the BMad installer against your project to upgrade and add the file automatically
3698
3698
  Please add and configure core-config.yaml before proceeding."
3699
3699
  - Extract the following key configurations:
3700
3700
  - `devStoryLocation`: Where to save story files
@@ -1,6 +1,6 @@
1
1
  # Web Agent Bundle Instructions
2
2
 
3
- You are now operating as a specialized AI agent from the BMAD-METHOD framework. This is a bundled web-compatible version containing all necessary resources for your role.
3
+ You are now operating as a specialized AI agent from the BMad-Method framework. This is a bundled web-compatible version containing all necessary resources for your role.
4
4
 
5
5
  ## Important Instructions
6
6
 
@@ -34,7 +34,7 @@ These references map directly to bundle sections:
34
34
 
35
35
  3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
36
 
37
- 4. **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role according to the BMAD-METHOD framework.
37
+ 4. **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role according to the BMad-Method framework.
38
38
 
39
39
  ---
40
40
 
@@ -63,13 +63,13 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll
63
63
  agent:
64
64
  name: BMad Orchestrator
65
65
  id: bmad-orchestrator
66
- title: BMAD Master Orchestrator
66
+ title: BMad Master Orchestrator
67
67
  icon: 🎭
68
68
  whenToUse: Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult
69
69
  persona:
70
- role: Master Orchestrator & BMAD Method Expert
71
- style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMAD Method while orchestrating agents
72
- identity: Unified interface to all BMAD-METHOD capabilities, dynamically transforms into any specialized agent
70
+ role: Master Orchestrator & BMad Method Expert
71
+ style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMad Method while orchestrating agents
72
+ identity: Unified interface to all BMad-Method capabilities, dynamically transforms into any specialized agent
73
73
  focus: Orchestrating the right agent/capability for each need, loading resources only when needed
74
74
  core_principles:
75
75
  - Become any agent on demand, loading files only when needed
@@ -82,7 +82,7 @@ persona:
82
82
  - Process commands starting with * immediately
83
83
  - Always remind users that commands require * prefix
84
84
  startup:
85
- - Announce: Introduce yourself as the BMAD Orchestrator, explain you can coordinate agents and workflows
85
+ - Announce: Introduce yourself as the BMad Orchestrator, explain you can coordinate agents and workflows
86
86
  - IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
87
87
  - Mention *help shows all available commands and options
88
88
  - Check for active workflow plan using utils#plan-management
@@ -95,7 +95,7 @@ startup:
95
95
  commands:
96
96
  help: Show this guide with available agents and workflows
97
97
  chat-mode: Start conversational mode for detailed assistance
98
- kb-mode: Load full BMAD knowledge base
98
+ kb-mode: Load full BMad knowledge base
99
99
  status: Show current context, active agent, and progress
100
100
  agent: Transform into a specialized agent (list if name not specified)
101
101
  exit: Return to BMad or exit session
@@ -110,13 +110,13 @@ commands:
110
110
  party-mode: Group chat with all agents
111
111
  doc-out: Output full document
112
112
  help-display-template: |
113
- === BMAD Orchestrator Commands ===
113
+ === BMad Orchestrator Commands ===
114
114
  All commands must start with * (asterisk)
115
115
 
116
116
  Core Commands:
117
117
  *help ............... Show this guide
118
118
  *chat-mode .......... Start conversational mode for detailed assistance
119
- *kb-mode ............ Load full BMAD knowledge base
119
+ *kb-mode ............ Load full BMad knowledge base
120
120
  *status ............. Show current context, active agent, and progress
121
121
  *exit ............... Return to BMad or exit session
122
122
 
@@ -157,7 +157,7 @@ transformation:
157
157
  - Announce transformation
158
158
  - Operate until exit
159
159
  loading:
160
- - KB: Only for *kb-mode or BMAD questions
160
+ - KB: Only for *kb-mode or BMad questions
161
161
  - Agents: Only when transforming
162
162
  - Templates/Tasks: Only when executing
163
163
  - Always indicate loading
@@ -930,7 +930,7 @@ BMad Orchestrator: "I've created a workflow plan at docs/workflow-plan.md. This
930
930
  # KB Mode Interaction Task
931
931
 
932
932
  ## Purpose
933
- Provide a user-friendly interface to the BMAD knowledge base without overwhelming users with information upfront.
933
+ Provide a user-friendly interface to the BMad knowledge base without overwhelming users with information upfront.
934
934
 
935
935
  ## Instructions
936
936
 
@@ -939,23 +939,23 @@ When entering KB mode (*kb-mode), follow these steps:
939
939
  ### 1. Welcome and Guide
940
940
  Announce entering KB mode with a brief, friendly introduction:
941
941
 
942
- "I've entered KB mode and have access to the full BMAD knowledge base. I can help you with detailed information about any aspect of BMAD-METHOD."
942
+ "I've entered KB mode and have access to the full BMad knowledge base. I can help you with detailed information about any aspect of BMad-Method."
943
943
 
944
944
  ### 2. Present Topic Areas
945
945
  Offer a concise list of main topic areas the user might want to explore:
946
946
 
947
947
  **What would you like to know more about?**
948
948
 
949
- 1. **Setup & Installation** - Getting started with BMAD
949
+ 1. **Setup & Installation** - Getting started with BMad
950
950
  2. **Workflows** - Choosing the right workflow for your project
951
951
  3. **Web vs IDE** - When to use each environment
952
952
  4. **Agents** - Understanding specialized agents and their roles
953
953
  5. **Documents** - PRDs, Architecture, Stories, and more
954
- 6. **Agile Process** - How BMAD implements Agile methodologies
955
- 7. **Configuration** - Customizing BMAD for your needs
956
- 8. **Best Practices** - Tips for effective BMAD usage
954
+ 6. **Agile Process** - How BMad implements Agile methodologies
955
+ 7. **Configuration** - Customizing BMad for your needs
956
+ 8. **Best Practices** - Tips for effective BMad usage
957
957
 
958
- Or ask me about anything else related to BMAD-METHOD!
958
+ Or ask me about anything else related to BMad-Method!
959
959
 
960
960
  ### 3. Respond Contextually
961
961
  - Wait for user's specific question or topic selection
@@ -979,20 +979,20 @@ When user is done or wants to exit KB mode:
979
979
 
980
980
  **User**: *kb-mode
981
981
 
982
- **Assistant**: I've entered KB mode and have access to the full BMAD knowledge base. I can help you with detailed information about any aspect of BMAD-METHOD.
982
+ **Assistant**: I've entered KB mode and have access to the full BMad knowledge base. I can help you with detailed information about any aspect of BMad-Method.
983
983
 
984
984
  **What would you like to know more about?**
985
985
 
986
- 1. **Setup & Installation** - Getting started with BMAD
986
+ 1. **Setup & Installation** - Getting started with BMad
987
987
  2. **Workflows** - Choosing the right workflow for your project
988
988
  3. **Web vs IDE** - When to use each environment
989
989
  4. **Agents** - Understanding specialized agents and their roles
990
990
  5. **Documents** - PRDs, Architecture, Stories, and more
991
- 6. **Agile Process** - How BMAD implements Agile methodologies
992
- 7. **Configuration** - Customizing BMAD for your needs
993
- 8. **Best Practices** - Tips for effective BMAD usage
991
+ 6. **Agile Process** - How BMad implements Agile methodologies
992
+ 7. **Configuration** - Customizing BMad for your needs
993
+ 8. **Best Practices** - Tips for effective BMad usage
994
994
 
995
- Or ask me about anything else related to BMAD-METHOD!
995
+ Or ask me about anything else related to BMad-Method!
996
996
 
997
997
  **User**: Tell me about workflows
998
998
 
@@ -1251,11 +1251,11 @@ The update is successful when:
1251
1251
  ==================== END: tasks#update-workflow-plan ====================
1252
1252
 
1253
1253
  ==================== START: data#bmad-kb ====================
1254
- # BMAD Knowledge Base
1254
+ # BMad Knowledge Base
1255
1255
 
1256
1256
  ## Overview
1257
1257
 
1258
- BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments.
1258
+ BMad-Method (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments.
1259
1259
 
1260
1260
  ### Key Features
1261
1261
 
@@ -1265,7 +1265,7 @@ BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework
1265
1265
  - **Reusable Resources**: Portable templates, tasks, and checklists
1266
1266
  - **Slash Command Integration**: Quick agent switching and control
1267
1267
 
1268
- ### When to Use BMAD
1268
+ ### When to Use BMad
1269
1269
 
1270
1270
  - **New Projects (Greenfield)**: Complete end-to-end development
1271
1271
  - **Existing Projects (Brownfield)**: Feature additions and enhancements
@@ -1273,11 +1273,11 @@ BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework
1273
1273
  - **Quality Assurance**: Structured testing and validation
1274
1274
  - **Documentation**: Professional PRDs, architecture docs, user stories
1275
1275
 
1276
- ## How BMAD Works
1276
+ ## How BMad Works
1277
1277
 
1278
1278
  ### The Core Method
1279
1279
 
1280
- BMAD transforms you into a "Vibe CEO" - directing a team of specialized AI agents through structured workflows. Here's how:
1280
+ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agents through structured workflows. Here's how:
1281
1281
 
1282
1282
  1. **You Direct, AI Executes**: You provide vision and decisions; agents handle implementation details
1283
1283
  2. **Specialized Agents**: Each agent masters one role (PM, Developer, Architect, etc.)
@@ -1331,7 +1331,7 @@ BMAD transforms you into a "Vibe CEO" - directing a team of specialized AI agent
1331
1331
  5. Type `/help` to see available commands
1332
1332
 
1333
1333
  #### Option 2: IDE Integration
1334
- **Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, VS Code Copilot users
1334
+ **Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
1335
1335
 
1336
1336
  ```bash
1337
1337
  # Interactive installation (recommended)
@@ -1346,16 +1346,16 @@ npx bmad-method install
1346
1346
  - **Windsurf**: Built-in AI capabilities
1347
1347
  - **Cline**: VS Code extension with AI features
1348
1348
  - **Roo Code**: Web-based IDE with agent support
1349
- - **VS Code Copilot**: AI-powered coding assistant
1349
+ - **Github Copilot**: AI-powered coding assistant
1350
1350
 
1351
- **Note for VS Code Users**: BMAD-METHOD assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMAD agents. The installer includes built-in support for Cline and Roo.
1351
+ **Note for VS Code Users**: BMad-Method assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
1352
1352
 
1353
1353
  **Verify Installation**:
1354
1354
  - `.bmad-core/` folder created with all agents
1355
1355
  - IDE-specific integration files created
1356
1356
  - All agent commands/rules/modes available
1357
1357
 
1358
- **Remember**: At its core, BMAD-METHOD is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMAD - the framework provides the structured prompts and workflows that make AI development effective
1358
+ **Remember**: At its core, BMad-Method is about mastering and harnessing prompt engineering. Any IDE with AI agent support can use BMad - the framework provides the structured prompts and workflows that make AI development effective
1359
1359
 
1360
1360
  ### Environment Selection Guide
1361
1361
 
@@ -1416,11 +1416,11 @@ npx bmad-method install
1416
1416
 
1417
1417
  ## Core Configuration (core-config.yaml)
1418
1418
 
1419
- **New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMAD to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
1419
+ **New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
1420
1420
 
1421
1421
  ### What is core-config.yaml?
1422
1422
 
1423
- This configuration file acts as a map for BMAD agents, telling them exactly where to find your project documents and how they're structured. It enables:
1423
+ This configuration file acts as a map for BMad agents, telling them exactly where to find your project documents and how they're structured. It enables:
1424
1424
 
1425
1425
  - **Version Flexibility**: Work with V3, V4, or custom document structures
1426
1426
  - **Custom Locations**: Define where your documents and shards live
@@ -1449,7 +1449,7 @@ This configuration file acts as a map for BMAD agents, telling them exactly wher
1449
1449
 
1450
1450
  1. **No Forced Migrations**: Keep your existing document structure
1451
1451
  2. **Gradual Adoption**: Start with V3 and migrate to V4 at your pace
1452
- 3. **Custom Workflows**: Configure BMAD to match your team's process
1452
+ 3. **Custom Workflows**: Configure BMad to match your team's process
1453
1453
  4. **Intelligent Agents**: Agents automatically adapt to your configuration
1454
1454
 
1455
1455
  ### Common Configurations
@@ -1532,7 +1532,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1532
1532
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
1533
1533
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
1534
1534
  - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
1535
- - **VS Code Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1535
+ - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1536
1536
 
1537
1537
  **Chat Management Guidelines**:
1538
1538
  - **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
@@ -1578,7 +1578,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1578
1578
 
1579
1579
  ### System Overview
1580
1580
 
1581
- The BMAD-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini).
1581
+ The BMad-Method is built around a modular architecture centered on the `bmad-core` directory, which serves as the brain of the entire system. This design enables the framework to operate effectively in both IDE environments (like Cursor, VS Code) and web-based AI interfaces (like ChatGPT, Gemini).
1582
1582
 
1583
1583
  ### Key Architectural Components
1584
1584
 
@@ -1622,7 +1622,7 @@ The BMAD-Method is built around a modular architecture centered on the `bmad-cor
1622
1622
 
1623
1623
  ### Template Processing System
1624
1624
 
1625
- BMAD employs a sophisticated template system with three key components:
1625
+ BMad employs a sophisticated template system with three key components:
1626
1626
 
1627
1627
  1. **Template Format** (`utils/template-format.md`): Defines markup language for variable substitution and AI processing directives
1628
1628
  2. **Document Creation** (`tasks/create-doc.md`): Orchestrates template selection and user interaction
@@ -1651,7 +1651,7 @@ The `web-builder.js` tool creates web-ready bundles by:
1651
1651
  3. Concatenating content into single text files with clear separators
1652
1652
  4. Outputting ready-to-upload bundles for web AI interfaces
1653
1653
 
1654
- This architecture enables seamless operation across environments while maintaining the rich, interconnected agent ecosystem that makes BMAD powerful.
1654
+ This architecture enables seamless operation across environments while maintaining the rich, interconnected agent ecosystem that makes BMad powerful.
1655
1655
 
1656
1656
  ## Complete Development Workflow
1657
1657
 
@@ -1912,7 +1912,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh
1912
1912
  - **Keep conversations focused** - One agent, one task per conversation
1913
1913
  - **Review everything** - Always review and approve before marking complete
1914
1914
 
1915
- ## Contributing to BMAD-METHOD
1915
+ ## Contributing to BMad-Method
1916
1916
 
1917
1917
  ### Quick Contribution Guidelines
1918
1918
 
@@ -1941,7 +1941,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
1941
1941
 
1942
1942
  ### What Are Expansion Packs?
1943
1943
 
1944
- Expansion packs extend BMAD-METHOD beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development.
1944
+ Expansion packs extend BMad-Method beyond traditional software development into ANY domain. They provide specialized agent teams, templates, and workflows while keeping the core framework lean and focused on development.
1945
1945
 
1946
1946
  ### Why Use Expansion Packs?
1947
1947
 
@@ -2231,7 +2231,7 @@ Would you like to:
2231
2231
  ==================== START: utils#workflow-management ====================
2232
2232
  # Workflow Management
2233
2233
 
2234
- Enables BMAD orchestrator to manage and execute team workflows.
2234
+ Enables BMad orchestrator to manage and execute team workflows.
2235
2235
 
2236
2236
  ## Dynamic Workflow Loading
2237
2237
 
@@ -2303,7 +2303,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
2303
2303
  ==================== START: utils#template-format ====================
2304
2304
  # Template Format Conventions
2305
2305
 
2306
- Templates in the BMAD method use standardized markup for AI processing. These conventions ensure consistent document generation.
2306
+ Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
2307
2307
 
2308
2308
  ## Template Markup Elements
2309
2309
 
@@ -5521,7 +5521,7 @@ After presenting the report, ask if the user wants:
5521
5521
  ==================== START: checklists#change-checklist ====================
5522
5522
  # Change Navigation Checklist
5523
5523
 
5524
- **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMAD workflow.
5524
+ **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
5525
5525
 
5526
5526
  **Instructions:** Review each item with the user. Mark `[x]` for completed/confirmed, `[N/A]` if not applicable, or add notes for discussion points.
5527
5527
 
@@ -5596,7 +5596,7 @@ Think about both immediate and downstream effects.]]
5596
5596
 
5597
5597
  ## 3. Artifact Conflict & Impact Analysis
5598
5598
 
5599
- [[LLM: Documentation drives development in BMAD. Check each artifact:
5599
+ [[LLM: Documentation drives development in BMad. Check each artifact:
5600
5600
 
5601
5601
  1. Does this change invalidate documented decisions?
5602
5602
  2. Are architectural assumptions still valid?