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.
- package/.github/workflows/promote-to-stable.yml +144 -0
- package/CHANGELOG.md +27 -2
- package/bmad-core/agents/analyst.md +1 -1
- package/bmad-core/agents/architect.md +2 -3
- package/bmad-core/agents/bmad-master.md +0 -1
- package/bmad-core/agents/bmad-orchestrator.md +9 -10
- package/bmad-core/agents/dev.md +9 -10
- package/bmad-core/agents/po.md +1 -1
- package/bmad-core/agents/qa.md +38 -19
- package/bmad-core/agents/sm.md +1 -1
- package/bmad-core/agents/ux-expert.md +1 -1
- package/bmad-core/checklists/architect-checklist.md +0 -5
- package/bmad-core/checklists/pm-checklist.md +0 -5
- package/bmad-core/checklists/po-master-checklist.md +0 -9
- package/bmad-core/checklists/story-dod-checklist.md +0 -7
- package/bmad-core/checklists/story-draft-checklist.md +0 -3
- package/bmad-core/data/bmad-kb.md +5 -2
- package/bmad-core/data/elicitation-methods.md +20 -0
- package/bmad-core/data/test-levels-framework.md +146 -0
- package/bmad-core/data/test-priorities-matrix.md +172 -0
- package/bmad-core/tasks/create-brownfield-story.md +11 -3
- package/bmad-core/tasks/create-deep-research-prompt.md +0 -11
- package/bmad-core/tasks/document-project.md +15 -13
- package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
- package/bmad-core/tasks/index-docs.md +0 -6
- package/bmad-core/tasks/kb-mode-interaction.md +3 -3
- package/bmad-core/tasks/nfr-assess.md +343 -0
- package/bmad-core/tasks/qa-gate.md +159 -0
- package/bmad-core/tasks/review-story.md +243 -74
- package/bmad-core/tasks/risk-profile.md +353 -0
- package/bmad-core/tasks/shard-doc.md +0 -2
- package/bmad-core/tasks/test-design.md +174 -0
- package/bmad-core/tasks/trace-requirements.md +264 -0
- package/bmad-core/templates/qa-gate-tmpl.yaml +102 -0
- package/common/tasks/execute-checklist.md +0 -7
- package/dist/agents/analyst.txt +20 -26
- package/dist/agents/architect.txt +14 -35
- package/dist/agents/bmad-master.txt +40 -70
- package/dist/agents/bmad-orchestrator.txt +28 -5
- package/dist/agents/dev.txt +0 -14
- package/dist/agents/pm.txt +0 -25
- package/dist/agents/po.txt +0 -18
- package/dist/agents/qa.txt +2079 -135
- package/dist/agents/sm.txt +0 -10
- package/dist/agents/ux-expert.txt +0 -7
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -37
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +3 -12
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -7
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +44 -90
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +14 -49
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -46
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -15
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -17
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +38 -142
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -2
- package/dist/teams/team-all.txt +2181 -261
- package/dist/teams/team-fullstack.txt +43 -57
- package/dist/teams/team-ide-minimal.txt +2064 -125
- package/dist/teams/team-no-ui.txt +43 -57
- package/docs/enhanced-ide-development-workflow.md +220 -15
- package/docs/user-guide.md +271 -18
- package/docs/working-in-the-brownfield.md +265 -32
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +14 -14
- package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +0 -4
- package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +3 -5
- package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +0 -1
- package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +0 -18
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +0 -5
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +0 -8
- package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +0 -7
- package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +0 -4
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +0 -1
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +0 -10
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +0 -18
- package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +0 -3
- package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +0 -1
- package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +0 -1
- package/package.json +1 -1
- package/tools/installer/bin/bmad.js +33 -32
- package/tools/installer/config/install.config.yaml +11 -1
- package/tools/installer/lib/file-manager.js +1 -1
- package/tools/installer/lib/ide-base-setup.js +1 -1
- package/tools/installer/lib/ide-setup.js +197 -83
- package/tools/installer/lib/installer.js +3 -3
- 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
|
|
806
|
-
|
|
807
|
-
| [Date] | 1.0
|
|
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
|
|
831
|
-
|
|
832
|
-
| Runtime
|
|
833
|
-
| Framework | Express
|
|
834
|
-
| Database
|
|
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
|
|
903
|
-
|
|
904
|
-
| Stripe
|
|
905
|
-
| SendGrid | Emails
|
|
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
|