bmad-method 4.37.0-beta.6 → 5.0.0-beta.1

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 (85) hide show
  1. package/.github/workflows/promote-to-stable.yml +144 -0
  2. package/CHANGELOG.md +27 -2
  3. package/bmad-core/agents/analyst.md +1 -1
  4. package/bmad-core/agents/architect.md +2 -3
  5. package/bmad-core/agents/bmad-master.md +0 -1
  6. package/bmad-core/agents/bmad-orchestrator.md +9 -10
  7. package/bmad-core/agents/dev.md +9 -10
  8. package/bmad-core/agents/po.md +1 -1
  9. package/bmad-core/agents/qa.md +38 -19
  10. package/bmad-core/agents/sm.md +1 -1
  11. package/bmad-core/agents/ux-expert.md +1 -1
  12. package/bmad-core/checklists/architect-checklist.md +0 -5
  13. package/bmad-core/checklists/pm-checklist.md +0 -5
  14. package/bmad-core/checklists/po-master-checklist.md +0 -9
  15. package/bmad-core/checklists/story-dod-checklist.md +0 -7
  16. package/bmad-core/checklists/story-draft-checklist.md +0 -3
  17. package/bmad-core/data/bmad-kb.md +5 -2
  18. package/bmad-core/data/elicitation-methods.md +20 -0
  19. package/bmad-core/data/test-levels-framework.md +146 -0
  20. package/bmad-core/data/test-priorities-matrix.md +172 -0
  21. package/bmad-core/tasks/create-brownfield-story.md +11 -3
  22. package/bmad-core/tasks/create-deep-research-prompt.md +0 -11
  23. package/bmad-core/tasks/document-project.md +15 -13
  24. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  25. package/bmad-core/tasks/index-docs.md +0 -6
  26. package/bmad-core/tasks/kb-mode-interaction.md +3 -3
  27. package/bmad-core/tasks/nfr-assess.md +343 -0
  28. package/bmad-core/tasks/qa-gate.md +159 -0
  29. package/bmad-core/tasks/review-story.md +243 -74
  30. package/bmad-core/tasks/risk-profile.md +353 -0
  31. package/bmad-core/tasks/shard-doc.md +0 -2
  32. package/bmad-core/tasks/test-design.md +174 -0
  33. package/bmad-core/tasks/trace-requirements.md +264 -0
  34. package/bmad-core/templates/qa-gate-tmpl.yaml +102 -0
  35. package/common/tasks/execute-checklist.md +0 -7
  36. package/dist/agents/analyst.txt +20 -26
  37. package/dist/agents/architect.txt +14 -35
  38. package/dist/agents/bmad-master.txt +40 -70
  39. package/dist/agents/bmad-orchestrator.txt +28 -5
  40. package/dist/agents/dev.txt +0 -14
  41. package/dist/agents/pm.txt +0 -25
  42. package/dist/agents/po.txt +0 -18
  43. package/dist/agents/qa.txt +2079 -135
  44. package/dist/agents/sm.txt +0 -10
  45. package/dist/agents/ux-expert.txt +0 -7
  46. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -37
  47. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +3 -12
  48. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -7
  49. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +44 -90
  50. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +14 -49
  51. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -46
  52. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -15
  53. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -17
  54. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +38 -142
  55. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -2
  56. package/dist/teams/team-all.txt +2181 -261
  57. package/dist/teams/team-fullstack.txt +43 -57
  58. package/dist/teams/team-ide-minimal.txt +2064 -125
  59. package/dist/teams/team-no-ui.txt +43 -57
  60. package/docs/enhanced-ide-development-workflow.md +220 -15
  61. package/docs/user-guide.md +271 -18
  62. package/docs/working-in-the-brownfield.md +265 -32
  63. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +14 -14
  64. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +0 -4
  65. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +3 -5
  66. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +0 -1
  67. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +0 -18
  68. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +0 -5
  69. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +0 -8
  70. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +0 -7
  71. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +0 -4
  72. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +0 -1
  73. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +0 -10
  74. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +0 -18
  75. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +0 -3
  76. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +0 -1
  77. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +0 -1
  78. package/package.json +1 -1
  79. package/tools/installer/bin/bmad.js +33 -32
  80. package/tools/installer/config/install.config.yaml +11 -1
  81. package/tools/installer/lib/file-manager.js +1 -1
  82. package/tools/installer/lib/ide-base-setup.js +1 -1
  83. package/tools/installer/lib/ide-setup.js +197 -83
  84. package/tools/installer/lib/installer.js +3 -3
  85. package/tools/installer/package.json +1 -1
@@ -230,63 +230,54 @@ CRITICAL: First, help the user select the most appropriate research focus based
230
230
  Present these numbered options to the user:
231
231
 
232
232
  1. **Product Validation Research**
233
-
234
233
  - Validate product hypotheses and market fit
235
234
  - Test assumptions about user needs and solutions
236
235
  - Assess technical and business feasibility
237
236
  - Identify risks and mitigation strategies
238
237
 
239
238
  2. **Market Opportunity Research**
240
-
241
239
  - Analyze market size and growth potential
242
240
  - Identify market segments and dynamics
243
241
  - Assess market entry strategies
244
242
  - Evaluate timing and market readiness
245
243
 
246
244
  3. **User & Customer Research**
247
-
248
245
  - Deep dive into user personas and behaviors
249
246
  - Understand jobs-to-be-done and pain points
250
247
  - Map customer journeys and touchpoints
251
248
  - Analyze willingness to pay and value perception
252
249
 
253
250
  4. **Competitive Intelligence Research**
254
-
255
251
  - Detailed competitor analysis and positioning
256
252
  - Feature and capability comparisons
257
253
  - Business model and strategy analysis
258
254
  - Identify competitive advantages and gaps
259
255
 
260
256
  5. **Technology & Innovation Research**
261
-
262
257
  - Assess technology trends and possibilities
263
258
  - Evaluate technical approaches and architectures
264
259
  - Identify emerging technologies and disruptions
265
260
  - Analyze build vs. buy vs. partner options
266
261
 
267
262
  6. **Industry & Ecosystem Research**
268
-
269
263
  - Map industry value chains and dynamics
270
264
  - Identify key players and relationships
271
265
  - Analyze regulatory and compliance factors
272
266
  - Understand partnership opportunities
273
267
 
274
268
  7. **Strategic Options Research**
275
-
276
269
  - Evaluate different strategic directions
277
270
  - Assess business model alternatives
278
271
  - Analyze go-to-market strategies
279
272
  - Consider expansion and scaling paths
280
273
 
281
274
  8. **Risk & Feasibility Research**
282
-
283
275
  - Identify and assess various risk factors
284
276
  - Evaluate implementation challenges
285
277
  - Analyze resource requirements
286
278
  - Consider regulatory and legal implications
287
279
 
288
280
  9. **Custom Research Focus**
289
-
290
281
  - User-defined research objectives
291
282
  - Specialized domain investigation
292
283
  - Cross-functional research needs
@@ -455,13 +446,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
455
446
  ### 5. Review and Refinement
456
447
 
457
448
  1. **Present Complete Prompt**
458
-
459
449
  - Show the full research prompt
460
450
  - Explain key elements and rationale
461
451
  - Highlight any assumptions made
462
452
 
463
453
  2. **Gather Feedback**
464
-
465
454
  - Are the objectives clear and correct?
466
455
  - Do the questions address all concerns?
467
456
  - Is the scope appropriate?
@@ -592,13 +581,11 @@ CRITICAL: Use proper parsing that understands markdown context. A ## inside a co
592
581
  For each extracted section:
593
582
 
594
583
  1. **Generate filename**: Convert the section heading to lowercase-dash-case
595
-
596
584
  - Remove special characters
597
585
  - Replace spaces with dashes
598
586
  - Example: "## Tech Stack" → `tech-stack.md`
599
587
 
600
588
  2. **Adjust heading levels**:
601
-
602
589
  - The level 2 heading becomes level 1 (# instead of ##) in the sharded new document
603
590
  - All subsection levels decrease by 1:
604
591
 
@@ -802,9 +789,9 @@ This document captures the CURRENT STATE of the [Project Name] codebase, includi
802
789
 
803
790
  ### Change Log
804
791
 
805
- | Date | Version | Description | Author |
806
- |------|---------|-------------|--------|
807
- | [Date] | 1.0 | Initial brownfield analysis | [Analyst] |
792
+ | Date | Version | Description | Author |
793
+ | ------ | ------- | --------------------------- | --------- |
794
+ | [Date] | 1.0 | Initial brownfield analysis | [Analyst] |
808
795
 
809
796
  ## Quick Reference - Key Files and Entry Points
810
797
 
@@ -827,11 +814,11 @@ This document captures the CURRENT STATE of the [Project Name] codebase, includi
827
814
 
828
815
  ### Actual Tech Stack (from package.json/requirements.txt)
829
816
 
830
- | Category | Technology | Version | Notes |
831
- |----------|------------|---------|--------|
832
- | Runtime | Node.js | 16.x | [Any constraints] |
833
- | Framework | Express | 4.18.2 | [Custom middleware?] |
834
- | Database | PostgreSQL | 13 | [Connection pooling setup] |
817
+ | Category | Technology | Version | Notes |
818
+ | --------- | ---------- | ------- | -------------------------- |
819
+ | Runtime | Node.js | 16.x | [Any constraints] |
820
+ | Framework | Express | 4.18.2 | [Custom middleware?] |
821
+ | Database | PostgreSQL | 13 | [Connection pooling setup] |
835
822
 
836
823
  etc...
837
824
 
@@ -870,6 +857,7 @@ project-root/
870
857
  ### Data Models
871
858
 
872
859
  Instead of duplicating, reference actual model files:
860
+
873
861
  - **User Model**: See `src/models/User.js`
874
862
  - **Order Model**: See `src/models/Order.js`
875
863
  - **Related Types**: TypeScript definitions in `src/types/`
@@ -899,10 +887,10 @@ Instead of duplicating, reference actual model files:
899
887
 
900
888
  ### External Services
901
889
 
902
- | Service | Purpose | Integration Type | Key Files |
903
- |---------|---------|------------------|-----------|
904
- | Stripe | Payments | REST API | `src/integrations/stripe/` |
905
- | SendGrid | Emails | SDK | `src/services/emailService.js` |
890
+ | Service | Purpose | Integration Type | Key Files |
891
+ | -------- | -------- | ---------------- | ------------------------------ |
892
+ | Stripe | Payments | REST API | `src/integrations/stripe/` |
893
+ | SendGrid | Emails | SDK | `src/services/emailService.js` |
906
894
 
907
895
  etc...
908
896
 
@@ -947,6 +935,7 @@ npm run test:integration # Runs integration tests (requires local DB)
947
935
  ### Files That Will Need Modification
948
936
 
949
937
  Based on the enhancement requirements, these files will be affected:
938
+
950
939
  - `src/services/userService.js` - Add new user fields
951
940
  - `src/models/User.js` - Update schema
952
941
  - `src/routes/userRoutes.js` - New endpoints
@@ -1044,7 +1033,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
1044
1033
  ## Instructions
1045
1034
 
1046
1035
  1. **Initial Assessment**
1047
-
1048
1036
  - If user or the task being run provides a checklist name:
1049
1037
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
1050
1038
  - If multiple matches found, ask user to clarify
@@ -1057,14 +1045,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
1057
1045
  - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
1058
1046
 
1059
1047
  2. **Document and Artifact Gathering**
1060
-
1061
1048
  - Each checklist will specify its required documents/artifacts at the beginning
1062
1049
  - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
1063
1050
 
1064
1051
  3. **Checklist Processing**
1065
1052
 
1066
1053
  If in interactive mode:
1067
-
1068
1054
  - Work through each section of the checklist one at a time
1069
1055
  - For each section:
1070
1056
  - Review all items in the section following instructions for that section embedded in the checklist
@@ -1073,7 +1059,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
1073
1059
  - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
1074
1060
 
1075
1061
  If in YOLO mode:
1076
-
1077
1062
  - Process all sections at once
1078
1063
  - Create a comprehensive report of all findings
1079
1064
  - Present the complete analysis to the user
@@ -1081,7 +1066,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
1081
1066
  4. **Validation Approach**
1082
1067
 
1083
1068
  For each checklist item:
1084
-
1085
1069
  - Read and understand the requirement
1086
1070
  - Look for evidence in the documentation that satisfies the requirement
1087
1071
  - Consider both explicit mentions and implicit coverage
@@ -1095,7 +1079,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
1095
1079
  5. **Section Analysis**
1096
1080
 
1097
1081
  For each section:
1098
-
1099
1082
  - think step by step to calculate pass rate
1100
1083
  - Identify common themes in failed items
1101
1084
  - Provide specific recommendations for improvement
@@ -1105,7 +1088,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
1105
1088
  6. **Final Report**
1106
1089
 
1107
1090
  Prepare a summary that includes:
1108
-
1109
1091
  - Overall checklist completion status
1110
1092
  - Pass rates by section
1111
1093
  - List of failed items with context
@@ -1149,7 +1131,6 @@ The LLM will:
1149
1131
  2. If the section contains game flow diagrams, level layouts, or system diagrams, explain each diagram briefly with game development context before offering elicitation options (e.g., "The gameplay loop diagram shows how player actions lead to rewards and progression. Notice how each step maintains player engagement and creates opportunities for skill development.")
1150
1132
 
1151
1133
  3. If the section contains multiple game elements (like multiple mechanics, multiple levels, multiple systems, etc.), inform the user they can apply elicitation actions to:
1152
-
1153
1134
  - The entire section as a whole
1154
1135
  - Individual game elements within the section (specify which element when selecting an action)
1155
1136
 
@@ -2633,34 +2614,29 @@ Ask the user if they want to work through the checklist:
2633
2614
  Generate a comprehensive validation report that includes:
2634
2615
 
2635
2616
  1. Executive Summary
2636
-
2637
2617
  - Overall game architecture readiness (High/Medium/Low)
2638
2618
  - Critical risks for game development
2639
2619
  - Key strengths of the game architecture
2640
2620
  - Unity-specific assessment
2641
2621
 
2642
2622
  2. Game Systems Analysis
2643
-
2644
2623
  - Pass rate for each major system section
2645
2624
  - Most concerning gaps in game architecture
2646
2625
  - Systems requiring immediate attention
2647
2626
  - Unity integration completeness
2648
2627
 
2649
2628
  3. Performance Risk Assessment
2650
-
2651
2629
  - Top 5 performance risks for the game
2652
2630
  - Mobile platform specific concerns
2653
2631
  - Frame rate stability risks
2654
2632
  - Memory usage concerns
2655
2633
 
2656
2634
  4. Implementation Recommendations
2657
-
2658
2635
  - Must-fix items before development
2659
2636
  - Unity-specific improvements needed
2660
2637
  - Game development workflow enhancements
2661
2638
 
2662
2639
  5. AI Agent Implementation Readiness
2663
-
2664
2640
  - Game-specific concerns for AI implementation
2665
2641
  - Unity component complexity assessment
2666
2642
  - Areas needing additional clarification
@@ -3208,25 +3184,21 @@ Assets/
3208
3184
  ### Story Implementation Process
3209
3185
 
3210
3186
  1. **Read Story Requirements:**
3211
-
3212
3187
  - Understand acceptance criteria
3213
3188
  - Identify technical requirements
3214
3189
  - Review performance constraints
3215
3190
 
3216
3191
  2. **Plan Implementation:**
3217
-
3218
3192
  - Identify files to create/modify
3219
3193
  - Consider Unity's component-based architecture
3220
3194
  - Plan testing approach
3221
3195
 
3222
3196
  3. **Implement Feature:**
3223
-
3224
3197
  - Write clean C# code following all guidelines
3225
3198
  - Use established patterns
3226
3199
  - Maintain stable FPS performance
3227
3200
 
3228
3201
  4. **Test Implementation:**
3229
-
3230
3202
  - Write edit mode tests for game logic
3231
3203
  - Write play mode tests for integration testing
3232
3204
  - Test cross-platform functionality
@@ -3540,7 +3512,6 @@ that can handle [specific game requirements] with stable performance."
3540
3512
  **Prerequisites**: Game planning documents must exist in `docs/` folder of Unity project
3541
3513
 
3542
3514
  1. **Document Sharding** (CRITICAL STEP for Game Development):
3543
-
3544
3515
  - Documents created by Game Designer/Architect (in Web or IDE) MUST be sharded for development
3545
3516
  - Use core BMad agents or tools to shard:
3546
3517
  a) **Manual**: Use core BMad `shard-doc` task if available
@@ -3563,20 +3534,17 @@ Resulting Unity Project Folder Structure:
3563
3534
  3. **Game Development Cycle** (Sequential, one game story at a time):
3564
3535
 
3565
3536
  **CRITICAL CONTEXT MANAGEMENT for Unity Development**:
3566
-
3567
3537
  - **Context windows matter!** Always use fresh, clean context windows
3568
3538
  - **Model selection matters!** Use most powerful thinking model for Game SM story creation
3569
3539
  - **ALWAYS start new chat between Game SM, Game Dev, and QA work**
3570
3540
 
3571
3541
  **Step 1 - Game Story Creation**:
3572
-
3573
3542
  - **NEW CLEAN CHAT** → Select powerful model → `/bmad2du/game-sm` → `*draft`
3574
3543
  - Game SM executes create-game-story task using `game-story-tmpl`
3575
3544
  - Review generated story in `docs/game-stories/`
3576
3545
  - Update status from "Draft" to "Approved"
3577
3546
 
3578
3547
  **Step 2 - Unity Game Story Implementation**:
3579
-
3580
3548
  - **NEW CLEAN CHAT** → `/bmad2du/game-developer`
3581
3549
  - Agent asks which game story to implement
3582
3550
  - Include story file content to save game dev agent lookup time
@@ -3585,7 +3553,6 @@ Resulting Unity Project Folder Structure:
3585
3553
  - Game Dev marks story as "Review" when complete with all Unity tests passing
3586
3554
 
3587
3555
  **Step 3 - Game QA Review**:
3588
-
3589
3556
  - **NEW CLEAN CHAT** → Use core `@qa` agent → execute review-story task
3590
3557
  - QA performs senior Unity developer code review
3591
3558
  - QA can refactor and improve Unity code directly
@@ -3625,14 +3592,12 @@ Since this expansion pack doesn't include specific brownfield templates, you'll
3625
3592
 
3626
3593
  1. **Upload Unity project to Web UI** (GitHub URL, files, or zip)
3627
3594
  2. **Create adapted Game Design Document**: `/bmad2du/game-designer` - Modify `game-design-doc-tmpl` to include:
3628
-
3629
3595
  - Analysis of existing game systems
3630
3596
  - Integration points for new features
3631
3597
  - Compatibility requirements
3632
3598
  - Risk assessment for changes
3633
3599
 
3634
3600
  3. **Game Architecture Planning**:
3635
-
3636
3601
  - Use `/bmad2du/game-architect` with `game-architecture-tmpl`
3637
3602
  - Focus on how new features integrate with existing Unity systems
3638
3603
  - Plan for gradual rollout and testing
@@ -215,7 +215,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
215
215
  ## Instructions
216
216
 
217
217
  1. **Initial Assessment**
218
-
219
218
  - If user or the task being run provides a checklist name:
220
219
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
221
220
  - If multiple matches found, ask user to clarify
@@ -228,14 +227,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
228
227
  - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
229
228
 
230
229
  2. **Document and Artifact Gathering**
231
-
232
230
  - Each checklist will specify its required documents/artifacts at the beginning
233
231
  - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
234
232
 
235
233
  3. **Checklist Processing**
236
234
 
237
235
  If in interactive mode:
238
-
239
236
  - Work through each section of the checklist one at a time
240
237
  - For each section:
241
238
  - Review all items in the section following instructions for that section embedded in the checklist
@@ -244,7 +241,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
244
241
  - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
245
242
 
246
243
  If in YOLO mode:
247
-
248
244
  - Process all sections at once
249
245
  - Create a comprehensive report of all findings
250
246
  - Present the complete analysis to the user
@@ -252,7 +248,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
252
248
  4. **Validation Approach**
253
249
 
254
250
  For each checklist item:
255
-
256
251
  - Read and understand the requirement
257
252
  - Look for evidence in the documentation that satisfies the requirement
258
253
  - Consider both explicit mentions and implicit coverage
@@ -266,7 +261,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
266
261
  5. **Section Analysis**
267
262
 
268
263
  For each section:
269
-
270
264
  - think step by step to calculate pass rate
271
265
  - Identify common themes in failed items
272
266
  - Provide specific recommendations for improvement
@@ -276,7 +270,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
276
270
  6. **Final Report**
277
271
 
278
272
  Prepare a summary that includes:
279
-
280
273
  - Overall checklist completion status
281
274
  - Pass rates by section
282
275
  - List of failed items with context
@@ -393,13 +386,11 @@ CRITICAL: Use proper parsing that understands markdown context. A ## inside a co
393
386
  For each extracted section:
394
387
 
395
388
  1. **Generate filename**: Convert the section heading to lowercase-dash-case
396
-
397
389
  - Remove special characters
398
390
  - Replace spaces with dashes
399
391
  - Example: "## Tech Stack" → `tech-stack.md`
400
392
 
401
393
  2. **Adjust heading levels**:
402
-
403
394
  - The level 2 heading becomes level 1 (# instead of ##) in the sharded new document
404
395
  - All subsection levels decrease by 1:
405
396
 
@@ -501,7 +492,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
501
492
  [[LLM: Begin by understanding the game design context and goals. Ask clarifying questions if needed to determine the best approach for game-specific ideation.]]
502
493
 
503
494
  1. **Establish Game Context**
504
-
505
495
  - Understand the game genre or opportunity area
506
496
  - Identify target audience and platform constraints
507
497
  - Determine session goals (concept exploration vs. mechanic refinement)
@@ -519,7 +509,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
519
509
 
520
510
  1. **"What If" Game Scenarios**
521
511
  [[LLM: Generate provocative what-if questions that challenge game design assumptions and expand thinking beyond current genre limitations.]]
522
-
523
512
  - What if players could rewind time in any genre?
524
513
  - What if the game world reacted to the player's real-world location?
525
514
  - What if failure was more rewarding than success?
@@ -528,7 +517,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
528
517
 
529
518
  2. **Cross-Genre Fusion**
530
519
  [[LLM: Help user combine unexpected game genres and mechanics to create unique experiences.]]
531
-
532
520
  - "How might [genre A] mechanics work in [genre B]?"
533
521
  - Puzzle mechanics in action games
534
522
  - Dating sim elements in strategy games
@@ -537,7 +525,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
537
525
 
538
526
  3. **Player Motivation Reversal**
539
527
  [[LLM: Flip traditional player motivations to reveal new gameplay possibilities.]]
540
-
541
528
  - What if losing was the goal?
542
529
  - What if cooperation was forced in competitive games?
543
530
  - What if players had to help their enemies?
@@ -554,7 +541,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
554
541
 
555
542
  1. **SCAMPER for Game Mechanics**
556
543
  [[LLM: Guide through each SCAMPER prompt specifically for game design.]]
557
-
558
544
  - **S** = Substitute: What mechanics can be substituted? (walking → flying → swimming)
559
545
  - **C** = Combine: What systems can be merged? (inventory + character growth)
560
546
  - **A** = Adapt: What mechanics from other media? (books, movies, sports)
@@ -565,7 +551,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
565
551
 
566
552
  2. **Player Agency Spectrum**
567
553
  [[LLM: Explore different levels of player control and agency across game systems.]]
568
-
569
554
  - Full Control: Direct character movement, combat, building
570
555
  - Indirect Control: Setting rules, giving commands, environmental changes
571
556
  - Influence Only: Suggestions, preferences, emotional reactions
@@ -573,7 +558,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
573
558
 
574
559
  3. **Temporal Game Design**
575
560
  [[LLM: Explore how time affects gameplay and player experience.]]
576
-
577
561
  - Real-time vs. turn-based mechanics
578
562
  - Time travel and manipulation
579
563
  - Persistent vs. session-based progress
@@ -584,7 +568,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
584
568
 
585
569
  1. **Emotion-First Design**
586
570
  [[LLM: Start with target emotions and work backward to mechanics that create them.]]
587
-
588
571
  - Target Emotion: Wonder → Mechanics: Discovery, mystery, scale
589
572
  - Target Emotion: Triumph → Mechanics: Challenge, skill growth, recognition
590
573
  - Target Emotion: Connection → Mechanics: Cooperation, shared goals, communication
@@ -592,7 +575,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
592
575
 
593
576
  2. **Player Archetype Brainstorming**
594
577
  [[LLM: Design for different player types and motivations.]]
595
-
596
578
  - Achievers: Progression, completion, mastery
597
579
  - Explorers: Discovery, secrets, world-building
598
580
  - Socializers: Interaction, cooperation, community
@@ -601,7 +583,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
601
583
 
602
584
  3. **Accessibility-First Innovation**
603
585
  [[LLM: Generate ideas that make games more accessible while creating new gameplay.]]
604
-
605
586
  - Visual impairment considerations leading to audio-focused mechanics
606
587
  - Motor accessibility inspiring one-handed or simplified controls
607
588
  - Cognitive accessibility driving clear feedback and pacing
@@ -611,7 +592,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
611
592
 
612
593
  1. **Environmental Storytelling**
613
594
  [[LLM: Brainstorm ways the game world itself tells stories without explicit narrative.]]
614
-
615
595
  - How does the environment show history?
616
596
  - What do interactive objects reveal about characters?
617
597
  - How can level design communicate mood?
@@ -619,7 +599,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
619
599
 
620
600
  2. **Player-Generated Narrative**
621
601
  [[LLM: Explore ways players create their own stories through gameplay.]]
622
-
623
602
  - Emergent storytelling through player choices
624
603
  - Procedural narrative generation
625
604
  - Player-to-player story sharing
@@ -627,7 +606,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
627
606
 
628
607
  3. **Genre Expectation Subversion**
629
608
  [[LLM: Identify and deliberately subvert player expectations within genres.]]
630
-
631
609
  - Fantasy RPG where magic is mundane
632
610
  - Horror game where monsters are friendly
633
611
  - Racing game where going slow is optimal
@@ -637,7 +615,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
637
615
 
638
616
  1. **Platform-Specific Design**
639
617
  [[LLM: Generate ideas that leverage unique platform capabilities.]]
640
-
641
618
  - Mobile: GPS, accelerometer, camera, always-connected
642
619
  - Web: URLs, tabs, social sharing, real-time collaboration
643
620
  - Console: Controllers, TV viewing, couch co-op
@@ -645,7 +622,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
645
622
 
646
623
  2. **Constraint-Based Creativity**
647
624
  [[LLM: Use technical or design constraints as creative catalysts.]]
648
-
649
625
  - One-button games
650
626
  - Games without graphics
651
627
  - Games that play in notification bars
@@ -691,19 +667,16 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
691
667
  [[LLM: Guide the brainstorming session with appropriate pacing for game design exploration.]]
692
668
 
693
669
  1. **Inspiration Phase** (10-15 min)
694
-
695
670
  - Reference existing games and mechanics
696
671
  - Explore player experiences and emotions
697
672
  - Gather visual and thematic inspiration
698
673
 
699
674
  2. **Divergent Exploration** (25-35 min)
700
-
701
675
  - Generate many game concepts or mechanics
702
676
  - Use expansion and fusion techniques
703
677
  - Encourage wild and impossible ideas
704
678
 
705
679
  3. **Player-Centered Filtering** (15-20 min)
706
-
707
680
  - Consider target audience reactions
708
681
  - Evaluate emotional impact and engagement
709
682
  - Group ideas by player experience goals
@@ -824,63 +797,54 @@ CRITICAL: First, help the user select the most appropriate research focus based
824
797
  Present these numbered options to the user:
825
798
 
826
799
  1. **Product Validation Research**
827
-
828
800
  - Validate product hypotheses and market fit
829
801
  - Test assumptions about user needs and solutions
830
802
  - Assess technical and business feasibility
831
803
  - Identify risks and mitigation strategies
832
804
 
833
805
  2. **Market Opportunity Research**
834
-
835
806
  - Analyze market size and growth potential
836
807
  - Identify market segments and dynamics
837
808
  - Assess market entry strategies
838
809
  - Evaluate timing and market readiness
839
810
 
840
811
  3. **User & Customer Research**
841
-
842
812
  - Deep dive into user personas and behaviors
843
813
  - Understand jobs-to-be-done and pain points
844
814
  - Map customer journeys and touchpoints
845
815
  - Analyze willingness to pay and value perception
846
816
 
847
817
  4. **Competitive Intelligence Research**
848
-
849
818
  - Detailed competitor analysis and positioning
850
819
  - Feature and capability comparisons
851
820
  - Business model and strategy analysis
852
821
  - Identify competitive advantages and gaps
853
822
 
854
823
  5. **Technology & Innovation Research**
855
-
856
824
  - Assess technology trends and possibilities
857
825
  - Evaluate technical approaches and architectures
858
826
  - Identify emerging technologies and disruptions
859
827
  - Analyze build vs. buy vs. partner options
860
828
 
861
829
  6. **Industry & Ecosystem Research**
862
-
863
830
  - Map industry value chains and dynamics
864
831
  - Identify key players and relationships
865
832
  - Analyze regulatory and compliance factors
866
833
  - Understand partnership opportunities
867
834
 
868
835
  7. **Strategic Options Research**
869
-
870
836
  - Evaluate different strategic directions
871
837
  - Assess business model alternatives
872
838
  - Analyze go-to-market strategies
873
839
  - Consider expansion and scaling paths
874
840
 
875
841
  8. **Risk & Feasibility Research**
876
-
877
842
  - Identify and assess various risk factors
878
843
  - Evaluate implementation challenges
879
844
  - Analyze resource requirements
880
845
  - Consider regulatory and legal implications
881
846
 
882
847
  9. **Custom Research Focus**
883
-
884
848
  - User-defined research objectives
885
849
  - Specialized domain investigation
886
850
  - Cross-functional research needs
@@ -1049,13 +1013,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
1049
1013
  ### 5. Review and Refinement
1050
1014
 
1051
1015
  1. **Present Complete Prompt**
1052
-
1053
1016
  - Show the full research prompt
1054
1017
  - Explain key elements and rationale
1055
1018
  - Highlight any assumptions made
1056
1019
 
1057
1020
  2. **Gather Feedback**
1058
-
1059
1021
  - Are the objectives clear and correct?
1060
1022
  - Do the questions address all concerns?
1061
1023
  - Is the scope appropriate?
@@ -1113,7 +1075,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
1113
1075
  2. If the section contains game flow diagrams, level layouts, or system diagrams, explain each diagram briefly with game development context before offering elicitation options (e.g., "The gameplay loop diagram shows how player actions lead to rewards and progression. Notice how each step maintains player engagement and creates opportunities for skill development.")
1114
1076
 
1115
1077
  3. If the section contains multiple game elements (like multiple mechanics, multiple levels, multiple systems, etc.), inform the user they can apply elicitation actions to:
1116
-
1117
1078
  - The entire section as a whole
1118
1079
  - Individual game elements within the section (specify which element when selecting an action)
1119
1080
 
@@ -3237,7 +3198,6 @@ that can handle [specific game requirements] with stable performance."
3237
3198
  **Prerequisites**: Game planning documents must exist in `docs/` folder of Unity project
3238
3199
 
3239
3200
  1. **Document Sharding** (CRITICAL STEP for Game Development):
3240
-
3241
3201
  - Documents created by Game Designer/Architect (in Web or IDE) MUST be sharded for development
3242
3202
  - Use core BMad agents or tools to shard:
3243
3203
  a) **Manual**: Use core BMad `shard-doc` task if available
@@ -3260,20 +3220,17 @@ Resulting Unity Project Folder Structure:
3260
3220
  3. **Game Development Cycle** (Sequential, one game story at a time):
3261
3221
 
3262
3222
  **CRITICAL CONTEXT MANAGEMENT for Unity Development**:
3263
-
3264
3223
  - **Context windows matter!** Always use fresh, clean context windows
3265
3224
  - **Model selection matters!** Use most powerful thinking model for Game SM story creation
3266
3225
  - **ALWAYS start new chat between Game SM, Game Dev, and QA work**
3267
3226
 
3268
3227
  **Step 1 - Game Story Creation**:
3269
-
3270
3228
  - **NEW CLEAN CHAT** → Select powerful model → `/bmad2du/game-sm` → `*draft`
3271
3229
  - Game SM executes create-game-story task using `game-story-tmpl`
3272
3230
  - Review generated story in `docs/game-stories/`
3273
3231
  - Update status from "Draft" to "Approved"
3274
3232
 
3275
3233
  **Step 2 - Unity Game Story Implementation**:
3276
-
3277
3234
  - **NEW CLEAN CHAT** → `/bmad2du/game-developer`
3278
3235
  - Agent asks which game story to implement
3279
3236
  - Include story file content to save game dev agent lookup time
@@ -3282,7 +3239,6 @@ Resulting Unity Project Folder Structure:
3282
3239
  - Game Dev marks story as "Review" when complete with all Unity tests passing
3283
3240
 
3284
3241
  **Step 3 - Game QA Review**:
3285
-
3286
3242
  - **NEW CLEAN CHAT** → Use core `@qa` agent → execute review-story task
3287
3243
  - QA performs senior Unity developer code review
3288
3244
  - QA can refactor and improve Unity code directly
@@ -3322,14 +3278,12 @@ Since this expansion pack doesn't include specific brownfield templates, you'll
3322
3278
 
3323
3279
  1. **Upload Unity project to Web UI** (GitHub URL, files, or zip)
3324
3280
  2. **Create adapted Game Design Document**: `/bmad2du/game-designer` - Modify `game-design-doc-tmpl` to include:
3325
-
3326
3281
  - Analysis of existing game systems
3327
3282
  - Integration points for new features
3328
3283
  - Compatibility requirements
3329
3284
  - Risk assessment for changes
3330
3285
 
3331
3286
  3. **Game Architecture Planning**:
3332
-
3333
3287
  - Use `/bmad2du/game-architect` with `game-architecture-tmpl`
3334
3288
  - Focus on how new features integrate with existing Unity systems
3335
3289
  - Plan for gradual rollout and testing