bmad-method 4.2.0 → 4.4.0
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/.bmad-core/agents/analyst.md +14 -20
- package/.bmad-core/agents/architect.md +15 -20
- package/.bmad-core/agents/bmad-master.md +18 -26
- package/.bmad-core/agents/bmad-orchestrator.md +16 -28
- package/.bmad-core/agents/dev.md +5 -4
- package/.bmad-core/agents/pm.md +11 -16
- package/.bmad-core/agents/sm.md +20 -25
- package/.bmad-core/bmad-core-config.yml +60 -0
- package/.bmad-core/data/bmad-kb.md +12 -1
- package/.bmad-core/tasks/doc-migration-task.md +91 -146
- package/.bmad-core/tasks/document-project.md +389 -0
- package/.bmad-core/tasks/generate-ai-frontend-prompt.md +41 -48
- package/.bmad-core/tasks/index-docs.md +8 -3
- package/.bmad-core/templates/architecture-tmpl.md +15 -12
- package/.bmad-core/templates/fullstack-architecture-tmpl.md +85 -103
- package/.bmad-core/templates/prd-tmpl.md +1 -1
- package/.bmad-core/templates/simple-project-prd-tmpl.md +461 -0
- package/.bmad-core/templates/story-tmpl.md +2 -2
- package/.bmad-core/utils/workflow-management.md +14 -15
- package/.bmad-core/web-bundles/agents/analyst.txt +26 -21
- package/.bmad-core/web-bundles/agents/architect.txt +605 -233
- package/.bmad-core/web-bundles/agents/bmad-master.txt +457 -1039
- package/.bmad-core/web-bundles/agents/bmad-orchestrator.txt +36 -903
- package/.bmad-core/web-bundles/agents/dev.txt +5 -4
- package/.bmad-core/web-bundles/agents/pm.txt +476 -17
- package/.bmad-core/web-bundles/agents/po.txt +2 -2
- package/.bmad-core/web-bundles/agents/sm.txt +22 -27
- package/.bmad-core/web-bundles/agents/ux-expert.txt +41 -48
- package/.bmad-core/web-bundles/teams/team-all.txt +4394 -4447
- package/.bmad-core/web-bundles/teams/team-fullstack.txt +2760 -2809
- package/.bmad-core/web-bundles/teams/team-no-ui.txt +2718 -2760
- package/.bmad-core/workflows/greenfield-fullstack.yml +3 -3
- package/.claude/commands/analyst.md +14 -20
- package/.claude/commands/architect.md +15 -20
- package/.claude/commands/bmad-master.md +18 -26
- package/.claude/commands/bmad-orchestrator.md +16 -28
- package/.claude/commands/dev.md +5 -4
- package/.claude/commands/pm.md +11 -16
- package/.claude/commands/sm.md +20 -25
- package/.cursor/rules/analyst.mdc +13 -19
- package/.cursor/rules/architect.mdc +14 -19
- package/.cursor/rules/bmad-master.mdc +18 -26
- package/.cursor/rules/bmad-orchestrator.mdc +15 -27
- package/.cursor/rules/dev.mdc +5 -4
- package/.cursor/rules/pm.mdc +11 -16
- package/.cursor/rules/sm.mdc +19 -24
- package/.releaserc.json +2 -1
- package/.vscode/settings.json +4 -0
- package/.windsurf/rules/analyst.md +13 -19
- package/.windsurf/rules/architect.md +14 -19
- package/.windsurf/rules/bmad-master.md +18 -26
- package/.windsurf/rules/bmad-orchestrator.md +15 -27
- package/.windsurf/rules/dev.md +5 -4
- package/.windsurf/rules/pm.md +11 -16
- package/.windsurf/rules/sm.md +19 -24
- package/CHANGELOG.md +120 -2
- package/CONTRIBUTING.md +2 -0
- package/README.md +20 -2
- package/{.bmad-core → creator-tools}/tasks/create-agent.md +10 -12
- package/{.bmad-core/tasks/create-expansion-pack.md → creator-tools/tasks/generate-expansion-pack.md} +8 -6
- package/docs/bmad-workflow-guide.md +161 -0
- package/docs/claude-code-guide.md +119 -0
- package/docs/core-architecture.md +213 -0
- package/docs/cursor-guide.md +127 -0
- package/docs/how-to-contribute-with-pull-requests.md +141 -0
- package/docs/roo-code-guide.md +140 -0
- package/docs/user-guide.md +1044 -0
- package/docs/versioning-and-releases.md +4 -4
- package/docs/windsurf-guide.md +127 -0
- package/expansion-packs/README.md +1 -111
- package/expansion-packs/infrastructure-devops/agents/infra-devops-platform.md +3 -3
- package/expansion-packs/infrastructure-devops/tasks/create-doc.md +74 -0
- package/package.json +19 -13
- package/tools/builders/web-builder.js +16 -15
- package/tools/installer/README.md +2 -2
- package/tools/installer/bin/bmad.js +50 -29
- package/tools/installer/lib/file-manager.js +20 -3
- package/tools/installer/lib/ide-setup.js +11 -1
- package/tools/installer/lib/installer.js +149 -29
- package/tools/installer/package-lock.json +537 -335
- package/tools/installer/package.json +7 -7
- package/tools/lib/dependency-resolver.js +1 -1
- package/tools/semantic-release-sync-installer.js +31 -0
- package/tools/sync-installer-version.js +34 -0
- package/tools/upgraders/v3-to-v4-upgrader.js +18 -13
- package/tools/version-bump.js +33 -26
- package/tools/yaml-format.js +54 -25
- package/.bmad-core/schemas/agent-team-schema.yml +0 -153
- package/.bmad-core/tasks/create-team.md +0 -229
- package/.claude/settings.local.json +0 -22
|
@@ -1,229 +0,0 @@
|
|
|
1
|
-
# Create Team Task
|
|
2
|
-
|
|
3
|
-
This task guides you through creating a new BMAD agent team that conforms to the agent-team schema and effectively combines agents for specific project types.
|
|
4
|
-
|
|
5
|
-
**Note for User-Created Teams**: If creating a custom team for your own use (not part of the core BMAD system), prefix the team name with a period (e.g., `.team-frontend`) to ensure it's gitignored and won't conflict with repository updates.
|
|
6
|
-
|
|
7
|
-
## Prerequisites
|
|
8
|
-
|
|
9
|
-
1. Load and understand the team schema: `/bmad-core/schemas/agent-team-schema.yml`
|
|
10
|
-
2. Review existing teams in `/bmad-core/agent-teams/` for patterns and naming conventions
|
|
11
|
-
3. List available agents from `/agents/` to understand team composition options
|
|
12
|
-
4. Review workflows in `/bmad-core/workflows/` to align team capabilities
|
|
13
|
-
|
|
14
|
-
## Process
|
|
15
|
-
|
|
16
|
-
### 1. Define Team Purpose and Scope
|
|
17
|
-
|
|
18
|
-
Before selecting agents, clarify the team's mission:
|
|
19
|
-
|
|
20
|
-
- **Team Purpose**: What specific problems will this team solve?
|
|
21
|
-
- **Project Types**: Greenfield, brownfield, or both?
|
|
22
|
-
- **Technical Scope**: UI-focused, backend-only, or full-stack?
|
|
23
|
-
- **Team Size Consideration**: Smaller teams (3-5 agents) for focused work, larger teams (6-8) for comprehensive coverage
|
|
24
|
-
|
|
25
|
-
### 2. Create Team Metadata
|
|
26
|
-
|
|
27
|
-
Based on the schema requirements:
|
|
28
|
-
|
|
29
|
-
- **Team Name**: Must follow pattern `^Team .+$` (e.g., "Team Frontend", "Team Analytics")
|
|
30
|
-
- For user teams: prefix with period (e.g., "Team .MyCustom")
|
|
31
|
-
- **Description**: 20-500 characters explaining team's purpose, capabilities, and use cases
|
|
32
|
-
- **File Name**: `/bmad-core/agent-teams/team-{identifier}.yml`
|
|
33
|
-
- For user teams: `/bmad-core/agent-teams/.team-{identifier}.yml`
|
|
34
|
-
|
|
35
|
-
### 3. Select Agents Based on Purpose
|
|
36
|
-
|
|
37
|
-
#### Discover Available Agents
|
|
38
|
-
|
|
39
|
-
1. List all agents from `/agents/` directory
|
|
40
|
-
2. Review each agent's role and capabilities
|
|
41
|
-
3. Consider agent synergies and coverage
|
|
42
|
-
|
|
43
|
-
#### Agent Selection Guidelines
|
|
44
|
-
|
|
45
|
-
Based on team purpose, recommend agents:
|
|
46
|
-
|
|
47
|
-
**For Planning & Strategy Teams:**
|
|
48
|
-
|
|
49
|
-
- `bmad` (required orchestrator)
|
|
50
|
-
- `analyst` - Requirements gathering and research
|
|
51
|
-
- `pm` - Product strategy and documentation
|
|
52
|
-
- `po` - Validation and approval
|
|
53
|
-
- `architect` - Technical planning (if technical planning needed)
|
|
54
|
-
|
|
55
|
-
**For Design & UX Teams:**
|
|
56
|
-
|
|
57
|
-
- `bmad` (required orchestrator)
|
|
58
|
-
- `ux-expert` - User experience design
|
|
59
|
-
- `architect` - Frontend architecture
|
|
60
|
-
- `pm` - Product requirements alignment
|
|
61
|
-
- `po` - Design validation
|
|
62
|
-
|
|
63
|
-
**For Development Teams:**
|
|
64
|
-
|
|
65
|
-
- `bmad-orchestrator` (required)
|
|
66
|
-
- `sm` - Sprint coordination
|
|
67
|
-
- `dev` - Implementation
|
|
68
|
-
- `qa` - Quality assurance
|
|
69
|
-
- `architect` - Technical guidance
|
|
70
|
-
|
|
71
|
-
**For Full-Stack Teams:**
|
|
72
|
-
|
|
73
|
-
- `bmad-orchestrator` (required)
|
|
74
|
-
- `analyst` - Initial planning
|
|
75
|
-
- `pm` - Product management
|
|
76
|
-
- `ux-expert` - UI/UX design (if UI work included)
|
|
77
|
-
- `architect` - System architecture
|
|
78
|
-
- `po` - Validation
|
|
79
|
-
- Additional agents as needed
|
|
80
|
-
|
|
81
|
-
#### Special Cases
|
|
82
|
-
|
|
83
|
-
- **Using Wildcard**: If team needs all agents, use `["bmad", "*"]`
|
|
84
|
-
- **Validation**: Schema requires `bmad` in all teams
|
|
85
|
-
|
|
86
|
-
### 4. Select Workflows
|
|
87
|
-
|
|
88
|
-
Based on the schema's workflow enum values and team composition:
|
|
89
|
-
|
|
90
|
-
1. **Analyze team capabilities** against available workflows:
|
|
91
|
-
|
|
92
|
-
- `brownfield-fullstack` - Requires full team with UX
|
|
93
|
-
- `brownfield-service` - Backend-focused team
|
|
94
|
-
- `brownfield-ui` - UI/UX-focused team
|
|
95
|
-
- `greenfield-fullstack` - Full team for new projects
|
|
96
|
-
- `greenfield-service` - Backend team for new services
|
|
97
|
-
- `greenfield-ui` - Frontend team for new UIs
|
|
98
|
-
|
|
99
|
-
2. **Match workflows to agents**:
|
|
100
|
-
|
|
101
|
-
- UI workflows require `ux-expert`
|
|
102
|
-
- Service workflows benefit from `architect` and `dev`
|
|
103
|
-
- All workflows benefit from planning agents (`analyst`, `pm`)
|
|
104
|
-
|
|
105
|
-
3. **Apply schema validation rules**:
|
|
106
|
-
- Teams without `ux-expert` shouldn't have UI workflows
|
|
107
|
-
- Teams named "Team No UI" can't have UI workflows
|
|
108
|
-
|
|
109
|
-
### 5. Create Team Configuration
|
|
110
|
-
|
|
111
|
-
Generate the configuration following the schema:
|
|
112
|
-
|
|
113
|
-
```yaml
|
|
114
|
-
bundle:
|
|
115
|
-
name: "{Team Name}" # Must match pattern "^Team .+$"
|
|
116
|
-
description: >-
|
|
117
|
-
{20-500 character description explaining purpose,
|
|
118
|
-
capabilities, and ideal use cases}
|
|
119
|
-
|
|
120
|
-
agents:
|
|
121
|
-
- bmad # Required orchestrator
|
|
122
|
-
- { agent-id-1 }
|
|
123
|
-
- { agent-id-2 }
|
|
124
|
-
# ... additional agents
|
|
125
|
-
|
|
126
|
-
workflows:
|
|
127
|
-
- { workflow-1 } # From enum list
|
|
128
|
-
- { workflow-2 }
|
|
129
|
-
# ... additional workflows
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
### 6. Validate Team Composition
|
|
133
|
-
|
|
134
|
-
Before finalizing, verify:
|
|
135
|
-
|
|
136
|
-
1. **Role Coverage**: Does the team have all necessary skills for its workflows?
|
|
137
|
-
2. **Size Optimization**:
|
|
138
|
-
- Minimum: 2 agents (bmad + 1)
|
|
139
|
-
- Recommended: 3-7 agents
|
|
140
|
-
- Maximum with wildcard: bmad + "\*"
|
|
141
|
-
3. **Workflow Alignment**: Can the selected agents execute all workflows?
|
|
142
|
-
4. **Schema Compliance**: Configuration matches all schema requirements
|
|
143
|
-
|
|
144
|
-
### 7. Integration Recommendations
|
|
145
|
-
|
|
146
|
-
Document how this team integrates with existing system:
|
|
147
|
-
|
|
148
|
-
1. **Complementary Teams**: Which existing teams complement this one?
|
|
149
|
-
2. **Handoff Points**: Where does this team hand off to others?
|
|
150
|
-
3. **Use Case Scenarios**: Specific project types ideal for this team
|
|
151
|
-
|
|
152
|
-
### 8. Validation and Testing
|
|
153
|
-
|
|
154
|
-
1. **Schema Validation**: Ensure configuration matches agent-team-schema.yml
|
|
155
|
-
2. **Build Validation**: Run `npm run validate`
|
|
156
|
-
3. **Build Team**: Run `npm run build:team -t {team-name}`
|
|
157
|
-
4. **Size Check**: Verify output is appropriate for target platform
|
|
158
|
-
5. **Test Scenarios**: Run sample workflows with the team
|
|
159
|
-
|
|
160
|
-
## Example Team Creation
|
|
161
|
-
|
|
162
|
-
### Example 1: API Development Team
|
|
163
|
-
|
|
164
|
-
```yaml
|
|
165
|
-
bundle:
|
|
166
|
-
name: "Team API"
|
|
167
|
-
description: >-
|
|
168
|
-
Specialized team for API and backend service development. Focuses on
|
|
169
|
-
robust service architecture, implementation, and testing without UI
|
|
170
|
-
components. Ideal for microservices, REST APIs, and backend systems.
|
|
171
|
-
|
|
172
|
-
agents:
|
|
173
|
-
- bmad
|
|
174
|
-
- analyst
|
|
175
|
-
- architect
|
|
176
|
-
- dev
|
|
177
|
-
- qa
|
|
178
|
-
- po
|
|
179
|
-
|
|
180
|
-
workflows:
|
|
181
|
-
- greenfield-service
|
|
182
|
-
- brownfield-service
|
|
183
|
-
```
|
|
184
|
-
|
|
185
|
-
### Example 2: Rapid Prototyping Team
|
|
186
|
-
|
|
187
|
-
```yaml
|
|
188
|
-
bundle:
|
|
189
|
-
name: "Team Prototype"
|
|
190
|
-
description: >-
|
|
191
|
-
Agile team for rapid prototyping and proof of concept development.
|
|
192
|
-
Combines planning, design, and implementation for quick iterations
|
|
193
|
-
on new ideas and experimental features.
|
|
194
|
-
|
|
195
|
-
agents:
|
|
196
|
-
- bmad
|
|
197
|
-
- pm
|
|
198
|
-
- ux-expert
|
|
199
|
-
- architect
|
|
200
|
-
- dev
|
|
201
|
-
|
|
202
|
-
workflows:
|
|
203
|
-
- greenfield-ui
|
|
204
|
-
- greenfield-fullstack
|
|
205
|
-
```
|
|
206
|
-
|
|
207
|
-
## Team Creation Checklist
|
|
208
|
-
|
|
209
|
-
- [ ] Team purpose clearly defined
|
|
210
|
-
- [ ] Name follows schema pattern "Team {Name}"
|
|
211
|
-
- [ ] Description is 20-500 characters
|
|
212
|
-
- [ ] Includes bmad orchestrator
|
|
213
|
-
- [ ] Agents align with team purpose
|
|
214
|
-
- [ ] Workflows match team capabilities
|
|
215
|
-
- [ ] No conflicting validations (e.g., no-UI team with UI workflows)
|
|
216
|
-
- [ ] Configuration validates against schema
|
|
217
|
-
- [ ] Build completes successfully
|
|
218
|
-
- [ ] Output size appropriate for platform
|
|
219
|
-
|
|
220
|
-
## Best Practices
|
|
221
|
-
|
|
222
|
-
1. **Start Focused**: Create teams with specific purposes rather than general-purpose teams
|
|
223
|
-
2. **Consider Workflow**: Order agents by typical workflow sequence
|
|
224
|
-
3. **Avoid Redundancy**: Don't duplicate roles unless needed
|
|
225
|
-
4. **Document Rationale**: Explain why each agent is included
|
|
226
|
-
5. **Test Integration**: Verify team works well with selected workflows
|
|
227
|
-
6. **Iterate**: Refine team composition based on usage
|
|
228
|
-
|
|
229
|
-
This schema-driven approach ensures teams are well-structured, purposeful, and integrate seamlessly with the BMAD ecosystem.
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"permissions": {
|
|
3
|
-
"allow": [
|
|
4
|
-
"Bash(npm run build:*)",
|
|
5
|
-
"Bash(rm:*)",
|
|
6
|
-
"Bash(ls:*)",
|
|
7
|
-
"Bash(cat:*)",
|
|
8
|
-
"Bash(npm install:*)",
|
|
9
|
-
"Bash(npx husky init:*)",
|
|
10
|
-
"Bash(chmod:*)",
|
|
11
|
-
"Bash(node:*)",
|
|
12
|
-
"Bash(git add:*)",
|
|
13
|
-
"Bash(npx lint-staged:*)",
|
|
14
|
-
"Bash(npx prettier:*)",
|
|
15
|
-
"Bash(git commit:*)",
|
|
16
|
-
"Bash(mkdir:*)",
|
|
17
|
-
"Bash(npm run version:minor:*)",
|
|
18
|
-
"Bash(npm uninstall:*)"
|
|
19
|
-
],
|
|
20
|
-
"deny": []
|
|
21
|
-
}
|
|
22
|
-
}
|