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
@@ -1006,7 +1006,7 @@ module "vpc" {
1006
1006
  public_subnets = {{public_subnets}}
1007
1007
  private_subnets = {{private_subnets}}
1008
1008
  }
1009
- ```text
1009
+ ```
1010
1010
 
1011
1011
  ### Security Foundation
1012
1012
 
@@ -1053,7 +1053,7 @@ eksctl create cluster \
1053
1053
  --nodegroup-name {{nodegroup_name}} \
1054
1054
  --node-type {{instance_type}} \
1055
1055
  --nodes {{node_count}}
1056
- ```text
1056
+ ```
1057
1057
 
1058
1058
  ^^/CONDITION: uses_eks^^
1059
1059
 
@@ -1067,7 +1067,7 @@ az aks create \
1067
1067
  --node-count {{node_count}} \
1068
1068
  --node-vm-size {{vm_size}} \
1069
1069
  --network-plugin azure
1070
- ```text
1070
+ ```
1071
1071
 
1072
1072
  ^^/CONDITION: uses_aks^^
1073
1073
 
@@ -1111,11 +1111,11 @@ metadata:
1111
1111
  spec:
1112
1112
  source:
1113
1113
  repoURL:
1114
- '[object Object]': null
1114
+ "[object Object]": null
1115
1115
  targetRevision:
1116
- '[object Object]': null
1116
+ "[object Object]": null
1117
1117
  path:
1118
- '[object Object]': null
1118
+ "[object Object]": null
1119
1119
  ```
1120
1120
 
1121
1121
  ^^/CONDITION: uses_argocd^^
@@ -1132,10 +1132,10 @@ spec:
1132
1132
  interval: 1m
1133
1133
  ref:
1134
1134
  branch:
1135
- '[object Object]': null
1135
+ "[object Object]": null
1136
1136
  url:
1137
- '[object Object]': null
1138
- ```text
1137
+ "[object Object]": null
1138
+ ```
1139
1139
 
1140
1140
  ^^/CONDITION: uses_flux^^
1141
1141
 
@@ -1153,7 +1153,7 @@ platform-gitops/
1153
1153
   applications/
1154
1154
   base/
1155
1155
   overlays/
1156
- ```text
1156
+ ```
1157
1157
 
1158
1158
  ### Deployment Workflows
1159
1159
 
@@ -1197,7 +1197,7 @@ istioctl install --set profile={{istio_profile}} \
1197
1197
  # Linkerd Installation
1198
1198
  linkerd install --cluster-name={{cluster_name}} | kubectl apply -f -
1199
1199
  linkerd viz install | kubectl apply -f -
1200
- ```text
1200
+ ```
1201
1201
 
1202
1202
  - Control plane setup
1203
1203
  - Proxy injection
@@ -1248,7 +1248,7 @@ spec:
1248
1248
  - name: deploy
1249
1249
  taskRef:
1250
1250
  name: gitops-deploy
1251
- ```text
1251
+ ```
1252
1252
 
1253
1253
  ### Development Tools
1254
1254
 
@@ -1290,7 +1290,7 @@ data:
1290
1290
  - job_name: 'kubernetes-pods'
1291
1291
  kubernetes_sd_configs:
1292
1292
  - role: pod
1293
- ```text
1293
+ ```
1294
1294
 
1295
1295
  ### Platform Observability
1296
1296
 
@@ -1380,7 +1380,7 @@ stages:
1380
1380
  - develop
1381
1381
  - test
1382
1382
  - deploy
1383
- ```text
1383
+ ```
1384
1384
 
1385
1385
  ## Platform Validation & Testing
1386
1386
 
@@ -1409,8 +1409,8 @@ stages:
1409
1409
 
1410
1410
  ### Load Testing
1411
1411
 
1412
- ```yaml
1413
- # K6 Load Test Example
1412
+ ```typescript
1413
+ // K6 Load Test Example
1414
1414
  import http from 'k6/http';
1415
1415
  import { check } from 'k6';
1416
1416
 
@@ -160,7 +160,7 @@ Created during agent setup:
160
160
  - Templates:
161
161
  - [ ] template-name-1.md
162
162
  - [ ] template-name-2.md
163
- ```text
163
+ ```
164
164
 
165
165
  ### 4. Create Agent File
166
166
 
@@ -218,7 +218,7 @@ Present to the user:
218
218
  1. Review and customize the created tasks/templates
219
219
  2. Run npm run build:agents
220
220
  3. Test the agent thoroughly
221
- ```text
221
+ ```
222
222
 
223
223
  ## Template Reference
224
224
 
@@ -247,7 +247,7 @@ persona:
247
247
  - Data integrity and accuracy above all
248
248
  - Clear communication of complex findings
249
249
  - Actionable insights over raw numbers
250
- ```text
250
+ ```
251
251
 
252
252
  ## Creating Missing Dependencies
253
253
 
@@ -280,12 +280,12 @@ When a required task or template doesn't exist:
280
280
  ```yaml
281
281
  dependencies:
282
282
  tasks:
283
- - 'create-doc # Required if agent creates any documents'
284
- - 'analyze-requirements # Custom task for this agent'
285
- - 'generate-report # Another custom task'
283
+ - create-doc
284
+ - analyze-requirements
285
+ - generate-report
286
286
  templates:
287
- - 'requirements-doc # Template for requirements documents'
288
- - 'analysis-report # Template for analysis reports'
287
+ - requirements-doc
288
+ - analysis-report
289
289
  ```
290
290
 
291
291
  ## Notes
@@ -973,7 +973,7 @@ Before declaring complete:
973
973
 
974
974
  **README Structure with Character Introduction:**
975
975
 
976
- ````markdown
976
+ ```markdown
977
977
  # {Pack Name} Expansion Pack
978
978
 
979
979
  ## Meet Your {Domain} Team
@@ -998,9 +998,7 @@ _{Professional background and expertise}_
998
998
 
999
999
  2. **Launch Orchestrator**:
1000
1000
 
1001
- ```bash
1002
1001
  npm run agent {pack-name}-orchestrator
1003
- ```
1004
1002
 
1005
1003
  3. **Follow Numbered Options**: {Character Name} will present numbered choices for each decision
1006
1004
 
@@ -1030,7 +1028,7 @@ _{Professional background and expertise}_
1030
1028
  ### Knowledge Base
1031
1029
 
1032
1030
  [Embedded domain expertise]
1033
- ````
1031
+ ```
1034
1032
 
1035
1033
  #### 6.3 Advanced Data File Documentation with Validation
1036
1034
 
@@ -1742,7 +1740,7 @@ Present these numbered options to the user:
1742
1740
 
1743
1741
  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:
1744
1742
 
1745
- ````yml
1743
+ ```yml
1746
1744
  activation-instructions:
1747
1745
  - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
1748
1746
  - Only read the files/tasks listed here when user selects them for execution to minimize context usage
@@ -1802,7 +1800,7 @@ dependencies:
1802
1800
  - [TEMPLATE_1] # Template with LLM instructions for guided creation
1803
1801
  - [TEMPLATE_2] # Another template for different document type
1804
1802
  [[LLM: Example: blueprint-tmpl, contract-tmpl, report-tmpl
1805
- Each template should include [[LLM: guidance]] and other conventions from `template-formmat.md` sections for user interaction]]
1803
+ Each template should include [[LLM: guidance]] and other conventions from `template-format.md` sections for user interaction]]
1806
1804
 
1807
1805
  checklists:
1808
1806
  - [CHECKLIST_1] # Quality validation for template outputs
@@ -1818,7 +1816,7 @@ dependencies:
1818
1816
  - template-format # Required if using templates
1819
1817
  - [UTIL_1] # Other utilities as needed
1820
1818
  [[LLM: Include workflow-management if agent participates in workflows]]
1821
- ```text
1819
+ ```
1822
1820
 
1823
1821
  @{example: Construction Contractor Agent}
1824
1822
 
@@ -1857,22 +1855,22 @@ commands:
1857
1855
  - '*exit" - Say goodbye as Marcus and exit'
1858
1856
  dependencies:
1859
1857
  tasks:
1860
- - 'create-doc # For document creation'
1861
- - 'validate-plans # Custom validation task'
1862
- - 'safety-assessment # Custom safety review task'
1858
+ - create-doc
1859
+ - validate-plans
1860
+ - safety-assessment
1863
1861
  templates:
1864
- - 'blueprint-tmpl # Architectural blueprint template'
1865
- - 'estimate-tmpl # Cost estimation template'
1866
- - 'schedule-tmpl # Project timeline template'
1862
+ - blueprint-tmpl
1863
+ - estimate-tmpl
1864
+ - schedule-tmpl
1867
1865
  checklists:
1868
- - 'blueprint-checklist # Validates blueprint completeness'
1869
- - 'safety-checklist # Safety compliance validation'
1866
+ - blueprint-checklist
1867
+ - safety-checklist
1870
1868
  data:
1871
- - 'building-codes.md # Local building code reference'
1872
- - 'materials-guide.md # Construction materials specs'
1869
+ - building-codes.md
1870
+ - materials-guide.md
1873
1871
  utils:
1874
- - 'template-format # For template processing'
1875
- ````
1872
+ - template-format
1873
+ ```
1876
1874
  ==================== END: templates#agent-tmpl ====================
1877
1875
 
1878
1876
  ==================== START: templates#expansion-pack-plan-tmpl ====================
@@ -313,6 +313,12 @@ agent:
313
313
  icon: 💻
314
314
  whenToUse: Use for code implementation, debugging, refactoring, and development best practices
315
315
  customization: null
316
+ startup:
317
+ - Announce: Greet the user with your name and role, and inform of the *help command.
318
+ - CRITICAL: Load .bmad-core/core-config.yml and read devLoadAlwaysFiles list and devDebugLog values
319
+ - CRITICAL: Load ONLY files specified in devLoadAlwaysFiles. If any missing, inform user but continue
320
+ - CRITICAL: Do NOT load any story files during startup unless user requested you do
321
+ - CRITICAL: Do NOT begin development until told to proceed
316
322
  persona:
317
323
  role: Expert Senior Software Engineer & Implementation Specialist
318
324
  style: Extremely concise, pragmatic, detail-oriented, solution-focused
@@ -320,30 +326,16 @@ persona:
320
326
  focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
321
327
  core_principles:
322
328
  - CRITICAL: Story-Centric - Story has ALL info. NEVER load PRD/architecture/other docs files unless explicitly directed in dev notes
323
- - CRITICAL: Config-Based Loading - MUST load .bmad-core/core-config.yml at startup, then load ONLY files listed in devLoadAlwaysFiles. Inform user of missing files but continue
324
- - CRITICAL: Dev Record Only - ONLY update Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
325
- - Sequential Execution - Complete tasks 1-by-1 in order. Mark [x] before next. No skipping
329
+ - CRITICAL: Dev Record Only - ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
330
+ - Strive for Sequential Task Execution - Complete tasks 1-by-1 and mark [x] as completed
326
331
  - Test-Driven Quality - Write tests alongside code. Task incomplete without passing tests
327
- - Debug Log Discipline - Log temp changes to table. Revert after fix. Keep story lean
332
+ - Debug Log Discipline - Log temp changes to md table in devDebugLog. Revert after fix.
328
333
  - Block Only When Critical - HALT for: missing approval/ambiguous reqs/3 failures/missing config
329
334
  - Code Excellence - Clean, secure, maintainable code per loaded standards
330
335
  - Numbered Options - Always use numbered lists when presenting choices
331
- startup:
332
- - Announce: Greet the user with your name and role, and inform of the *help command.
333
- - CRITICAL: Load .bmad-core/core-config.yml and read devLoadAlwaysFiles list
334
- - CRITICAL: Load ONLY files specified in devLoadAlwaysFiles. If any missing, inform user but continue
335
- - CRITICAL: Do NOT load any story files during startup unless user requested you do
336
- - CRITICAL: Do NOT scan docs/stories/ directory automatically
337
- - CRITICAL: Do NOT begin any tasks automatically
338
- - Wait for user to specify story or ask for story selection
339
- - Only load story files and begin work when explicitly requested by user
340
336
  commands:
341
337
  - help: Show numbered list of the following commands to allow selection
342
- - chat-mode: Conversational mode for development discussions
343
338
  - run-tests: Execute linting and tests
344
- - lint: Run linting only
345
- - dod-check: Run story-dod-checklist
346
- - status: Show task progress
347
339
  - debug-log: Show debug entries
348
340
  - complete-story: Finalize to "Review"
349
341
  - exit: Say goodbye as the Developer, and then abandon inhabiting this persona
@@ -1305,7 +1297,7 @@ Available workflows for [Team Name]:
1305
1297
  [... etc. ...]
1306
1298
 
1307
1299
  Use /workflow-start {number or id} to begin a workflow.
1308
- ```text
1300
+ ```
1309
1301
 
1310
1302
  ### /workflow-start {workflow-id}
1311
1303
 
@@ -1331,7 +1323,7 @@ In Progress:
1331
1323
  - Create PRD (John) - awaiting input
1332
1324
 
1333
1325
  Next: Technical Architecture
1334
- ```text
1326
+ ```
1335
1327
 
1336
1328
  ### /workflow-resume
1337
1329
 
@@ -1347,7 +1339,7 @@ BMad: I see you've completed Discovery and part of Product Planning.
1347
1339
  - UX Strategy with Sally (ux-expert)
1348
1340
 
1349
1341
  Would you like me to load Sally to continue?
1350
- ```text
1342
+ ```
1351
1343
 
1352
1344
  ### /workflow-next
1353
1345
 
@@ -1417,7 +1409,7 @@ BMad: I see you have a PRD and architecture document. Based on these artifacts,
1417
1409
  - Load Sarah (Product Owner) to validate all artifacts
1418
1410
 
1419
1411
  Would you like to continue with this workflow?
1420
- ```text
1412
+ ```
1421
1413
 
1422
1414
  ## Workflow Context Passing
1423
1415
 
@@ -1443,7 +1435,7 @@ Sally: I see we're in the Product Planning stage of the greenfield-fullstack wor
1443
1435
 
1444
1436
  Let's create the UX strategy and UI specifications. First, let me review
1445
1437
  the PRD to understand the features we're designing for...
1446
- ```text
1438
+ ```
1447
1439
 
1448
1440
  ## Multi-Path Workflows
1449
1441
 
@@ -3700,7 +3692,7 @@ servers:
3700
3692
  '[object Object]': null
3701
3693
  description:
3702
3694
  '[object Object]': null
3703
- ```text
3695
+ ```
3704
3696
 
3705
3697
  ^^/CONDITION: has_rest_api^^
3706
3698
 
@@ -3763,7 +3755,6 @@ After presenting the structure, apply `tasks#advanced-elicitation` protocol to r
3763
3755
  ├── {{package-manifest}} # Dependencies manifest
3764
3756
  ├── {{config-files}} # Language/framework configs
3765
3757
  └── README.md # Project documentation
3766
- ```text
3767
3758
 
3768
3759
  @{example: monorepo-structure}
3769
3760
  project-root/
@@ -3775,6 +3766,7 @@ project-root/
3775
3766
  ├── scripts/ # Monorepo management scripts
3776
3767
  └── package.json # Root package.json with workspaces
3777
3768
  @{/example}
3769
+ ```
3778
3770
 
3779
3771
  [[LLM: After presenting the source tree structure, apply `tasks#advanced-elicitation` protocol]]
3780
3772
 
@@ -5547,7 +5539,7 @@ Present component architecture and apply `tasks#advanced-elicitation` protocol]]
5547
5539
 
5548
5540
  ```mermaid
5549
5541
  {{component_interaction_diagram}}
5550
- ```text
5542
+ ```
5551
5543
 
5552
5544
  ## API Design and Integration
5553
5545
 
@@ -5587,7 +5579,7 @@ Present API design and apply `tasks#advanced-elicitation` protocol]]
5587
5579
 
5588
5580
  ```json
5589
5581
  {{response_schema}}
5590
- ```text
5582
+ ```
5591
5583
 
5592
5584
  <</REPEAT>>
5593
5585
 
@@ -6925,7 +6917,7 @@ Create an `index.md` file in the sharded folder that:
6925
6917
  - [Section Name 2](./section-name-2.md)
6926
6918
  - [Section Name 3](./section-name-3.md)
6927
6919
  ...
6928
- ```text
6920
+ ```
6929
6921
 
6930
6922
  ### 5. Preserve Special Content
6931
6923
 
@@ -9028,7 +9020,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
9028
9020
 
9029
9021
  ```mermaid
9030
9022
  {{sitemap_diagram}}
9031
- ```text
9023
+ ```
9032
9024
 
9033
9025
  @{example: sitemap}
9034
9026
 
@@ -1144,7 +1144,7 @@ Available workflows for [Team Name]:
1144
1144
  [... etc. ...]
1145
1145
 
1146
1146
  Use /workflow-start {number or id} to begin a workflow.
1147
- ```text
1147
+ ```
1148
1148
 
1149
1149
  ### /workflow-start {workflow-id}
1150
1150
 
@@ -1170,7 +1170,7 @@ In Progress:
1170
1170
  - Create PRD (John) - awaiting input
1171
1171
 
1172
1172
  Next: Technical Architecture
1173
- ```text
1173
+ ```
1174
1174
 
1175
1175
  ### /workflow-resume
1176
1176
 
@@ -1186,7 +1186,7 @@ BMad: I see you've completed Discovery and part of Product Planning.
1186
1186
  - UX Strategy with Sally (ux-expert)
1187
1187
 
1188
1188
  Would you like me to load Sally to continue?
1189
- ```text
1189
+ ```
1190
1190
 
1191
1191
  ### /workflow-next
1192
1192
 
@@ -1256,7 +1256,7 @@ BMad: I see you have a PRD and architecture document. Based on these artifacts,
1256
1256
  - Load Sarah (Product Owner) to validate all artifacts
1257
1257
 
1258
1258
  Would you like to continue with this workflow?
1259
- ```text
1259
+ ```
1260
1260
 
1261
1261
  ## Workflow Context Passing
1262
1262
 
@@ -1282,7 +1282,7 @@ Sally: I see we're in the Product Planning stage of the greenfield-fullstack wor
1282
1282
 
1283
1283
  Let's create the UX strategy and UI specifications. First, let me review
1284
1284
  the PRD to understand the features we're designing for...
1285
- ```text
1285
+ ```
1286
1286
 
1287
1287
  ## Multi-Path Workflows
1288
1288
 
@@ -3291,7 +3291,7 @@ Create an `index.md` file in the sharded folder that:
3291
3291
  - [Section Name 2](./section-name-2.md)
3292
3292
  - [Section Name 3](./section-name-3.md)
3293
3293
  ...
3294
- ```text
3294
+ ```
3295
3295
 
3296
3296
  ### 5. Preserve Special Content
3297
3297
 
@@ -4506,7 +4506,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4506
4506
 
4507
4507
  ```mermaid
4508
4508
  {{sitemap_diagram}}
4509
- ```text
4509
+ ```
4510
4510
 
4511
4511
  @{example: sitemap}
4512
4512
 
@@ -5593,7 +5593,7 @@ servers:
5593
5593
  '[object Object]': null
5594
5594
  description:
5595
5595
  '[object Object]': null
5596
- ```text
5596
+ ```
5597
5597
 
5598
5598
  ^^/CONDITION: has_rest_api^^
5599
5599
 
@@ -5656,7 +5656,6 @@ After presenting the structure, apply `tasks#advanced-elicitation` protocol to r
5656
5656
  ├── {{package-manifest}} # Dependencies manifest
5657
5657
  ├── {{config-files}} # Language/framework configs
5658
5658
  └── README.md # Project documentation
5659
- ```text
5660
5659
 
5661
5660
  @{example: monorepo-structure}
5662
5661
  project-root/
@@ -5668,6 +5667,7 @@ project-root/
5668
5667
  ├── scripts/ # Monorepo management scripts
5669
5668
  └── package.json # Root package.json with workspaces
5670
5669
  @{/example}
5670
+ ```
5671
5671
 
5672
5672
  [[LLM: After presenting the source tree structure, apply `tasks#advanced-elicitation` protocol]]
5673
5673
 
@@ -7440,7 +7440,7 @@ Present component architecture and apply `tasks#advanced-elicitation` protocol]]
7440
7440
 
7441
7441
  ```mermaid
7442
7442
  {{component_interaction_diagram}}
7443
- ```text
7443
+ ```
7444
7444
 
7445
7445
  ## API Design and Integration
7446
7446
 
@@ -7480,7 +7480,7 @@ Present API design and apply `tasks#advanced-elicitation` protocol]]
7480
7480
 
7481
7481
  ```json
7482
7482
  {{response_schema}}
7483
- ```text
7483
+ ```
7484
7484
 
7485
7485
  <</REPEAT>>
7486
7486
 
@@ -297,6 +297,12 @@ agent:
297
297
  icon: 💻
298
298
  whenToUse: Use for code implementation, debugging, refactoring, and development best practices
299
299
  customization: null
300
+ startup:
301
+ - Announce: Greet the user with your name and role, and inform of the *help command.
302
+ - CRITICAL: Load .bmad-core/core-config.yml and read devLoadAlwaysFiles list and devDebugLog values
303
+ - CRITICAL: Load ONLY files specified in devLoadAlwaysFiles. If any missing, inform user but continue
304
+ - CRITICAL: Do NOT load any story files during startup unless user requested you do
305
+ - CRITICAL: Do NOT begin development until told to proceed
300
306
  persona:
301
307
  role: Expert Senior Software Engineer & Implementation Specialist
302
308
  style: Extremely concise, pragmatic, detail-oriented, solution-focused
@@ -304,30 +310,16 @@ persona:
304
310
  focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
305
311
  core_principles:
306
312
  - CRITICAL: Story-Centric - Story has ALL info. NEVER load PRD/architecture/other docs files unless explicitly directed in dev notes
307
- - CRITICAL: Config-Based Loading - MUST load .bmad-core/core-config.yml at startup, then load ONLY files listed in devLoadAlwaysFiles. Inform user of missing files but continue
308
- - CRITICAL: Dev Record Only - ONLY update Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
309
- - Sequential Execution - Complete tasks 1-by-1 in order. Mark [x] before next. No skipping
313
+ - CRITICAL: Dev Record Only - ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
314
+ - Strive for Sequential Task Execution - Complete tasks 1-by-1 and mark [x] as completed
310
315
  - Test-Driven Quality - Write tests alongside code. Task incomplete without passing tests
311
- - Debug Log Discipline - Log temp changes to table. Revert after fix. Keep story lean
316
+ - Debug Log Discipline - Log temp changes to md table in devDebugLog. Revert after fix.
312
317
  - Block Only When Critical - HALT for: missing approval/ambiguous reqs/3 failures/missing config
313
318
  - Code Excellence - Clean, secure, maintainable code per loaded standards
314
319
  - Numbered Options - Always use numbered lists when presenting choices
315
- startup:
316
- - Announce: Greet the user with your name and role, and inform of the *help command.
317
- - CRITICAL: Load .bmad-core/core-config.yml and read devLoadAlwaysFiles list
318
- - CRITICAL: Load ONLY files specified in devLoadAlwaysFiles. If any missing, inform user but continue
319
- - CRITICAL: Do NOT load any story files during startup unless user requested you do
320
- - CRITICAL: Do NOT scan docs/stories/ directory automatically
321
- - CRITICAL: Do NOT begin any tasks automatically
322
- - Wait for user to specify story or ask for story selection
323
- - Only load story files and begin work when explicitly requested by user
324
320
  commands:
325
321
  - help: Show numbered list of the following commands to allow selection
326
- - chat-mode: Conversational mode for development discussions
327
322
  - run-tests: Execute linting and tests
328
- - lint: Run linting only
329
- - dod-check: Run story-dod-checklist
330
- - status: Show task progress
331
323
  - debug-log: Show debug entries
332
324
  - complete-story: Finalize to "Review"
333
325
  - exit: Say goodbye as the Developer, and then abandon inhabiting this persona
@@ -1051,7 +1043,7 @@ Available workflows for [Team Name]:
1051
1043
  [... etc. ...]
1052
1044
 
1053
1045
  Use /workflow-start {number or id} to begin a workflow.
1054
- ```text
1046
+ ```
1055
1047
 
1056
1048
  ### /workflow-start {workflow-id}
1057
1049
 
@@ -1077,7 +1069,7 @@ In Progress:
1077
1069
  - Create PRD (John) - awaiting input
1078
1070
 
1079
1071
  Next: Technical Architecture
1080
- ```text
1072
+ ```
1081
1073
 
1082
1074
  ### /workflow-resume
1083
1075
 
@@ -1093,7 +1085,7 @@ BMad: I see you've completed Discovery and part of Product Planning.
1093
1085
  - UX Strategy with Sally (ux-expert)
1094
1086
 
1095
1087
  Would you like me to load Sally to continue?
1096
- ```text
1088
+ ```
1097
1089
 
1098
1090
  ### /workflow-next
1099
1091
 
@@ -1163,7 +1155,7 @@ BMad: I see you have a PRD and architecture document. Based on these artifacts,
1163
1155
  - Load Sarah (Product Owner) to validate all artifacts
1164
1156
 
1165
1157
  Would you like to continue with this workflow?
1166
- ```text
1158
+ ```
1167
1159
 
1168
1160
  ## Workflow Context Passing
1169
1161
 
@@ -1189,7 +1181,7 @@ Sally: I see we're in the Product Planning stage of the greenfield-fullstack wor
1189
1181
 
1190
1182
  Let's create the UX strategy and UI specifications. First, let me review
1191
1183
  the PRD to understand the features we're designing for...
1192
- ```text
1184
+ ```
1193
1185
 
1194
1186
  ## Multi-Path Workflows
1195
1187
 
@@ -1471,7 +1463,7 @@ Create an `index.md` file in the sharded folder that:
1471
1463
  - [Section Name 2](./section-name-2.md)
1472
1464
  - [Section Name 3](./section-name-3.md)
1473
1465
  ...
1474
- ```text
1466
+ ```
1475
1467
 
1476
1468
  ### 5. Preserve Special Content
1477
1469
 
@@ -1076,7 +1076,7 @@ Available workflows for [Team Name]:
1076
1076
  [... etc. ...]
1077
1077
 
1078
1078
  Use /workflow-start {number or id} to begin a workflow.
1079
- ```text
1079
+ ```
1080
1080
 
1081
1081
  ### /workflow-start {workflow-id}
1082
1082
 
@@ -1102,7 +1102,7 @@ In Progress:
1102
1102
  - Create PRD (John) - awaiting input
1103
1103
 
1104
1104
  Next: Technical Architecture
1105
- ```text
1105
+ ```
1106
1106
 
1107
1107
  ### /workflow-resume
1108
1108
 
@@ -1118,7 +1118,7 @@ BMad: I see you've completed Discovery and part of Product Planning.
1118
1118
  - UX Strategy with Sally (ux-expert)
1119
1119
 
1120
1120
  Would you like me to load Sally to continue?
1121
- ```text
1121
+ ```
1122
1122
 
1123
1123
  ### /workflow-next
1124
1124
 
@@ -1188,7 +1188,7 @@ BMad: I see you have a PRD and architecture document. Based on these artifacts,
1188
1188
  - Load Sarah (Product Owner) to validate all artifacts
1189
1189
 
1190
1190
  Would you like to continue with this workflow?
1191
- ```text
1191
+ ```
1192
1192
 
1193
1193
  ## Workflow Context Passing
1194
1194
 
@@ -1214,7 +1214,7 @@ Sally: I see we're in the Product Planning stage of the greenfield-fullstack wor
1214
1214
 
1215
1215
  Let's create the UX strategy and UI specifications. First, let me review
1216
1216
  the PRD to understand the features we're designing for...
1217
- ```text
1217
+ ```
1218
1218
 
1219
1219
  ## Multi-Path Workflows
1220
1220
 
@@ -3223,7 +3223,7 @@ Create an `index.md` file in the sharded folder that:
3223
3223
  - [Section Name 2](./section-name-2.md)
3224
3224
  - [Section Name 3](./section-name-3.md)
3225
3225
  ...
3226
- ```text
3226
+ ```
3227
3227
 
3228
3228
  ### 5. Preserve Special Content
3229
3229
 
@@ -5055,7 +5055,7 @@ servers:
5055
5055
  '[object Object]': null
5056
5056
  description:
5057
5057
  '[object Object]': null
5058
- ```text
5058
+ ```
5059
5059
 
5060
5060
  ^^/CONDITION: has_rest_api^^
5061
5061
 
@@ -5118,7 +5118,6 @@ After presenting the structure, apply `tasks#advanced-elicitation` protocol to r
5118
5118
  ├── {{package-manifest}} # Dependencies manifest
5119
5119
  ├── {{config-files}} # Language/framework configs
5120
5120
  └── README.md # Project documentation
5121
- ```text
5122
5121
 
5123
5122
  @{example: monorepo-structure}
5124
5123
  project-root/
@@ -5130,6 +5129,7 @@ project-root/
5130
5129
  ├── scripts/ # Monorepo management scripts
5131
5130
  └── package.json # Root package.json with workspaces
5132
5131
  @{/example}
5132
+ ```
5133
5133
 
5134
5134
  [[LLM: After presenting the source tree structure, apply `tasks#advanced-elicitation` protocol]]
5135
5135
 
@@ -6902,7 +6902,7 @@ Present component architecture and apply `tasks#advanced-elicitation` protocol]]
6902
6902
 
6903
6903
  ```mermaid
6904
6904
  {{component_interaction_diagram}}
6905
- ```text
6905
+ ```
6906
6906
 
6907
6907
  ## API Design and Integration
6908
6908
 
@@ -6942,7 +6942,7 @@ Present API design and apply `tasks#advanced-elicitation` protocol]]
6942
6942
 
6943
6943
  ```json
6944
6944
  {{response_schema}}
6945
- ```text
6945
+ ```
6946
6946
 
6947
6947
  <</REPEAT>>
6948
6948