bmad-method 4.44.0 → 4.44.2

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 (68) hide show
  1. package/.github/ISSUE_TEMPLATE/config.yml +5 -0
  2. package/.github/workflows/manual-release.yaml +1 -1
  3. package/PR-opencode-agents-generator.md +40 -0
  4. package/README.md +38 -44
  5. package/bmad-core/agents/analyst.md +1 -1
  6. package/bmad-core/agents/architect.md +1 -1
  7. package/bmad-core/agents/bmad-master.md +7 -7
  8. package/bmad-core/agents/bmad-orchestrator.md +2 -2
  9. package/bmad-core/agents/dev.md +1 -1
  10. package/bmad-core/agents/pm.md +1 -1
  11. package/bmad-core/agents/po.md +1 -1
  12. package/bmad-core/agents/qa.md +2 -6
  13. package/bmad-core/agents/sm.md +1 -1
  14. package/bmad-core/agents/ux-expert.md +1 -1
  15. package/bmad-core/checklists/po-master-checklist.md +3 -3
  16. package/bmad-core/data/bmad-kb.md +1 -1
  17. package/bmad-core/tasks/apply-qa-fixes.md +4 -4
  18. package/bmad-core/tasks/nfr-assess.md +3 -3
  19. package/bmad-core/tasks/qa-gate.md +2 -2
  20. package/bmad-core/tasks/review-story.md +1 -1
  21. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +6 -6
  22. package/dist/agents/analyst.txt +3 -11
  23. package/dist/agents/architect.txt +1 -7
  24. package/dist/agents/bmad-master.txt +7 -31
  25. package/dist/agents/bmad-orchestrator.txt +1 -8
  26. package/dist/agents/dev.txt +5 -10
  27. package/dist/agents/pm.txt +0 -10
  28. package/dist/agents/po.txt +4 -10
  29. package/dist/agents/qa.txt +7 -15
  30. package/dist/agents/sm.txt +0 -4
  31. package/dist/agents/ux-expert.txt +0 -4
  32. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -6
  33. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +0 -3
  34. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -3
  35. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +2 -25
  36. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +0 -9
  37. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -8
  38. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +1 -4
  39. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -4
  40. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +3 -35
  41. package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +0 -9
  42. package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +0 -8
  43. package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +0 -7
  44. package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +0 -8
  45. package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +0 -10
  46. package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +0 -8
  47. package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +0 -7
  48. package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +0 -9
  49. package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +0 -85
  50. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-developer.txt +2 -2
  51. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-qa.txt +1 -2
  52. package/dist/expansion-packs/bmad-godot-game-dev/teams/godot-game-team.txt +5 -6
  53. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -5
  54. package/dist/teams/team-all.txt +34 -69
  55. package/dist/teams/team-fullstack.txt +23 -46
  56. package/dist/teams/team-ide-minimal.txt +16 -42
  57. package/dist/teams/team-no-ui.txt +12 -34
  58. package/docs/user-guide.md +48 -1
  59. package/expansion-packs/bmad-godot-game-dev/agents/bmad-orchestrator.md +1 -1
  60. package/expansion-packs/bmad-godot-game-dev/agents/game-qa.md +1 -2
  61. package/expansion-packs/bmad-godot-game-dev/tasks/apply-qa-fixes.md +2 -2
  62. package/package.json +2 -1
  63. package/tools/installer/bin/bmad.js +46 -1
  64. package/tools/installer/config/install.config.yaml +18 -7
  65. package/tools/installer/lib/ide-setup.js +709 -77
  66. package/tools/installer/lib/installer.js +17 -4
  67. package/tools/installer/package.json +1 -1
  68. package/release_notes.md +0 -48
@@ -0,0 +1,5 @@
1
+ blank_issues_enabled: false
2
+ contact_links:
3
+ - name: Discord Community Support
4
+ url: https://discord.gg/gk8jAdXWmj
5
+ about: Please join our Discord server for general questions and community discussion before opening an issue.
@@ -26,7 +26,7 @@ jobs:
26
26
  uses: actions/checkout@v4
27
27
  with:
28
28
  fetch-depth: 0
29
- token: ${{ secrets.GITHUB_TOKEN }}
29
+ token: ${{ secrets.GH_PAT }}
30
30
 
31
31
  - name: Setup Node.js
32
32
  uses: actions/setup-node@v4
@@ -0,0 +1,40 @@
1
+ # feat(opencode): compact AGENTS.md generator and JSON-only integration
2
+
3
+ ## What
4
+
5
+ Add JSON-only OpenCode integration and a compact AGENTS.md generator (no large embeds; clickable file links) with idempotent merges for BMAD instructions, agents, and commands.
6
+
7
+ ## Why
8
+
9
+ Keep OpenCode config schema‑compliant and small, avoid key collisions, and provide a readable agents/tasks index without inflating AGENTS.md.
10
+
11
+ ## How
12
+
13
+ - Ensure `.bmad-core/core-config.yaml` in `instructions`
14
+ - Merge only selected packages’ agents/commands into opencode.json file
15
+ - Orchestrators `mode: primary`; all agents enable `write`, `edit`, `bash`
16
+ - Descriptions from `whenToUse`/task `Purpose` with sanitization + fallbacks
17
+ - Explicit warnings for non‑BMAD collisions; AGENTS.md uses a strict 3‑column table with links
18
+
19
+ ## Testing
20
+
21
+ - Run: `npx bmad-method install -f -i opencode`
22
+ - Verify: `opencode.json[c]` updated/created as expected, `AGENTS.md` OpenCode section is compact with links
23
+ - Pre‑push checks:
24
+
25
+ ```bash
26
+ npm run pre-release
27
+ # or individually
28
+ npm run validate
29
+ npm run format:check
30
+ npm run lint
31
+ # if anything fails
32
+ npm run fix
33
+ # or
34
+ npm run format
35
+ npm run lint:fix
36
+ ```
37
+
38
+ Fixes #<issue-number>
39
+
40
+ Targets: `next` branch
package/README.md CHANGED
@@ -1,10 +1,33 @@
1
- # BMAD-METHOD™: Universal AI Agent Framework
1
+ # BMAD-METHOD™: Universal AI Agent Framework (v4 - Stable)
2
2
 
3
3
  [![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
5
  [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
6
6
  [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
7
7
 
8
+ > ## 🚨 **v4 STABLE - NO NEW FEATURES** 🚨
9
+ >
10
+ > This is the **stable, production-ready v4 version** of BMad Method. It will receive **critical patches only** - no new features will be added.
11
+ >
12
+ > **Install v4 Stable:** `npx bmad-method install`
13
+
14
+ ---
15
+
16
+ ## 🆕 Want to Try v6 Alpha?
17
+
18
+ **BMad v6** is under active development with major improvements:
19
+
20
+ - Scale-adaptive workflows (Levels 0-4)
21
+ - Project-adaptive architecture
22
+ - Enhanced module system (BMM, BMB, CIS)
23
+ - Update-safe customization
24
+
25
+ **[View v6 Documentation](https://github.com/bmad-code-org/BMAD-METHOD/tree/main)** | **Install:** `npx bmad-method@alpha install`
26
+
27
+ > **Note:** v6 is in alpha - stable enough for testing but not production-ready yet.
28
+
29
+ ---
30
+
8
31
  Foundations in Agentic Agile Driven Development, known as the Breakthrough Method of Agile AI-Driven Development, yet so much more. Transform any domain with specialized AI expertise: software development, entertainment, creative writing, business strategy to personal wellness just to name a few.
9
32
 
10
33
  **[Subscribe to BMadCode on YouTube](https://www.youtube.com/@BMadCode?sub_confirmation=1)**
@@ -47,45 +70,37 @@ This two-phase approach eliminates both **planning inconsistency** and **context
47
70
  - **[Understand the architecture](docs/core-architecture.md)** → Technical deep dive
48
71
  - **[Join the community](https://discord.gg/gk8jAdXWmj)** → Get help and share ideas
49
72
 
50
- ## Important: Keep Your BMad Installation Updated
73
+ ## Important: Keep Your v4 Installation Updated
51
74
 
52
- **Stay up-to-date effortlessly!** If you already have BMAD-METHOD™ installed in your project, simply run:
75
+ **Stay up-to-date with v4 patches!** If you already have BMAD-METHOD™ v4 installed in your project, run:
53
76
 
54
77
  ```bash
55
78
  npx bmad-method install
56
- # OR
57
- git pull
58
- npm run install:bmad
59
79
  ```
60
80
 
61
81
  This will:
62
82
 
63
83
  - ✅ Automatically detect your existing v4 installation
64
- - ✅ Update only the files that have changed and add new files
84
+ - ✅ Update only the files that have changed (critical patches only)
65
85
  - ✅ Create `.bak` backup files for any custom modifications you've made
66
86
  - ✅ Preserve your project-specific configurations
67
87
 
68
- This makes it easy to benefit from the latest improvements, bug fixes, and new agents without losing your customizations!
88
+ > **Remember:** v4 receives critical patches only. For new features, try [v6 alpha](#-want-to-try-v6-alpha).
69
89
 
70
- ## Quick Start
90
+ ## Quick Start (v4 Stable)
71
91
 
72
- ### One Command for Everything (IDE Installation)
92
+ ### One Command Installation
73
93
 
74
- **Just run one of these commands:**
94
+ **Install v4 stable version:**
75
95
 
76
96
  ```bash
77
97
  npx bmad-method install
78
- # OR explicitly use stable tag:
79
- npx bmad-method@stable install
80
- # OR if you already have BMad installed:
81
- git pull
82
- npm run install:bmad
83
98
  ```
84
99
 
85
- This single command handles:
100
+ This command handles:
86
101
 
87
- - **New installations** - Sets up BMad in your project
88
- - **Upgrades** - Updates existing installations automatically
102
+ - **New installations** - Sets up BMad v4 in your project
103
+ - **Upgrades** - Updates existing v4 installations with patches
89
104
  - **Expansion packs** - Installs any expansion packs you've added to package.json
90
105
 
91
106
  > **That's it!** Whether you're installing for the first time, upgrading, or adding expansion packs - these commands do everything.
@@ -101,10 +116,11 @@ This single command handles:
101
116
  5. **CRITICAL**: Talk to BMad Orchestrator in the web at ANY TIME (#bmad-orchestrator command) and ask it questions about how this all works!
102
117
  6. **When to move to the IDE**: Once you have your PRD, Architecture, optional UX and Briefs - its time to switch over to the IDE to shard your docs, and start implementing the actual code! See the [User guide](docs/user-guide.md) for more details
103
118
 
104
- ### Alternative: Clone and Build
119
+ ### Alternative: Clone v4 Branch
105
120
 
106
121
  ```bash
107
- git clone https://github.com/bmadcode/bmad-method.git
122
+ git clone -b V4 https://github.com/bmad-code-org/BMAD-METHOD.git
123
+ cd BMAD-METHOD
108
124
  npm run install:bmad # build and install all to a destination folder
109
125
  ```
110
126
 
@@ -128,29 +144,7 @@ BMAD™'s natural language framework works in ANY domain. Expansion packs provid
128
144
 
129
145
  ## Contributing
130
146
 
131
- **We're excited about contributions and welcome your ideas, improvements, and expansion packs!** 🎉
132
-
133
- 📋 **[Read CONTRIBUTING.md](CONTRIBUTING.md)** - Complete guide to contributing, including guidelines, process, and requirements
134
-
135
- ### Working with Forks
136
-
137
- When you fork this repository, CI/CD workflows are **disabled by default** to save resources. This is intentional and helps keep your fork clean.
138
-
139
- #### Need CI/CD in Your Fork?
140
-
141
- See our [Fork CI/CD Guide](.github/FORK_GUIDE.md) for instructions on enabling workflows in your fork.
142
-
143
- #### Contributing Workflow
144
-
145
- 1. **Fork the repository** - Click the Fork button on GitHub
146
- 2. **Clone your fork** - `git clone https://github.com/YOUR-USERNAME/BMAD-METHOD.git`
147
- 3. **Create a feature branch** - `git checkout -b feature/amazing-feature`
148
- 4. **Make your changes** - Test locally with `npm test`
149
- 5. **Commit your changes** - `git commit -m 'feat: add amazing feature'`
150
- 6. **Push to your fork** - `git push origin feature/amazing-feature`
151
- 7. **Open a Pull Request** - CI/CD will run automatically on the PR
152
-
153
- Your contributions are tested when you submit a PR - no need to enable CI in your fork!
147
+ **v4 is frozen** - only critical patches accepted. For new features and contributions, please work on **[v6 (main branch)](https://github.com/bmad-code-org/BMAD-METHOD/tree/main)**.
154
148
 
155
149
  ## License
156
150
 
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -101,10 +101,10 @@ dependencies:
101
101
  - project-brief-tmpl.yaml
102
102
  - story-tmpl.yaml
103
103
  workflows:
104
- - brownfield-fullstack.md
105
- - brownfield-service.md
106
- - brownfield-ui.md
107
- - greenfield-fullstack.md
108
- - greenfield-service.md
109
- - greenfield-ui.md
104
+ - brownfield-fullstack.yaml
105
+ - brownfield-service.yaml
106
+ - brownfield-ui.yaml
107
+ - greenfield-fullstack.yaml
108
+ - greenfield-service.yaml
109
+ - greenfield-ui.yaml
110
110
  ```
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -31,7 +31,7 @@ activation-instructions:
31
31
  - Assess user goal against available agents and workflows in this bundle
32
32
  - If clear match to an agent's expertise, suggest transformation with *agent command
33
33
  - If project-oriented, suggest *workflow-guidance to explore options
34
- - Load resources only when needed - never pre-load (Exception: Read `bmad-core/core-config.yaml` during activation)
34
+ - Load resources only when needed - never pre-load (Exception: Read `.bmad-core/core-config.yaml` during activation)
35
35
  - CRITICAL: On activation, ONLY greet user, auto-run `*help`, and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
36
36
  agent:
37
37
  name: BMad Orchestrator
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -35,11 +35,7 @@ agent:
35
35
  id: qa
36
36
  title: Test Architect & Quality Advisor
37
37
  icon: 🧪
38
- whenToUse: |
39
- Use for comprehensive test architecture review, quality gate decisions,
40
- and code improvement. Provides thorough analysis including requirements
41
- traceability, risk assessment, and test strategy.
42
- Advisory only - teams choose their quality bar.
38
+ whenToUse: Use for comprehensive test architecture review, quality gate decisions, and code improvement. Provides thorough analysis including requirements traceability, risk assessment, and test strategy. Advisory only - teams choose their quality bar.
43
39
  customization: null
44
40
  persona:
45
41
  role: Test Architect with Quality Advisory Authority
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -19,7 +19,7 @@ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (
19
19
  activation-instructions:
20
20
  - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
21
  - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
- - STEP 3: Load and read `bmad-core/core-config.yaml` (project configuration) before any greeting
22
+ - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
23
23
  - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
24
24
  - DO NOT: Load any other agent files during activation
25
25
  - ONLY load dependency files when user selects them for execution via command or request of a task
@@ -15,7 +15,7 @@ First, determine the project type by checking:
15
15
 
16
16
  2. Is this a BROWNFIELD project (enhancing existing system)?
17
17
  - Look for: References to existing codebase, enhancement/modification language
18
- - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
18
+ - Check for: prd.md, architecture.md, existing system analysis
19
19
 
20
20
  3. Does the project include UI/UX components?
21
21
  - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -33,8 +33,8 @@ For GREENFIELD projects:
33
33
 
34
34
  For BROWNFIELD projects:
35
35
 
36
- - brownfield-prd.md - The brownfield enhancement requirements
37
- - brownfield-architecture.md - The enhancement architecture
36
+ - prd.md - The brownfield enhancement requirements
37
+ - architecture.md - The enhancement architecture
38
38
  - Existing project codebase access (CRITICAL - cannot proceed without this)
39
39
  - Current deployment configuration and infrastructure details
40
40
  - Database schemas, API documentation, monitoring setup
@@ -181,7 +181,7 @@ npx bmad-method install
181
181
 
182
182
  ## Core Configuration (core-config.yaml)
183
183
 
184
- **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.
184
+ **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.
185
185
 
186
186
  ### What is core-config.yaml?
187
187
 
@@ -16,8 +16,8 @@ Implement fixes based on QA results (gate and assessments) for a specific story.
16
16
  ```yaml
17
17
  required:
18
18
  - story_id: '{epic}.{story}' # e.g., "2.2"
19
- - qa_root: from `bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
20
- - story_root: from `bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
19
+ - qa_root: from `.bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
20
+ - story_root: from `.bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
21
21
 
22
22
  optional:
23
23
  - story_title: '{title}' # derive from story H1 if missing
@@ -45,7 +45,7 @@ optional:
45
45
 
46
46
  ### 0) Load Core Config & Locate Story
47
47
 
48
- - Read `bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
48
+ - Read `.bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
49
49
  - Locate story file in `{story_root}/{epic}.{story}.*.md`
50
50
  - HALT if missing and ask for correct story id/path
51
51
 
@@ -113,7 +113,7 @@ Status Rule:
113
113
 
114
114
  ## Blocking Conditions
115
115
 
116
- - Missing `bmad-core/core-config.yaml`
116
+ - Missing `.bmad-core/core-config.yaml`
117
117
  - Story file not found for `story_id`
118
118
  - No QA artifacts found (neither gate nor assessments)
119
119
  - HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)
@@ -9,11 +9,11 @@ Quick NFR validation focused on the core four: security, performance, reliabilit
9
9
  ```yaml
10
10
  required:
11
11
  - story_id: '{epic}.{story}' # e.g., "1.3"
12
- - story_path: `bmad-core/core-config.yaml` for the `devStoryLocation`
12
+ - story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
13
13
 
14
14
  optional:
15
- - architecture_refs: `bmad-core/core-config.yaml` for the `architecture.architectureFile`
16
- - technical_preferences: `bmad-core/core-config.yaml` for the `technicalPreferences`
15
+ - architecture_refs: `.bmad-core/core-config.yaml` for the `architecture.architectureFile`
16
+ - technical_preferences: `.bmad-core/core-config.yaml` for the `technicalPreferences`
17
17
  - acceptance_criteria: From story file
18
18
  ```
19
19
 
@@ -16,7 +16,7 @@ Generate a standalone quality gate file that provides a clear pass/fail decision
16
16
 
17
17
  ## Gate File Location
18
18
 
19
- **ALWAYS** check the `bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
19
+ **ALWAYS** check the `.bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
20
20
 
21
21
  Slug rules:
22
22
 
@@ -126,7 +126,7 @@ waiver:
126
126
 
127
127
  ## Output Requirements
128
128
 
129
- 1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `bmad-core/core-config.yaml`
129
+ 1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `.bmad-core/core-config.yaml`
130
130
  2. **ALWAYS** append this exact format to story's QA Results section:
131
131
 
132
132
  ```text
@@ -186,7 +186,7 @@ NFR assessment: qa.qaLocation/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
186
186
  **Template and Directory:**
187
187
 
188
188
  - Render from `../templates/qa-gate-tmpl.yaml`
189
- - Create directory defined in `qa.qaLocation/gates` (see `bmad-core/core-config.yaml`) if missing
189
+ - Create directory defined in `qa.qaLocation/gates` (see `.bmad-core/core-config.yaml`) if missing
190
190
  - Save to: `qa.qaLocation/gates/{epic}.{story}-{slug}.yml`
191
191
 
192
192
  Gate file structure:
@@ -23,7 +23,7 @@ sections:
23
23
  1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
24
24
 
25
25
  2. **REQUIRED INPUTS**:
26
- - Completed brownfield-prd.md
26
+ - Completed prd.md
27
27
  - Existing project technical documentation (from docs folder or user-provided)
28
28
  - Access to existing project structure (IDE or uploaded files)
29
29
 
@@ -109,8 +109,8 @@ sections:
109
109
  - **UI/UX Consistency:** {{ui_compatibility}}
110
110
  - **Performance Impact:** {{performance_constraints}}
111
111
 
112
- - id: tech-stack-alignment
113
- title: Tech Stack Alignment
112
+ - id: tech-stack
113
+ title: Tech Stack
114
114
  instruction: |
115
115
  Ensure new components align with existing technology choices:
116
116
 
@@ -272,8 +272,8 @@ sections:
272
272
 
273
273
  **Error Handling:** {{error_handling_strategy}}
274
274
 
275
- - id: source-tree-integration
276
- title: Source Tree Integration
275
+ - id: source-tree
276
+ title: Source Tree
277
277
  instruction: |
278
278
  Define how new code will integrate with existing project structure:
279
279
 
@@ -342,7 +342,7 @@ sections:
342
342
  **Monitoring:** {{monitoring_approach}}
343
343
 
344
344
  - id: coding-standards
345
- title: Coding Standards and Conventions
345
+ title: Coding Standards
346
346
  instruction: |
347
347
  Ensure new code follows existing project conventions:
348
348
 
@@ -105,7 +105,6 @@ dependencies:
105
105
 
106
106
  ==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
107
107
  <!-- Powered by BMAD™ Core -->
108
-
109
108
  # Advanced Elicitation Task
110
109
 
111
110
  ## Purpose
@@ -227,7 +226,6 @@ Choose a number (0-8) or 9 to proceed:
227
226
 
228
227
  ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
229
228
  <!-- Powered by BMAD™ Core -->
230
-
231
229
  # Create Deep Research Prompt Task
232
230
 
233
231
  This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -510,7 +508,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
510
508
 
511
509
  ==================== START: .bmad-core/tasks/create-doc.md ====================
512
510
  <!-- Powered by BMAD™ Core -->
513
-
514
511
  # Create Document from Template (YAML Driven)
515
512
 
516
513
  ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -616,7 +613,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
616
613
 
617
614
  ==================== START: .bmad-core/tasks/document-project.md ====================
618
615
  <!-- Powered by BMAD™ Core -->
619
-
620
616
  # Document an Existing Project
621
617
 
622
618
  ## Purpose
@@ -963,11 +959,10 @@ Apply the advanced elicitation task after major sections to refine based on user
963
959
  ==================== END: .bmad-core/tasks/document-project.md ====================
964
960
 
965
961
  ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
966
- ## <!-- Powered by BMAD™ Core -->
967
-
962
+ <!-- Powered by BMAD™ Core -->
963
+ ---
968
964
  docOutputLocation: docs/brainstorming-session-results.md
969
965
  template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
970
-
971
966
  ---
972
967
 
973
968
  # Facilitate Brainstorming Session Task
@@ -2055,7 +2050,6 @@ sections:
2055
2050
 
2056
2051
  ==================== START: .bmad-core/data/bmad-kb.md ====================
2057
2052
  <!-- Powered by BMAD™ Core -->
2058
-
2059
2053
  # BMAD™ Knowledge Base
2060
2054
 
2061
2055
  ## Overview
@@ -2158,7 +2152,6 @@ npx bmad-method install
2158
2152
  - **Cline**: VS Code extension with AI features
2159
2153
  - **Roo Code**: Web-based IDE with agent support
2160
2154
  - **GitHub Copilot**: VS Code extension with AI peer programming assistant
2161
- - **Auggie CLI (Augment Code)**: AI-powered development environment
2162
2155
 
2163
2156
  **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.
2164
2157
 
@@ -2237,7 +2230,7 @@ npx bmad-method install
2237
2230
 
2238
2231
  ## Core Configuration (core-config.yaml)
2239
2232
 
2240
- **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.
2233
+ **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.
2241
2234
 
2242
2235
  ### What is core-config.yaml?
2243
2236
 
@@ -2867,7 +2860,6 @@ Use the **expansion-creator** pack to build your own:
2867
2860
 
2868
2861
  ==================== START: .bmad-core/data/brainstorming-techniques.md ====================
2869
2862
  <!-- Powered by BMAD™ Core -->
2870
-
2871
2863
  # Brainstorming Techniques Data
2872
2864
 
2873
2865
  ## Creative Expansion
@@ -106,7 +106,6 @@ dependencies:
106
106
 
107
107
  ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
108
108
  <!-- Powered by BMAD™ Core -->
109
-
110
109
  # Create Deep Research Prompt Task
111
110
 
112
111
  This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -389,7 +388,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
389
388
 
390
389
  ==================== START: .bmad-core/tasks/create-doc.md ====================
391
390
  <!-- Powered by BMAD™ Core -->
392
-
393
391
  # Create Document from Template (YAML Driven)
394
392
 
395
393
  ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -495,7 +493,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
495
493
 
496
494
  ==================== START: .bmad-core/tasks/document-project.md ====================
497
495
  <!-- Powered by BMAD™ Core -->
498
-
499
496
  # Document an Existing Project
500
497
 
501
498
  ## Purpose
@@ -843,7 +840,6 @@ Apply the advanced elicitation task after major sections to refine based on user
843
840
 
844
841
  ==================== START: .bmad-core/tasks/execute-checklist.md ====================
845
842
  <!-- Powered by BMAD™ Core -->
846
-
847
843
  # Checklist Validation Task
848
844
 
849
845
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -1612,7 +1608,7 @@ sections:
1612
1608
  1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
1613
1609
 
1614
1610
  2. **REQUIRED INPUTS**:
1615
- - Completed brownfield-prd.md
1611
+ - Completed prd.md
1616
1612
  - Existing project technical documentation (from docs folder or user-provided)
1617
1613
  - Access to existing project structure (IDE or uploaded files)
1618
1614
 
@@ -3117,7 +3113,6 @@ sections:
3117
3113
 
3118
3114
  ==================== START: .bmad-core/checklists/architect-checklist.md ====================
3119
3115
  <!-- Powered by BMAD™ Core -->
3120
-
3121
3116
  # Architect Solution Validation Checklist
3122
3117
 
3123
3118
  This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
@@ -3560,7 +3555,6 @@ After presenting the report, ask the user if they would like detailed analysis o
3560
3555
 
3561
3556
  ==================== START: .bmad-core/data/technical-preferences.md ====================
3562
3557
  <!-- Powered by BMAD™ Core -->
3563
-
3564
3558
  # User-Defined Preferred Patterns and Preferences
3565
3559
 
3566
3560
  None Listed