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.
- package/.github/ISSUE_TEMPLATE/config.yml +5 -0
- package/.github/workflows/manual-release.yaml +1 -1
- package/PR-opencode-agents-generator.md +40 -0
- package/README.md +38 -44
- package/bmad-core/agents/analyst.md +1 -1
- package/bmad-core/agents/architect.md +1 -1
- package/bmad-core/agents/bmad-master.md +7 -7
- package/bmad-core/agents/bmad-orchestrator.md +2 -2
- package/bmad-core/agents/dev.md +1 -1
- package/bmad-core/agents/pm.md +1 -1
- package/bmad-core/agents/po.md +1 -1
- package/bmad-core/agents/qa.md +2 -6
- package/bmad-core/agents/sm.md +1 -1
- package/bmad-core/agents/ux-expert.md +1 -1
- package/bmad-core/checklists/po-master-checklist.md +3 -3
- package/bmad-core/data/bmad-kb.md +1 -1
- package/bmad-core/tasks/apply-qa-fixes.md +4 -4
- package/bmad-core/tasks/nfr-assess.md +3 -3
- package/bmad-core/tasks/qa-gate.md +2 -2
- package/bmad-core/tasks/review-story.md +1 -1
- package/bmad-core/templates/brownfield-architecture-tmpl.yaml +6 -6
- package/dist/agents/analyst.txt +3 -11
- package/dist/agents/architect.txt +1 -7
- package/dist/agents/bmad-master.txt +7 -31
- package/dist/agents/bmad-orchestrator.txt +1 -8
- package/dist/agents/dev.txt +5 -10
- package/dist/agents/pm.txt +0 -10
- package/dist/agents/po.txt +4 -10
- package/dist/agents/qa.txt +7 -15
- package/dist/agents/sm.txt +0 -4
- package/dist/agents/ux-expert.txt +0 -4
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -6
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +0 -3
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -3
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +2 -25
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +0 -9
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -8
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +1 -4
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -4
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +3 -35
- package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +0 -9
- package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +0 -8
- package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +0 -7
- package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +0 -8
- package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +0 -10
- package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +0 -8
- package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +0 -7
- package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +0 -9
- package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +0 -85
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-developer.txt +2 -2
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-qa.txt +1 -2
- package/dist/expansion-packs/bmad-godot-game-dev/teams/godot-game-team.txt +5 -6
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -5
- package/dist/teams/team-all.txt +34 -69
- package/dist/teams/team-fullstack.txt +23 -46
- package/dist/teams/team-ide-minimal.txt +16 -42
- package/dist/teams/team-no-ui.txt +12 -34
- package/docs/user-guide.md +48 -1
- package/expansion-packs/bmad-godot-game-dev/agents/bmad-orchestrator.md +1 -1
- package/expansion-packs/bmad-godot-game-dev/agents/game-qa.md +1 -2
- package/expansion-packs/bmad-godot-game-dev/tasks/apply-qa-fixes.md +2 -2
- package/package.json +2 -1
- package/tools/installer/bin/bmad.js +46 -1
- package/tools/installer/config/install.config.yaml +18 -7
- package/tools/installer/lib/ide-setup.js +709 -77
- package/tools/installer/lib/installer.js +17 -4
- package/tools/installer/package.json +1 -1
- package/release_notes.md +0 -48
|
@@ -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
|
[](https://www.npmjs.com/package/bmad-method)
|
|
4
4
|
[](LICENSE)
|
|
5
5
|
[](https://nodejs.org)
|
|
6
6
|
[](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
|
|
73
|
+
## Important: Keep Your v4 Installation Updated
|
|
51
74
|
|
|
52
|
-
**Stay up-to-date
|
|
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
|
|
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
|
-
|
|
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
|
|
92
|
+
### One Command Installation
|
|
73
93
|
|
|
74
|
-
**
|
|
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
|
|
100
|
+
This command handles:
|
|
86
101
|
|
|
87
|
-
- **New installations** - Sets up BMad in your project
|
|
88
|
-
- **Upgrades** - Updates existing installations
|
|
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
|
|
119
|
+
### Alternative: Clone v4 Branch
|
|
105
120
|
|
|
106
121
|
```bash
|
|
107
|
-
git clone https://github.com/
|
|
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
|
-
**
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
105
|
-
- brownfield-service.
|
|
106
|
-
- brownfield-ui.
|
|
107
|
-
- greenfield-fullstack.
|
|
108
|
-
- greenfield-service.
|
|
109
|
-
- greenfield-ui.
|
|
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
|
|
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
|
|
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
|
package/bmad-core/agents/dev.md
CHANGED
|
@@ -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
|
|
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
|
package/bmad-core/agents/pm.md
CHANGED
|
@@ -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
|
|
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
|
package/bmad-core/agents/po.md
CHANGED
|
@@ -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
|
|
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
|
package/bmad-core/agents/qa.md
CHANGED
|
@@ -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
|
|
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
|
package/bmad-core/agents/sm.md
CHANGED
|
@@ -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
|
|
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
|
|
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:
|
|
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
|
-
-
|
|
37
|
-
-
|
|
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
|
|
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
|
|
20
|
-
- story_root: from
|
|
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
|
|
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
|
|
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:
|
|
12
|
+
- story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
|
|
13
13
|
|
|
14
14
|
optional:
|
|
15
|
-
- architecture_refs:
|
|
16
|
-
- technical_preferences:
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
113
|
-
title: Tech Stack
|
|
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
|
|
276
|
-
title: Source Tree
|
|
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
|
|
345
|
+
title: Coding Standards
|
|
346
346
|
instruction: |
|
|
347
347
|
Ensure new code follows existing project conventions:
|
|
348
348
|
|
package/dist/agents/analyst.txt
CHANGED
|
@@ -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
|
-
|
|
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
|
|
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
|
|
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
|