bmad-method 4.9.0 → 4.9.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 (40) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/bmad-core/tasks/shard-doc.md +1 -1
  3. package/bmad-core/templates/architecture-tmpl.md +2 -2
  4. package/bmad-core/templates/brownfield-architecture-tmpl.md +2 -2
  5. package/bmad-core/templates/front-end-spec-tmpl.md +1 -1
  6. package/bmad-core/utils/workflow-management.md +5 -5
  7. package/bmad-core/workflows/brownfield-service.yml +1 -1
  8. package/dist/agents/architect.txt +4 -4
  9. package/dist/agents/bmad-master.txt +11 -11
  10. package/dist/agents/bmad-orchestrator.txt +5 -5
  11. package/dist/agents/dev.txt +9 -17
  12. package/dist/agents/pm.txt +1 -1
  13. package/dist/agents/po.txt +1 -1
  14. package/dist/agents/ux-expert.txt +1 -1
  15. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +144 -18
  16. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +139 -95
  17. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +39 -0
  18. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +310 -118
  19. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +16 -16
  20. package/dist/expansion-packs/expansion-creator/agents/bmad-the-creator.txt +25 -27
  21. package/dist/teams/team-all.txt +20 -28
  22. package/dist/teams/team-fullstack.txt +11 -11
  23. package/dist/teams/team-ide-minimal.txt +15 -23
  24. package/dist/teams/team-no-ui.txt +10 -10
  25. package/docs/core-architecture.md +5 -3
  26. package/docs/how-to-contribute-with-pull-requests.md +6 -6
  27. package/docs/user-guide.md +51 -66
  28. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +107 -87
  29. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.md +4 -4
  30. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.md +21 -2
  31. package/expansion-packs/bmad-infrastructure-devops/README.md +5 -5
  32. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.md +0 -0
  33. package/expansion-packs/expansion-creator/tasks/create-agent.md +10 -10
  34. package/expansion-packs/expansion-creator/tasks/generate-expansion-pack.md +2 -4
  35. package/expansion-packs/expansion-creator/templates/agent-teams-tmpl.md +6 -6
  36. package/expansion-packs/expansion-creator/templates/agent-tmpl.md +15 -15
  37. package/expansion-packs/expansion-creator/utils/workflow-management.md +8 -8
  38. package/package.json +1 -1
  39. package/tools/installer/README.md +3 -3
  40. package/tools/installer/package.json +1 -1
@@ -122,9 +122,10 @@ Difficulty
122
122
  |/ /
123
123
  +-----------> Level Number
124
124
  Tutorial Early Mid Late
125
- ```text
125
+ ````
126
126
 
127
127
  **Scaling Parameters:**
128
+
128
129
  - Enemy count: {{start_count}} → {{end_count}}
129
130
  - Enemy difficulty: {{start_diff}} → {{end_diff}}
130
131
  - Level complexity: {{start_complex}} → {{end_complex}}
@@ -135,6 +136,7 @@ Difficulty
135
136
  [[LLM: Define how players access new levels]]
136
137
 
137
138
  **Progression Gates:**
139
+
138
140
  - Linear progression: Complete previous level
139
141
  - Star requirements: {{star_count}} stars to unlock
140
142
  - Skill gates: Demonstrate {{skill_requirement}}
@@ -149,14 +151,17 @@ Difficulty
149
151
  [[LLM: Define all environmental components that can be used in levels]]
150
152
 
151
153
  **Terrain Types:**
154
+
152
155
  - {{terrain_1}}: {{properties_and_usage}}
153
156
  - {{terrain_2}}: {{properties_and_usage}}
154
157
 
155
158
  **Interactive Objects:**
159
+
156
160
  - {{object_1}}: {{behavior_and_purpose}}
157
161
  - {{object_2}}: {{behavior_and_purpose}}
158
162
 
159
163
  **Hazards and Obstacles:**
164
+
160
165
  - {{hazard_1}}: {{damage_and_behavior}}
161
166
  - {{hazard_2}}: {{damage_and_behavior}}
162
167
 
@@ -165,15 +170,18 @@ Difficulty
165
170
  [[LLM: Define all collectible items and their placement rules]]
166
171
 
167
172
  **Collectible Types:**
173
+
168
174
  - {{collectible_1}}: {{value_and_purpose}}
169
175
  - {{collectible_2}}: {{value_and_purpose}}
170
176
 
171
177
  **Placement Guidelines:**
178
+
172
179
  - Mandatory collectibles: {{placement_rules}}
173
180
  - Optional collectibles: {{placement_rules}}
174
181
  - Secret collectibles: {{placement_rules}}
175
182
 
176
183
  **Reward Distribution:**
184
+
177
185
  - Easy to find: {{percentage}}%
178
186
  - Moderate challenge: {{percentage}}%
179
187
  - High skill required: {{percentage}}%
@@ -183,15 +191,18 @@ Difficulty
183
191
  [[LLM: Define how enemies should be placed and balanced in levels]]
184
192
 
185
193
  **Enemy Categories:**
194
+
186
195
  - {{enemy_type_1}}: {{behavior_and_usage}}
187
196
  - {{enemy_type_2}}: {{behavior_and_usage}}
188
197
 
189
198
  **Placement Principles:**
199
+
190
200
  - Introduction encounters: {{guideline}}
191
201
  - Standard encounters: {{guideline}}
192
202
  - Challenge encounters: {{guideline}}
193
203
 
194
204
  **Difficulty Scaling:**
205
+
195
206
  - Enemy count progression: {{scaling_rule}}
196
207
  - Enemy type introduction: {{pacing_rule}}
197
208
  - Encounter complexity: {{complexity_rule}}
@@ -203,12 +214,14 @@ Difficulty
203
214
  ### Level Layout Principles
204
215
 
205
216
  **Spatial Design:**
217
+
206
218
  - Grid size: {{grid_dimensions}}
207
219
  - Minimum path width: {{width_units}}
208
220
  - Maximum vertical distance: {{height_units}}
209
221
  - Safe zones placement: {{safety_guidelines}}
210
222
 
211
223
  **Navigation Design:**
224
+
212
225
  - Clear path indication: {{visual_cues}}
213
226
  - Landmark placement: {{landmark_rules}}
214
227
  - Dead end avoidance: {{dead_end_policy}}
@@ -219,11 +232,13 @@ Difficulty
219
232
  [[LLM: Define how to control the rhythm and pace of gameplay within levels]]
220
233
 
221
234
  **Action Sequences:**
235
+
222
236
  - High intensity duration: {{max_duration}}
223
237
  - Rest period requirement: {{min_rest_time}}
224
238
  - Intensity variation: {{pacing_pattern}}
225
239
 
226
240
  **Learning Sequences:**
241
+
227
242
  - New mechanic introduction: {{teaching_method}}
228
243
  - Practice opportunity: {{practice_duration}}
229
244
  - Skill application: {{application_context}}
@@ -233,12 +248,14 @@ Difficulty
233
248
  [[LLM: Define how to create appropriate challenges for each level type]]
234
249
 
235
250
  **Challenge Types:**
251
+
236
252
  - Execution challenges: {{skill_requirements}}
237
253
  - Puzzle challenges: {{complexity_guidelines}}
238
254
  - Time challenges: {{time_pressure_rules}}
239
255
  - Resource challenges: {{resource_management}}
240
256
 
241
257
  **Difficulty Calibration:**
258
+
242
259
  - Skill check frequency: {{frequency_guidelines}}
243
260
  - Failure recovery: {{retry_mechanics}}
244
261
  - Hint system integration: {{help_system}}
@@ -252,11 +269,13 @@ Difficulty
252
269
  [[LLM: Define how level data should be structured for implementation]]
253
270
 
254
271
  **Level File Format:**
272
+
255
273
  - Data format: {{json|yaml|custom}}
256
274
  - File naming: `level_{{world}}_{{number}}.{{extension}}`
257
275
  - Data organization: {{structure_description}}
258
276
 
259
277
  **Required Data Fields:**
278
+
260
279
  ```json
261
280
  {
262
281
  "levelId": "{{unique_identifier}}",
@@ -281,7 +300,7 @@ Difficulty
281
300
  }
282
301
  ]
283
302
  }
284
- ````
303
+ ```
285
304
 
286
305
  ### Asset Integration
287
306
 
@@ -64,15 +64,15 @@ This expansion pack integrates with the core BMAD flow at these points:
64
64
 
65
65
  To install this expansion pack, run:
66
66
 
67
- ````bash
67
+ ```bash
68
68
  npm run install:expansion infrastructure
69
- ```text
69
+ ```
70
70
 
71
71
  Or manually:
72
72
 
73
73
  ```bash
74
74
  node tools/install-expansion-pack.js infrastructure
75
- ```text
75
+ ```
76
76
 
77
77
  This will:
78
78
 
@@ -92,7 +92,7 @@ After the main architecture is complete:
92
92
 
93
93
  # Or directly with DevOps agent
94
94
  npm run agent devops
95
- ```text
95
+ ```
96
96
 
97
97
  ### 2. Platform Implementation
98
98
 
@@ -101,7 +101,7 @@ With an approved infrastructure architecture:
101
101
  ```bash
102
102
  # DevOps agent implements the platform
103
103
  *implement-platform
104
- ````
104
+ ```
105
105
 
106
106
  ### 3. Infrastructure Validation
107
107
 
@@ -55,7 +55,7 @@ Determine:
55
55
 
56
56
  **Track Created Items:**
57
57
 
58
- ````text
58
+ ```text
59
59
  Created during agent setup:
60
60
  - Tasks:
61
61
  - [ ] task-name-1.md
@@ -63,7 +63,7 @@ Created during agent setup:
63
63
  - Templates:
64
64
  - [ ] template-name-1.md
65
65
  - [ ] template-name-2.md
66
- ```text
66
+ ```
67
67
 
68
68
  ### 4. Create Agent File
69
69
 
@@ -121,7 +121,7 @@ Present to the user:
121
121
  1. Review and customize the created tasks/templates
122
122
  2. Run npm run build:agents
123
123
  3. Test the agent thoroughly
124
- ```text
124
+ ```
125
125
 
126
126
  ## Template Reference
127
127
 
@@ -150,7 +150,7 @@ persona:
150
150
  - Data integrity and accuracy above all
151
151
  - Clear communication of complex findings
152
152
  - Actionable insights over raw numbers
153
- ```text
153
+ ```
154
154
 
155
155
  ## Creating Missing Dependencies
156
156
 
@@ -183,13 +183,13 @@ When a required task or template doesn't exist:
183
183
  ```yaml
184
184
  dependencies:
185
185
  tasks:
186
- - 'create-doc # Required if agent creates any documents'
187
- - 'analyze-requirements # Custom task for this agent'
188
- - 'generate-report # Another custom task'
186
+ - create-doc
187
+ - analyze-requirements
188
+ - generate-report
189
189
  templates:
190
- - 'requirements-doc # Template for requirements documents'
191
- - 'analysis-report # Template for analysis reports'
192
- ````
190
+ - requirements-doc
191
+ - analysis-report
192
+ ```
193
193
 
194
194
  ## Notes
195
195
 
@@ -673,7 +673,7 @@ Before declaring complete:
673
673
 
674
674
  **README Structure with Character Introduction:**
675
675
 
676
- ````markdown
676
+ ```markdown
677
677
  # {Pack Name} Expansion Pack
678
678
 
679
679
  ## Meet Your {Domain} Team
@@ -698,9 +698,7 @@ _{Professional background and expertise}_
698
698
 
699
699
  2. **Launch Orchestrator**:
700
700
 
701
- ```bash
702
701
  npm run agent {pack-name}-orchestrator
703
- ```
704
702
 
705
703
  3. **Follow Numbered Options**: {Character Name} will present numbered choices for each decision
706
704
 
@@ -730,7 +728,7 @@ _{Professional background and expertise}_
730
728
  ### Knowledge Base
731
729
 
732
730
  [Embedded domain expertise]
733
- ````
731
+ ```
734
732
 
735
733
  #### 6.3 Advanced Data File Documentation with Validation
736
734
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  [[LLM: This template is for creating agent team configurations in YAML format. Follow the structure carefully and replace all placeholders with appropriate values. The team name should reflect the team's purpose and domain focus.]]
4
4
 
5
- ````yaml
5
+ ```yaml
6
6
  bundle:
7
7
  name: {{team-display-name}}
8
8
  [[LLM: Use format "Team [Descriptor]" for generic teams or "[Domain] Team" for specialized teams. Examples: "Team Fullstack", "Healthcare Team", "Legal Team"]]
@@ -83,7 +83,7 @@ workflows:
83
83
  - {{workflow-name}} # {{workflow-description}}
84
84
  <</REPEAT>>
85
85
  ^^/CONDITION: domain-workflows^^
86
- ```text
86
+ ```
87
87
 
88
88
  @{example-1: Standard fullstack team}
89
89
 
@@ -107,11 +107,11 @@ workflows:
107
107
  - brownfield-fullstack
108
108
  - brownfield-service
109
109
  - brownfield-ui
110
- ````
110
+ ```
111
111
 
112
112
  @{example-2: Healthcare expansion pack team}
113
113
 
114
- ````yaml
114
+ ```yaml
115
115
  bundle:
116
116
  name: Healthcare Compliance Team
117
117
  icon: ⚕️
@@ -127,7 +127,7 @@ workflows:
127
127
  - healthcare-patient-portal
128
128
  - healthcare-compliance-audit
129
129
  - clinical-trial-management
130
- ```text
130
+ ```
131
131
 
132
132
  @{example-3: Minimal IDE team}
133
133
 
@@ -141,7 +141,7 @@ agents:
141
141
  - architect
142
142
  - dev
143
143
  workflows: null
144
- ````
144
+ ```
145
145
 
146
146
  [[LLM: When creating a new team configuration:
147
147
 
@@ -10,7 +10,7 @@
10
10
 
11
11
  CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
12
12
 
13
- ````yml
13
+ ```yml
14
14
  activation-instructions:
15
15
  - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
16
16
  - Only read the files/tasks listed here when user selects them for execution to minimize context usage
@@ -70,7 +70,7 @@ dependencies:
70
70
  - [TEMPLATE_1] # Template with LLM instructions for guided creation
71
71
  - [TEMPLATE_2] # Another template for different document type
72
72
  [[LLM: Example: blueprint-tmpl, contract-tmpl, report-tmpl
73
- Each template should include [[LLM: guidance]] and other conventions from `template-formmat.md` sections for user interaction]]
73
+ Each template should include [[LLM: guidance]] and other conventions from `template-format.md` sections for user interaction]]
74
74
 
75
75
  checklists:
76
76
  - [CHECKLIST_1] # Quality validation for template outputs
@@ -86,7 +86,7 @@ dependencies:
86
86
  - template-format # Required if using templates
87
87
  - [UTIL_1] # Other utilities as needed
88
88
  [[LLM: Include workflow-management if agent participates in workflows]]
89
- ```text
89
+ ```
90
90
 
91
91
  @{example: Construction Contractor Agent}
92
92
 
@@ -125,19 +125,19 @@ commands:
125
125
  - '*exit" - Say goodbye as Marcus and exit'
126
126
  dependencies:
127
127
  tasks:
128
- - 'create-doc # For document creation'
129
- - 'validate-plans # Custom validation task'
130
- - 'safety-assessment # Custom safety review task'
128
+ - create-doc
129
+ - validate-plans
130
+ - safety-assessment
131
131
  templates:
132
- - 'blueprint-tmpl # Architectural blueprint template'
133
- - 'estimate-tmpl # Cost estimation template'
134
- - 'schedule-tmpl # Project timeline template'
132
+ - blueprint-tmpl
133
+ - estimate-tmpl
134
+ - schedule-tmpl
135
135
  checklists:
136
- - 'blueprint-checklist # Validates blueprint completeness'
137
- - 'safety-checklist # Safety compliance validation'
136
+ - blueprint-checklist
137
+ - safety-checklist
138
138
  data:
139
- - 'building-codes.md # Local building code reference'
140
- - 'materials-guide.md # Construction materials specs'
139
+ - building-codes.md
140
+ - materials-guide.md
141
141
  utils:
142
- - 'template-format # For template processing'
143
- ````
142
+ - template-format
143
+ ```
@@ -40,14 +40,14 @@ The actual list depends on which team bundle is loaded. When responding to this
40
40
 
41
41
  Example response format:
42
42
 
43
- ````text
43
+ ```text
44
44
  Available workflows for [Team Name]:
45
45
  1. [workflow-id] - [Brief description based on workflow type]
46
46
  2. [workflow-id] - [Brief description based on workflow type]
47
47
  [... etc. ...]
48
48
 
49
49
  Use /workflow-start {number or id} to begin a workflow.
50
- ```text
50
+ ```
51
51
 
52
52
  ### /workflow-start {workflow-id}
53
53
 
@@ -73,7 +73,7 @@ In Progress:
73
73
  - Create PRD (John) - awaiting input
74
74
 
75
75
  Next: Technical Architecture
76
- ```text
76
+ ```
77
77
 
78
78
  ### /workflow-resume
79
79
 
@@ -89,7 +89,7 @@ BMad: I see you've completed Discovery and part of Product Planning.
89
89
  - UX Strategy with Sally (ux-expert)
90
90
 
91
91
  Would you like me to load Sally to continue?
92
- ```text
92
+ ```
93
93
 
94
94
  ### /workflow-next
95
95
 
@@ -135,7 +135,7 @@ workflow_state:
135
135
  status: in-progress
136
136
  created_by: pm
137
137
  started: 2024-01-15T11:00:00.000Z
138
- ```text
138
+ ```
139
139
 
140
140
  ### 4. Workflow Interruption Handling
141
141
 
@@ -159,7 +159,7 @@ BMad: I see you have a PRD and architecture document. Based on these artifacts,
159
159
  - Load Sarah (Product Owner) to validate all artifacts
160
160
 
161
161
  Would you like to continue with this workflow?
162
- ```text
162
+ ```
163
163
 
164
164
  ## Workflow Context Passing
165
165
 
@@ -185,7 +185,7 @@ Sally: I see we're in the Product Planning stage of the greenfield-fullstack wor
185
185
 
186
186
  Let's create the UX strategy and UI specifications. First, let me review
187
187
  the PRD to understand the features we're designing for...
188
- ```text
188
+ ```
189
189
 
190
190
  ## Multi-Path Workflows
191
191
 
@@ -198,7 +198,7 @@ conditional_paths:
198
198
  - condition: project_type == 'web'
199
199
  next_stage: web-architecture
200
200
  - default: fullstack-architecture
201
- ````
201
+ ```
202
202
 
203
203
  Handle these by asking clarifying questions when needed.
204
204
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.9.0",
3
+ "version": "4.9.2",
4
4
  "description": "Breakthrough Method of Agile AI-driven Development",
5
5
  "main": "tools/cli.js",
6
6
  "bin": {
@@ -33,7 +33,7 @@ installer/
33
33
 
34
34
  ## Usage
35
35
 
36
- ````bash
36
+ ```bash
37
37
  # Interactive installation
38
38
  npx bmad-method install
39
39
 
@@ -42,7 +42,7 @@ npx bmad-method install --profile=minimal
42
42
 
43
43
  # Update existing installation
44
44
  npx bmad-method update
45
- ```text
45
+ ```
46
46
 
47
47
  ## Development
48
48
 
@@ -55,4 +55,4 @@ npm test
55
55
 
56
56
  # Lint code
57
57
  npm run lint
58
- ````
58
+ ```
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.9.0",
3
+ "version": "4.9.2",
4
4
  "description": "BMAD Method installer - AI-powered Agile development framework",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {