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
 
@@ -64,13 +64,13 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll
64
64
  agent:
65
65
  name: BMad Orchestrator
66
66
  id: bmad-orchestrator
67
- title: BMAD Master Orchestrator
67
+ title: BMad Master Orchestrator
68
68
  icon: 🎭
69
69
  whenToUse: Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult
70
70
  persona:
71
- role: Master Orchestrator & BMAD Method Expert
72
- style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMAD Method while orchestrating agents
73
- identity: Unified interface to all BMAD-METHOD capabilities, dynamically transforms into any specialized agent
71
+ role: Master Orchestrator & BMad Method Expert
72
+ style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMad Method while orchestrating agents
73
+ identity: Unified interface to all BMad-Method capabilities, dynamically transforms into any specialized agent
74
74
  focus: Orchestrating the right agent/capability for each need, loading resources only when needed
75
75
  core_principles:
76
76
  - Become any agent on demand, loading files only when needed
@@ -83,7 +83,7 @@ persona:
83
83
  - Process commands starting with * immediately
84
84
  - Always remind users that commands require * prefix
85
85
  startup:
86
- - Announce: Introduce yourself as the BMAD Orchestrator, explain you can coordinate agents and workflows
86
+ - Announce: Introduce yourself as the BMad Orchestrator, explain you can coordinate agents and workflows
87
87
  - IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
88
88
  - Mention *help shows all available commands and options
89
89
  - Check for active workflow plan using utils#plan-management
@@ -96,7 +96,7 @@ startup:
96
96
  commands:
97
97
  help: Show this guide with available agents and workflows
98
98
  chat-mode: Start conversational mode for detailed assistance
99
- kb-mode: Load full BMAD knowledge base
99
+ kb-mode: Load full BMad knowledge base
100
100
  status: Show current context, active agent, and progress
101
101
  agent: Transform into a specialized agent (list if name not specified)
102
102
  exit: Return to BMad or exit session
@@ -111,13 +111,13 @@ commands:
111
111
  party-mode: Group chat with all agents
112
112
  doc-out: Output full document
113
113
  help-display-template: |
114
- === BMAD Orchestrator Commands ===
114
+ === BMad Orchestrator Commands ===
115
115
  All commands must start with * (asterisk)
116
116
 
117
117
  Core Commands:
118
118
  *help ............... Show this guide
119
119
  *chat-mode .......... Start conversational mode for detailed assistance
120
- *kb-mode ............ Load full BMAD knowledge base
120
+ *kb-mode ............ Load full BMad knowledge base
121
121
  *status ............. Show current context, active agent, and progress
122
122
  *exit ............... Return to BMad or exit session
123
123
 
@@ -158,7 +158,7 @@ transformation:
158
158
  - Announce transformation
159
159
  - Operate until exit
160
160
  loading:
161
- - KB: Only for *kb-mode or BMAD questions
161
+ - KB: Only for *kb-mode or BMad questions
162
162
  - Agents: Only when transforming
163
163
  - Templates/Tasks: Only when executing
164
164
  - Always indicate loading
@@ -1154,7 +1154,7 @@ BMad Orchestrator: "I've created a workflow plan at docs/workflow-plan.md. This
1154
1154
  # KB Mode Interaction Task
1155
1155
 
1156
1156
  ## Purpose
1157
- Provide a user-friendly interface to the BMAD knowledge base without overwhelming users with information upfront.
1157
+ Provide a user-friendly interface to the BMad knowledge base without overwhelming users with information upfront.
1158
1158
 
1159
1159
  ## Instructions
1160
1160
 
@@ -1163,23 +1163,23 @@ When entering KB mode (*kb-mode), follow these steps:
1163
1163
  ### 1. Welcome and Guide
1164
1164
  Announce entering KB mode with a brief, friendly introduction:
1165
1165
 
1166
- "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."
1166
+ "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."
1167
1167
 
1168
1168
  ### 2. Present Topic Areas
1169
1169
  Offer a concise list of main topic areas the user might want to explore:
1170
1170
 
1171
1171
  **What would you like to know more about?**
1172
1172
 
1173
- 1. **Setup & Installation** - Getting started with BMAD
1173
+ 1. **Setup & Installation** - Getting started with BMad
1174
1174
  2. **Workflows** - Choosing the right workflow for your project
1175
1175
  3. **Web vs IDE** - When to use each environment
1176
1176
  4. **Agents** - Understanding specialized agents and their roles
1177
1177
  5. **Documents** - PRDs, Architecture, Stories, and more
1178
- 6. **Agile Process** - How BMAD implements Agile methodologies
1179
- 7. **Configuration** - Customizing BMAD for your needs
1180
- 8. **Best Practices** - Tips for effective BMAD usage
1178
+ 6. **Agile Process** - How BMad implements Agile methodologies
1179
+ 7. **Configuration** - Customizing BMad for your needs
1180
+ 8. **Best Practices** - Tips for effective BMad usage
1181
1181
 
1182
- Or ask me about anything else related to BMAD-METHOD!
1182
+ Or ask me about anything else related to BMad-Method!
1183
1183
 
1184
1184
  ### 3. Respond Contextually
1185
1185
  - Wait for user's specific question or topic selection
@@ -1203,20 +1203,20 @@ When user is done or wants to exit KB mode:
1203
1203
 
1204
1204
  **User**: *kb-mode
1205
1205
 
1206
- **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.
1206
+ **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.
1207
1207
 
1208
1208
  **What would you like to know more about?**
1209
1209
 
1210
- 1. **Setup & Installation** - Getting started with BMAD
1210
+ 1. **Setup & Installation** - Getting started with BMad
1211
1211
  2. **Workflows** - Choosing the right workflow for your project
1212
1212
  3. **Web vs IDE** - When to use each environment
1213
1213
  4. **Agents** - Understanding specialized agents and their roles
1214
1214
  5. **Documents** - PRDs, Architecture, Stories, and more
1215
- 6. **Agile Process** - How BMAD implements Agile methodologies
1216
- 7. **Configuration** - Customizing BMAD for your needs
1217
- 8. **Best Practices** - Tips for effective BMAD usage
1215
+ 6. **Agile Process** - How BMad implements Agile methodologies
1216
+ 7. **Configuration** - Customizing BMad for your needs
1217
+ 8. **Best Practices** - Tips for effective BMad usage
1218
1218
 
1219
- Or ask me about anything else related to BMAD-METHOD!
1219
+ Or ask me about anything else related to BMad-Method!
1220
1220
 
1221
1221
  **User**: Tell me about workflows
1222
1222
 
@@ -1475,11 +1475,11 @@ The update is successful when:
1475
1475
  ==================== END: tasks#update-workflow-plan ====================
1476
1476
 
1477
1477
  ==================== START: data#bmad-kb ====================
1478
- # BMAD Knowledge Base
1478
+ # BMad Knowledge Base
1479
1479
 
1480
1480
  ## Overview
1481
1481
 
1482
- 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.
1482
+ 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.
1483
1483
 
1484
1484
  ### Key Features
1485
1485
 
@@ -1489,7 +1489,7 @@ BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework
1489
1489
  - **Reusable Resources**: Portable templates, tasks, and checklists
1490
1490
  - **Slash Command Integration**: Quick agent switching and control
1491
1491
 
1492
- ### When to Use BMAD
1492
+ ### When to Use BMad
1493
1493
 
1494
1494
  - **New Projects (Greenfield)**: Complete end-to-end development
1495
1495
  - **Existing Projects (Brownfield)**: Feature additions and enhancements
@@ -1497,11 +1497,11 @@ BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework
1497
1497
  - **Quality Assurance**: Structured testing and validation
1498
1498
  - **Documentation**: Professional PRDs, architecture docs, user stories
1499
1499
 
1500
- ## How BMAD Works
1500
+ ## How BMad Works
1501
1501
 
1502
1502
  ### The Core Method
1503
1503
 
1504
- BMAD transforms you into a "Vibe CEO" - directing a team of specialized AI agents through structured workflows. Here's how:
1504
+ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agents through structured workflows. Here's how:
1505
1505
 
1506
1506
  1. **You Direct, AI Executes**: You provide vision and decisions; agents handle implementation details
1507
1507
  2. **Specialized Agents**: Each agent masters one role (PM, Developer, Architect, etc.)
@@ -1555,7 +1555,7 @@ BMAD transforms you into a "Vibe CEO" - directing a team of specialized AI agent
1555
1555
  5. Type `/help` to see available commands
1556
1556
 
1557
1557
  #### Option 2: IDE Integration
1558
- **Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, VS Code Copilot users
1558
+ **Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
1559
1559
 
1560
1560
  ```bash
1561
1561
  # Interactive installation (recommended)
@@ -1570,16 +1570,16 @@ npx bmad-method install
1570
1570
  - **Windsurf**: Built-in AI capabilities
1571
1571
  - **Cline**: VS Code extension with AI features
1572
1572
  - **Roo Code**: Web-based IDE with agent support
1573
- - **VS Code Copilot**: AI-powered coding assistant
1573
+ - **Github Copilot**: AI-powered coding assistant
1574
1574
 
1575
- **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.
1575
+ **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.
1576
1576
 
1577
1577
  **Verify Installation**:
1578
1578
  - `.bmad-core/` folder created with all agents
1579
1579
  - IDE-specific integration files created
1580
1580
  - All agent commands/rules/modes available
1581
1581
 
1582
- **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
1582
+ **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
1583
1583
 
1584
1584
  ### Environment Selection Guide
1585
1585
 
@@ -1640,11 +1640,11 @@ npx bmad-method install
1640
1640
 
1641
1641
  ## Core Configuration (core-config.yaml)
1642
1642
 
1643
- **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.
1643
+ **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.
1644
1644
 
1645
1645
  ### What is core-config.yaml?
1646
1646
 
1647
- 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:
1647
+ 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:
1648
1648
 
1649
1649
  - **Version Flexibility**: Work with V3, V4, or custom document structures
1650
1650
  - **Custom Locations**: Define where your documents and shards live
@@ -1673,7 +1673,7 @@ This configuration file acts as a map for BMAD agents, telling them exactly wher
1673
1673
 
1674
1674
  1. **No Forced Migrations**: Keep your existing document structure
1675
1675
  2. **Gradual Adoption**: Start with V3 and migrate to V4 at your pace
1676
- 3. **Custom Workflows**: Configure BMAD to match your team's process
1676
+ 3. **Custom Workflows**: Configure BMad to match your team's process
1677
1677
  4. **Intelligent Agents**: Agents automatically adapt to your configuration
1678
1678
 
1679
1679
  ### Common Configurations
@@ -1756,7 +1756,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1756
1756
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
1757
1757
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
1758
1758
  - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
1759
- - **VS Code Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1759
+ - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1760
1760
 
1761
1761
  **Chat Management Guidelines**:
1762
1762
  - **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
@@ -1802,7 +1802,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1802
1802
 
1803
1803
  ### System Overview
1804
1804
 
1805
- 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).
1805
+ 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).
1806
1806
 
1807
1807
  ### Key Architectural Components
1808
1808
 
@@ -1846,7 +1846,7 @@ The BMAD-Method is built around a modular architecture centered on the `bmad-cor
1846
1846
 
1847
1847
  ### Template Processing System
1848
1848
 
1849
- BMAD employs a sophisticated template system with three key components:
1849
+ BMad employs a sophisticated template system with three key components:
1850
1850
 
1851
1851
  1. **Template Format** (`utils/template-format.md`): Defines markup language for variable substitution and AI processing directives
1852
1852
  2. **Document Creation** (`tasks/create-doc.md`): Orchestrates template selection and user interaction
@@ -1875,7 +1875,7 @@ The `web-builder.js` tool creates web-ready bundles by:
1875
1875
  3. Concatenating content into single text files with clear separators
1876
1876
  4. Outputting ready-to-upload bundles for web AI interfaces
1877
1877
 
1878
- This architecture enables seamless operation across environments while maintaining the rich, interconnected agent ecosystem that makes BMAD powerful.
1878
+ This architecture enables seamless operation across environments while maintaining the rich, interconnected agent ecosystem that makes BMad powerful.
1879
1879
 
1880
1880
  ## Complete Development Workflow
1881
1881
 
@@ -2136,7 +2136,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh
2136
2136
  - **Keep conversations focused** - One agent, one task per conversation
2137
2137
  - **Review everything** - Always review and approve before marking complete
2138
2138
 
2139
- ## Contributing to BMAD-METHOD
2139
+ ## Contributing to BMad-Method
2140
2140
 
2141
2141
  ### Quick Contribution Guidelines
2142
2142
 
@@ -2165,7 +2165,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
2165
2165
 
2166
2166
  ### What Are Expansion Packs?
2167
2167
 
2168
- 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.
2168
+ 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.
2169
2169
 
2170
2170
  ### Why Use Expansion Packs?
2171
2171
 
@@ -2455,7 +2455,7 @@ Would you like to:
2455
2455
  ==================== START: utils#workflow-management ====================
2456
2456
  # Workflow Management
2457
2457
 
2458
- Enables BMAD orchestrator to manage and execute team workflows.
2458
+ Enables BMad orchestrator to manage and execute team workflows.
2459
2459
 
2460
2460
  ## Dynamic Workflow Loading
2461
2461
 
@@ -2527,7 +2527,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
2527
2527
  ==================== START: utils#template-format ====================
2528
2528
  # Template Format Conventions
2529
2529
 
2530
- Templates in the BMAD method use standardized markup for AI processing. These conventions ensure consistent document generation.
2530
+ Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
2531
2531
 
2532
2532
  ## Template Markup Elements
2533
2533
 
@@ -8826,7 +8826,7 @@ After presenting the report, ask if the user wants:
8826
8826
  ==================== START: checklists#change-checklist ====================
8827
8827
  # Change Navigation Checklist
8828
8828
 
8829
- **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.
8829
+ **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.
8830
8830
 
8831
8831
  **Instructions:** Review each item with the user. Mark `[x]` for completed/confirmed, `[N/A]` if not applicable, or add notes for discussion points.
8832
8832
 
@@ -8901,7 +8901,7 @@ Think about both immediate and downstream effects.]]
8901
8901
 
8902
8902
  ## 3. Artifact Conflict & Impact Analysis
8903
8903
 
8904
- [[LLM: Documentation drives development in BMAD. Check each artifact:
8904
+ [[LLM: Documentation drives development in BMad. Check each artifact:
8905
8905
 
8906
8906
  1. Does this change invalidate documented decisions?
8907
8907
  2. Are architectural assumptions still valid?
@@ -9678,8 +9678,8 @@ To identify the next logical story based on project progress and epic definition
9678
9678
  - Load `.bmad-core/core-config.yaml` from the project root
9679
9679
  - If the file does not exist:
9680
9680
  - HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can:
9681
- 1. Copy it from GITHUB BMAD-METHOD/bmad-core/core-config.yaml and configure it for your project
9682
- 2. Run the BMAD installer against your project to upgrade and add the file automatically
9681
+ 1. Copy it from GITHUB BMad-Method/bmad-core/core-config.yaml and configure it for your project
9682
+ 2. Run the BMad installer against your project to upgrade and add the file automatically
9683
9683
  Please add and configure core-config.yaml before proceeding."
9684
9684
  - Extract the following key configurations:
9685
9685
  - `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
 
@@ -68,13 +68,13 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll
68
68
  agent:
69
69
  name: BMad Orchestrator
70
70
  id: bmad-orchestrator
71
- title: BMAD Master Orchestrator
71
+ title: BMad Master Orchestrator
72
72
  icon: 🎭
73
73
  whenToUse: Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult
74
74
  persona:
75
- role: Master Orchestrator & BMAD Method Expert
76
- style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMAD Method while orchestrating agents
77
- identity: Unified interface to all BMAD-METHOD capabilities, dynamically transforms into any specialized agent
75
+ role: Master Orchestrator & BMad Method Expert
76
+ style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMad Method while orchestrating agents
77
+ identity: Unified interface to all BMad-Method capabilities, dynamically transforms into any specialized agent
78
78
  focus: Orchestrating the right agent/capability for each need, loading resources only when needed
79
79
  core_principles:
80
80
  - Become any agent on demand, loading files only when needed
@@ -87,7 +87,7 @@ persona:
87
87
  - Process commands starting with * immediately
88
88
  - Always remind users that commands require * prefix
89
89
  startup:
90
- - Announce: Introduce yourself as the BMAD Orchestrator, explain you can coordinate agents and workflows
90
+ - Announce: Introduce yourself as the BMad Orchestrator, explain you can coordinate agents and workflows
91
91
  - IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
92
92
  - Mention *help shows all available commands and options
93
93
  - Check for active workflow plan using utils#plan-management
@@ -100,7 +100,7 @@ startup:
100
100
  commands:
101
101
  help: Show this guide with available agents and workflows
102
102
  chat-mode: Start conversational mode for detailed assistance
103
- kb-mode: Load full BMAD knowledge base
103
+ kb-mode: Load full BMad knowledge base
104
104
  status: Show current context, active agent, and progress
105
105
  agent: Transform into a specialized agent (list if name not specified)
106
106
  exit: Return to BMad or exit session
@@ -115,13 +115,13 @@ commands:
115
115
  party-mode: Group chat with all agents
116
116
  doc-out: Output full document
117
117
  help-display-template: |
118
- === BMAD Orchestrator Commands ===
118
+ === BMad Orchestrator Commands ===
119
119
  All commands must start with * (asterisk)
120
120
 
121
121
  Core Commands:
122
122
  *help ............... Show this guide
123
123
  *chat-mode .......... Start conversational mode for detailed assistance
124
- *kb-mode ............ Load full BMAD knowledge base
124
+ *kb-mode ............ Load full BMad knowledge base
125
125
  *status ............. Show current context, active agent, and progress
126
126
  *exit ............... Return to BMad or exit session
127
127
 
@@ -162,7 +162,7 @@ transformation:
162
162
  - Announce transformation
163
163
  - Operate until exit
164
164
  loading:
165
- - KB: Only for *kb-mode or BMAD questions
165
+ - KB: Only for *kb-mode or BMad questions
166
166
  - Agents: Only when transforming
167
167
  - Templates/Tasks: Only when executing
168
168
  - Always indicate loading
@@ -998,7 +998,7 @@ BMad Orchestrator: "I've created a workflow plan at docs/workflow-plan.md. This
998
998
  # KB Mode Interaction Task
999
999
 
1000
1000
  ## Purpose
1001
- Provide a user-friendly interface to the BMAD knowledge base without overwhelming users with information upfront.
1001
+ Provide a user-friendly interface to the BMad knowledge base without overwhelming users with information upfront.
1002
1002
 
1003
1003
  ## Instructions
1004
1004
 
@@ -1007,23 +1007,23 @@ When entering KB mode (*kb-mode), follow these steps:
1007
1007
  ### 1. Welcome and Guide
1008
1008
  Announce entering KB mode with a brief, friendly introduction:
1009
1009
 
1010
- "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."
1010
+ "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."
1011
1011
 
1012
1012
  ### 2. Present Topic Areas
1013
1013
  Offer a concise list of main topic areas the user might want to explore:
1014
1014
 
1015
1015
  **What would you like to know more about?**
1016
1016
 
1017
- 1. **Setup & Installation** - Getting started with BMAD
1017
+ 1. **Setup & Installation** - Getting started with BMad
1018
1018
  2. **Workflows** - Choosing the right workflow for your project
1019
1019
  3. **Web vs IDE** - When to use each environment
1020
1020
  4. **Agents** - Understanding specialized agents and their roles
1021
1021
  5. **Documents** - PRDs, Architecture, Stories, and more
1022
- 6. **Agile Process** - How BMAD implements Agile methodologies
1023
- 7. **Configuration** - Customizing BMAD for your needs
1024
- 8. **Best Practices** - Tips for effective BMAD usage
1022
+ 6. **Agile Process** - How BMad implements Agile methodologies
1023
+ 7. **Configuration** - Customizing BMad for your needs
1024
+ 8. **Best Practices** - Tips for effective BMad usage
1025
1025
 
1026
- Or ask me about anything else related to BMAD-METHOD!
1026
+ Or ask me about anything else related to BMad-Method!
1027
1027
 
1028
1028
  ### 3. Respond Contextually
1029
1029
  - Wait for user's specific question or topic selection
@@ -1047,20 +1047,20 @@ When user is done or wants to exit KB mode:
1047
1047
 
1048
1048
  **User**: *kb-mode
1049
1049
 
1050
- **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.
1050
+ **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.
1051
1051
 
1052
1052
  **What would you like to know more about?**
1053
1053
 
1054
- 1. **Setup & Installation** - Getting started with BMAD
1054
+ 1. **Setup & Installation** - Getting started with BMad
1055
1055
  2. **Workflows** - Choosing the right workflow for your project
1056
1056
  3. **Web vs IDE** - When to use each environment
1057
1057
  4. **Agents** - Understanding specialized agents and their roles
1058
1058
  5. **Documents** - PRDs, Architecture, Stories, and more
1059
- 6. **Agile Process** - How BMAD implements Agile methodologies
1060
- 7. **Configuration** - Customizing BMAD for your needs
1061
- 8. **Best Practices** - Tips for effective BMAD usage
1059
+ 6. **Agile Process** - How BMad implements Agile methodologies
1060
+ 7. **Configuration** - Customizing BMad for your needs
1061
+ 8. **Best Practices** - Tips for effective BMad usage
1062
1062
 
1063
- Or ask me about anything else related to BMAD-METHOD!
1063
+ Or ask me about anything else related to BMad-Method!
1064
1064
 
1065
1065
  **User**: Tell me about workflows
1066
1066
 
@@ -1319,11 +1319,11 @@ The update is successful when:
1319
1319
  ==================== END: tasks#update-workflow-plan ====================
1320
1320
 
1321
1321
  ==================== START: data#bmad-kb ====================
1322
- # BMAD Knowledge Base
1322
+ # BMad Knowledge Base
1323
1323
 
1324
1324
  ## Overview
1325
1325
 
1326
- 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.
1326
+ 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.
1327
1327
 
1328
1328
  ### Key Features
1329
1329
 
@@ -1333,7 +1333,7 @@ BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework
1333
1333
  - **Reusable Resources**: Portable templates, tasks, and checklists
1334
1334
  - **Slash Command Integration**: Quick agent switching and control
1335
1335
 
1336
- ### When to Use BMAD
1336
+ ### When to Use BMad
1337
1337
 
1338
1338
  - **New Projects (Greenfield)**: Complete end-to-end development
1339
1339
  - **Existing Projects (Brownfield)**: Feature additions and enhancements
@@ -1341,11 +1341,11 @@ BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework
1341
1341
  - **Quality Assurance**: Structured testing and validation
1342
1342
  - **Documentation**: Professional PRDs, architecture docs, user stories
1343
1343
 
1344
- ## How BMAD Works
1344
+ ## How BMad Works
1345
1345
 
1346
1346
  ### The Core Method
1347
1347
 
1348
- BMAD transforms you into a "Vibe CEO" - directing a team of specialized AI agents through structured workflows. Here's how:
1348
+ BMad transforms you into a "Vibe CEO" - directing a team of specialized AI agents through structured workflows. Here's how:
1349
1349
 
1350
1350
  1. **You Direct, AI Executes**: You provide vision and decisions; agents handle implementation details
1351
1351
  2. **Specialized Agents**: Each agent masters one role (PM, Developer, Architect, etc.)
@@ -1399,7 +1399,7 @@ BMAD transforms you into a "Vibe CEO" - directing a team of specialized AI agent
1399
1399
  5. Type `/help` to see available commands
1400
1400
 
1401
1401
  #### Option 2: IDE Integration
1402
- **Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, VS Code Copilot users
1402
+ **Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Github Copilot users
1403
1403
 
1404
1404
  ```bash
1405
1405
  # Interactive installation (recommended)
@@ -1414,16 +1414,16 @@ npx bmad-method install
1414
1414
  - **Windsurf**: Built-in AI capabilities
1415
1415
  - **Cline**: VS Code extension with AI features
1416
1416
  - **Roo Code**: Web-based IDE with agent support
1417
- - **VS Code Copilot**: AI-powered coding assistant
1417
+ - **Github Copilot**: AI-powered coding assistant
1418
1418
 
1419
- **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.
1419
+ **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.
1420
1420
 
1421
1421
  **Verify Installation**:
1422
1422
  - `.bmad-core/` folder created with all agents
1423
1423
  - IDE-specific integration files created
1424
1424
  - All agent commands/rules/modes available
1425
1425
 
1426
- **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
1426
+ **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
1427
1427
 
1428
1428
  ### Environment Selection Guide
1429
1429
 
@@ -1484,11 +1484,11 @@ npx bmad-method install
1484
1484
 
1485
1485
  ## Core Configuration (core-config.yaml)
1486
1486
 
1487
- **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.
1487
+ **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.
1488
1488
 
1489
1489
  ### What is core-config.yaml?
1490
1490
 
1491
- 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:
1491
+ 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:
1492
1492
 
1493
1493
  - **Version Flexibility**: Work with V3, V4, or custom document structures
1494
1494
  - **Custom Locations**: Define where your documents and shards live
@@ -1517,7 +1517,7 @@ This configuration file acts as a map for BMAD agents, telling them exactly wher
1517
1517
 
1518
1518
  1. **No Forced Migrations**: Keep your existing document structure
1519
1519
  2. **Gradual Adoption**: Start with V3 and migrate to V4 at your pace
1520
- 3. **Custom Workflows**: Configure BMAD to match your team's process
1520
+ 3. **Custom Workflows**: Configure BMad to match your team's process
1521
1521
  4. **Intelligent Agents**: Agents automatically adapt to your configuration
1522
1522
 
1523
1523
  ### Common Configurations
@@ -1600,7 +1600,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1600
1600
  - **Cursor**: `@agent-name` (e.g., `@bmad-master`)
1601
1601
  - **Windsurf**: `@agent-name` (e.g., `@bmad-master`)
1602
1602
  - **Roo Code**: Select mode from mode selector (e.g., `bmad-bmad-master`)
1603
- - **VS Code Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1603
+ - **Github Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
1604
1604
 
1605
1605
  **Chat Management Guidelines**:
1606
1606
  - **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
@@ -1646,7 +1646,7 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
1646
1646
 
1647
1647
  ### System Overview
1648
1648
 
1649
- 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).
1649
+ 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).
1650
1650
 
1651
1651
  ### Key Architectural Components
1652
1652
 
@@ -1690,7 +1690,7 @@ The BMAD-Method is built around a modular architecture centered on the `bmad-cor
1690
1690
 
1691
1691
  ### Template Processing System
1692
1692
 
1693
- BMAD employs a sophisticated template system with three key components:
1693
+ BMad employs a sophisticated template system with three key components:
1694
1694
 
1695
1695
  1. **Template Format** (`utils/template-format.md`): Defines markup language for variable substitution and AI processing directives
1696
1696
  2. **Document Creation** (`tasks/create-doc.md`): Orchestrates template selection and user interaction
@@ -1719,7 +1719,7 @@ The `web-builder.js` tool creates web-ready bundles by:
1719
1719
  3. Concatenating content into single text files with clear separators
1720
1720
  4. Outputting ready-to-upload bundles for web AI interfaces
1721
1721
 
1722
- This architecture enables seamless operation across environments while maintaining the rich, interconnected agent ecosystem that makes BMAD powerful.
1722
+ This architecture enables seamless operation across environments while maintaining the rich, interconnected agent ecosystem that makes BMad powerful.
1723
1723
 
1724
1724
  ## Complete Development Workflow
1725
1725
 
@@ -1980,7 +1980,7 @@ Use the `shard-doc` task or `@kayvan/markdown-tree-parser` tool for automatic sh
1980
1980
  - **Keep conversations focused** - One agent, one task per conversation
1981
1981
  - **Review everything** - Always review and approve before marking complete
1982
1982
 
1983
- ## Contributing to BMAD-METHOD
1983
+ ## Contributing to BMad-Method
1984
1984
 
1985
1985
  ### Quick Contribution Guidelines
1986
1986
 
@@ -2009,7 +2009,7 @@ For full details, see `CONTRIBUTING.md`. Key points:
2009
2009
 
2010
2010
  ### What Are Expansion Packs?
2011
2011
 
2012
- 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.
2012
+ 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.
2013
2013
 
2014
2014
  ### Why Use Expansion Packs?
2015
2015
 
@@ -2299,7 +2299,7 @@ Would you like to:
2299
2299
  ==================== START: utils#workflow-management ====================
2300
2300
  # Workflow Management
2301
2301
 
2302
- Enables BMAD orchestrator to manage and execute team workflows.
2302
+ Enables BMad orchestrator to manage and execute team workflows.
2303
2303
 
2304
2304
  ## Dynamic Workflow Loading
2305
2305
 
@@ -2371,7 +2371,7 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
2371
2371
  ==================== START: utils#template-format ====================
2372
2372
  # Template Format Conventions
2373
2373
 
2374
- Templates in the BMAD method use standardized markup for AI processing. These conventions ensure consistent document generation.
2374
+ Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
2375
2375
 
2376
2376
  ## Template Markup Elements
2377
2377
 
@@ -5589,7 +5589,7 @@ After presenting the report, ask if the user wants:
5589
5589
  ==================== START: checklists#change-checklist ====================
5590
5590
  # Change Navigation Checklist
5591
5591
 
5592
- **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.
5592
+ **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.
5593
5593
 
5594
5594
  **Instructions:** Review each item with the user. Mark `[x]` for completed/confirmed, `[N/A]` if not applicable, or add notes for discussion points.
5595
5595
 
@@ -5664,7 +5664,7 @@ Think about both immediate and downstream effects.]]
5664
5664
 
5665
5665
  ## 3. Artifact Conflict & Impact Analysis
5666
5666
 
5667
- [[LLM: Documentation drives development in BMAD. Check each artifact:
5667
+ [[LLM: Documentation drives development in BMad. Check each artifact:
5668
5668
 
5669
5669
  1. Does this change invalidate documented decisions?
5670
5670
  2. Are architectural assumptions still valid?