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
@@ -27,7 +27,7 @@ If you have just completed an MVP with BMad, and you want to continue with post-
27
27
  ## The Complete Brownfield Workflow
28
28
 
29
29
  1. **Follow the [<ins>User Guide - Installation</ins>](user-guide.md#installation) steps to setup your agent in the web.**
30
- 2. **Generate a 'flattened' single file of your entire codebase** run: ```npx bmad-method flatten```
30
+ 2. **Generate a 'flattened' single file of your entire codebase** run: `npx bmad-method flatten`
31
31
 
32
32
  ### Choose Your Approach
33
33
 
@@ -76,7 +76,7 @@ The PM will:
76
76
  *document-project
77
77
  ```
78
78
 
79
- The analyst will:
79
+ The architect will:
80
80
 
81
81
  - **Ask about your focus** if no PRD was provided
82
82
  - **Offer options**: Create PRD, provide requirements, or describe the enhancement
@@ -85,11 +85,11 @@ The analyst will:
85
85
  - **Skip unrelated areas** to keep docs lean
86
86
  - **Generate ONE architecture document** for all environments
87
87
 
88
- The analyst creates:
88
+ The architect creates:
89
89
 
90
90
  - **One comprehensive architecture document** following fullstack-architecture template
91
91
  - **Covers all system aspects** in a single file
92
- - **Easy to copy and save** as `docs/project-architecture.md`
92
+ - **Easy to copy and save** as `docs/architecture.md`
93
93
  - **Can be sharded later** in IDE if desired
94
94
 
95
95
  For example, if you say "Add payment processing to user service":
@@ -108,10 +108,10 @@ For example, if you say "Add payment processing to user service":
108
108
  2. **Upload your project**:
109
109
  - **Option A**: Paste your GitHub repository URL directly
110
110
  - **Option B**: Upload your flattened-codebase.xml file
111
- 3. **Load the analyst agent**: Upload `dist/agents/architect.txt`
111
+ 3. **Load the architect agent**: Upload `dist/agents/architect.txt`
112
112
  4. **Run documentation**: Type `*document-project`
113
113
 
114
- The analyst will generate comprehensive documentation of everything.
114
+ The architect will generate comprehensive documentation of everything.
115
115
 
116
116
  #### Phase 2: Plan Your Enhancement
117
117
 
@@ -206,19 +206,20 @@ The PO ensures:
206
206
  ### Phase 4: Save and Shard Documents
207
207
 
208
208
  1. Save your PRD and Architecture as:
209
- docs/brownfield-prd.md
210
- docs/brownfield-architecture.md
209
+ docs/prd.md
210
+ docs/architecture.md
211
+ (Note: You can optionally prefix with 'brownfield-' if managing multiple versions)
211
212
  2. Shard your docs:
212
213
  In your IDE
213
214
 
214
215
  ```bash
215
216
  @po
216
- shard docs/brownfield-prd.md
217
+ shard docs/prd.md
217
218
  ```
218
219
 
219
220
  ```bash
220
221
  @po
221
- shard docs/brownfield-architecture.md
222
+ shard docs/architecture.md
222
223
  ```
223
224
 
224
225
  ### Phase 5: Transition to Development
@@ -255,12 +256,172 @@ Brownfield changes should:
255
256
 
256
257
  ### 4. Test Integration Thoroughly
257
258
 
258
- Focus testing on:
259
+ #### Why the Test Architect is Critical for Brownfield
260
+
261
+ In brownfield projects, the Test Architect (Quinn) becomes your safety net against breaking existing functionality. Unlike greenfield where you're building fresh, brownfield requires careful validation that new changes don't destabilize what already works.
262
+
263
+ #### Brownfield-Specific Testing Challenges
264
+
265
+ The Test Architect addresses unique brownfield complexities:
266
+
267
+ | **Challenge** | **How Test Architect Helps** | **Command** |
268
+ | --------------------------- | ------------------------------------------------- | ------------------- |
269
+ | **Regression Risks** | Identifies which existing features might break | `*risk` |
270
+ | **Legacy Dependencies** | Maps integration points and hidden dependencies | `*trace` |
271
+ | **Performance Degradation** | Validates no slowdown in existing flows | `*nfr` |
272
+ | **Coverage Gaps** | Finds untested legacy code that new changes touch | `*design` |
273
+ | **Breaking Changes** | Detects API/contract violations | `*review` |
274
+ | **Migration Safety** | Validates data transformations and rollback plans | `*risk` + `*review` |
275
+
276
+ #### Complete Test Architect Workflow for Brownfield
277
+
278
+ ##### Stage 1: Before Development (Risk & Strategy)
259
279
 
260
- - Integration points
261
- - Existing functionality (regression)
262
- - Performance impact
263
- - Data migrations
280
+ **CRITICAL FOR BROWNFIELD - Run These First:**
281
+
282
+ ```bash
283
+ # 1. RISK ASSESSMENT (Run IMMEDIATELY after story creation)
284
+ @qa *risk {brownfield-story}
285
+ # Identifies: Legacy dependencies, breaking changes, integration points
286
+ # Output: docs/qa/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
287
+ # Brownfield Focus:
288
+ # - Regression probability scoring
289
+ # - Affected downstream systems
290
+ # - Data migration risks
291
+ # - Rollback complexity
292
+
293
+ # 2. TEST DESIGN (After risk assessment)
294
+ @qa *design {brownfield-story}
295
+ # Creates: Regression test strategy + new feature tests
296
+ # Output: docs/qa/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md
297
+ # Brownfield Focus:
298
+ # - Existing functionality that needs regression tests
299
+ # - Integration test requirements
300
+ # - Performance benchmarks to maintain
301
+ # - Feature flag test scenarios
302
+ ```
303
+
304
+ ##### Stage 2: During Development (Continuous Validation)
305
+
306
+ **Monitor Integration Health While Coding:**
307
+
308
+ ```bash
309
+ # 3. REQUIREMENTS TRACING (Mid-development checkpoint)
310
+ @qa *trace {brownfield-story}
311
+ # Maps: New requirements + existing functionality preservation
312
+ # Output: docs/qa/assessments/{epic}.{story}-trace-{YYYYMMDD}.md
313
+ # Brownfield Focus:
314
+ # - Existing features that must still work
315
+ # - New/old feature interactions
316
+ # - API contract preservation
317
+ # - Missing regression test coverage
318
+
319
+ # 4. NFR VALIDATION (Before considering "done")
320
+ @qa *nfr {brownfield-story}
321
+ # Validates: Performance, security, reliability unchanged
322
+ # Output: docs/qa/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
323
+ # Brownfield Focus:
324
+ # - Performance regression detection
325
+ # - Security implications of integrations
326
+ # - Backward compatibility validation
327
+ # - Load/stress on legacy components
328
+ ```
329
+
330
+ ##### Stage 3: Code Review (Deep Integration Analysis)
331
+
332
+ **Comprehensive Brownfield Review:**
333
+
334
+ ```bash
335
+ # 5. FULL REVIEW (When development complete)
336
+ @qa *review {brownfield-story}
337
+ # Performs: Deep analysis + active refactoring
338
+ # Outputs:
339
+ # - QA Results in story file
340
+ # - Gate file: docs/qa/gates/{epic}.{story}-{slug}.yml
341
+ ```
342
+
343
+ The review specifically analyzes:
344
+
345
+ - **API Breaking Changes**: Validates all existing contracts maintained
346
+ - **Data Migration Safety**: Checks transformation logic and rollback procedures
347
+ - **Performance Regression**: Compares against baseline metrics
348
+ - **Integration Points**: Validates all touchpoints with legacy code
349
+ - **Feature Flag Logic**: Ensures proper toggle behavior
350
+ - **Dependency Impacts**: Maps affected downstream systems
351
+
352
+ ##### Stage 4: Post-Review (Gate Updates)
353
+
354
+ ```bash
355
+ # 6. GATE STATUS UPDATE (After addressing issues)
356
+ @qa *gate {brownfield-story}
357
+ # Updates: Quality gate decision after fixes
358
+ # Output: docs/qa/gates/{epic}.{story}-{slug}.yml
359
+ # Brownfield Considerations:
360
+ # - May WAIVE certain legacy code issues
361
+ # - Documents technical debt acceptance
362
+ # - Tracks migration progress
363
+ ```
364
+
365
+ #### Brownfield-Specific Risk Scoring
366
+
367
+ The Test Architect uses enhanced risk scoring for brownfield:
368
+
369
+ | **Risk Category** | **Brownfield Factors** | **Impact on Gate** |
370
+ | ---------------------- | ------------------------------------------ | ------------------- |
371
+ | **Regression Risk** | Number of integration points × Age of code | Score ≥9 = FAIL |
372
+ | **Data Risk** | Migration complexity × Data volume | Score ≥6 = CONCERNS |
373
+ | **Performance Risk** | Current load × Added complexity | Score ≥6 = CONCERNS |
374
+ | **Compatibility Risk** | API consumers × Contract changes | Score ≥9 = FAIL |
375
+
376
+ #### Brownfield Testing Standards
377
+
378
+ Quinn enforces additional standards for brownfield:
379
+
380
+ - **Regression Test Coverage**: Every touched legacy module needs tests
381
+ - **Performance Baselines**: Must maintain or improve current metrics
382
+ - **Rollback Procedures**: Every change needs a rollback plan
383
+ - **Feature Flags**: All risky changes behind toggles
384
+ - **Integration Tests**: Cover all legacy touchpoints
385
+ - **Contract Tests**: Validate API compatibility
386
+ - **Data Validation**: Migration correctness checks
387
+
388
+ #### Quick Reference: Brownfield Test Commands
389
+
390
+ | **Scenario** | **Commands to Run** | **Order** | **Why Critical** |
391
+ | --------------------------------- | ---------------------------------------------------- | ---------- | ----------------------------- |
392
+ | **Adding Feature to Legacy Code** | `*risk` → `*design` → `*trace` → `*review` | Sequential | Map all dependencies first |
393
+ | **API Modification** | `*risk` → `*design` → `*nfr` → `*review` | Sequential | Prevent breaking consumers |
394
+ | **Performance-Critical Change** | `*nfr` early and often → `*review` | Continuous | Catch degradation immediately |
395
+ | **Data Migration** | `*risk` → `*design` → `*trace` → `*review` → `*gate` | Full cycle | Ensure data integrity |
396
+ | **Bug Fix in Complex System** | `*risk` → `*trace` → `*review` | Focused | Prevent side effects |
397
+
398
+ #### Integration with Brownfield Scenarios
399
+
400
+ **Scenario-Specific Guidance:**
401
+
402
+ 1. **Legacy Code Modernization**
403
+ - Start with `*risk` to map all dependencies
404
+ - Use `*design` to plan strangler fig approach
405
+ - Run `*trace` frequently to ensure nothing breaks
406
+ - `*review` with focus on gradual migration
407
+
408
+ 2. **Adding Features to Monolith**
409
+ - `*risk` identifies integration complexity
410
+ - `*design` plans isolation strategies
411
+ - `*nfr` monitors performance impact
412
+ - `*review` validates no monolith degradation
413
+
414
+ 3. **Microservice Extraction**
415
+ - `*risk` maps service boundaries
416
+ - `*trace` ensures functionality preservation
417
+ - `*nfr` validates network overhead acceptable
418
+ - `*gate` documents accepted trade-offs
419
+
420
+ 4. **Database Schema Changes**
421
+ - `*risk` assesses migration complexity
422
+ - `*design` plans backward-compatible approach
423
+ - `*trace` maps all affected queries
424
+ - `*review` validates migration safety
264
425
 
265
426
  ### 5. Communicate Changes
266
427
 
@@ -277,29 +438,63 @@ Document:
277
438
 
278
439
  1. Document existing system
279
440
  2. Create brownfield PRD focusing on integration
280
- 3. Architecture emphasizes compatibility
281
- 4. Stories include integration tasks
441
+ 3. **Test Architect Early Involvement**:
442
+ - Run `@qa *risk` on draft stories to identify integration risks
443
+ - Use `@qa *design` to plan regression test strategy
444
+ 4. Architecture emphasizes compatibility
445
+ 5. Stories include integration tasks with test requirements
446
+ 6. **During Development**:
447
+ - Developer runs `@qa *trace` to verify coverage
448
+ - Use `@qa *nfr` to monitor performance impact
449
+ 7. **Review Stage**: `@qa *review` validates integration safety
282
450
 
283
451
  ### Scenario 2: Modernizing Legacy Code
284
452
 
285
453
  1. Extensive documentation phase
286
454
  2. PRD includes migration strategy
287
- 3. Architecture plans gradual transition
288
- 4. Stories follow strangler fig pattern
455
+ 3. **Test Architect Strategy Planning**:
456
+ - `@qa *risk` assesses modernization complexity
457
+ - `@qa *design` plans parallel testing approach
458
+ 4. Architecture plans gradual transition (strangler fig pattern)
459
+ 5. Stories follow incremental modernization with:
460
+ - Regression tests for untouched legacy code
461
+ - Integration tests for new/old boundaries
462
+ - Performance benchmarks at each stage
463
+ 6. **Continuous Validation**: Run `@qa *trace` after each increment
464
+ 7. **Gate Management**: Use `@qa *gate` to track technical debt acceptance
289
465
 
290
466
  ### Scenario 3: Bug Fix in Complex System
291
467
 
292
468
  1. Document relevant subsystems
293
469
  2. Use `create-brownfield-story` for focused fix
294
- 3. Include regression test requirements
295
- 4. QA validates no side effects
470
+ 3. **Test Architect Risk Assessment**: Run `@qa *risk` to identify side effect potential
471
+ 4. Include regression test requirements from `@qa *design` output
472
+ 5. **During Fix**: Use `@qa *trace` to map affected functionality
473
+ 6. **Before Commit**: Run `@qa *review` for comprehensive validation
474
+ 7. Test Architect validates no side effects using:
475
+ - Risk profiling for side effect analysis (probability × impact scoring)
476
+ - Trace matrix to ensure fix doesn't break related features
477
+ - NFR assessment to verify performance/security unchanged
478
+ - Gate decision documents fix safety
296
479
 
297
480
  ### Scenario 4: API Integration
298
481
 
299
482
  1. Document existing API patterns
300
483
  2. PRD defines integration requirements
301
- 3. Architecture ensures consistent patterns
302
- 4. Stories include API documentation updates
484
+ 3. **Test Architect Contract Analysis**:
485
+ - `@qa *risk` identifies breaking change potential
486
+ - `@qa *design` creates contract test strategy
487
+ 4. Architecture ensures consistent patterns
488
+ 5. **API Testing Focus**:
489
+ - Contract tests for backward compatibility
490
+ - Integration tests for new endpoints
491
+ - Performance tests for added load
492
+ 6. Stories include API documentation updates
493
+ 7. **Validation Checkpoints**:
494
+ - `@qa *trace` maps all API consumers
495
+ - `@qa *nfr` validates response times
496
+ - `@qa *review` ensures no breaking changes
497
+ 8. **Gate Decision**: Document any accepted breaking changes with migration path
303
498
 
304
499
  ## Troubleshooting
305
500
 
@@ -325,19 +520,37 @@ Document:
325
520
 
326
521
  ```bash
327
522
  # Document existing project
328
- @architect *document-project
523
+ @architect *document-project
329
524
 
330
525
  # Create enhancement PRD
331
- @pm *create-brownfield-prd
526
+ @pm *create-brownfield-prd
332
527
 
333
528
  # Create architecture with integration focus
334
- @architect *create-brownfield-architecture
529
+ @architect *create-brownfield-architecture
335
530
 
336
531
  # Quick epic creation
337
- @pm *create-brownfield-epic
532
+ @pm *create-brownfield-epic
338
533
 
339
534
  # Single story creation
340
- @pm *create-brownfield-story
535
+ @pm *create-brownfield-story
536
+ ```
537
+
538
+ ### Test Architect Commands for Brownfield
539
+
540
+ Note: Short forms shown below. Full commands: `*risk-profile`, `*test-design`, `*nfr-assess`, `*trace-requirements`
541
+
542
+ ```bash
543
+ # BEFORE DEVELOPMENT (Planning)
544
+ @qa *risk {story} # Assess regression & integration risks
545
+ @qa *design {story} # Plan regression + new feature tests
546
+
547
+ # DURING DEVELOPMENT (Validation)
548
+ @qa *trace {story} # Verify coverage of old + new
549
+ @qa *nfr {story} # Check performance degradation
550
+
551
+ # AFTER DEVELOPMENT (Review)
552
+ @qa *review {story} # Deep integration analysis
553
+ @qa *gate {story} # Update quality decision
341
554
  ```
342
555
 
343
556
  ### Decision Tree
@@ -352,13 +565,33 @@ Do you have a large codebase or monorepo?
352
565
 
353
566
  Is this a major enhancement affecting multiple systems?
354
567
  ├─ Yes → Full Brownfield Workflow
568
+ │ └─ ALWAYS run Test Architect *risk + *design first
355
569
  └─ No → Is this more than a simple bug fix?
356
- ├─ Yes → brownfield-create-epic
357
- └─ No brownfield-create-story
570
+ ├─ Yes → *create-brownfield-epic
571
+ └─ Run Test Architect *risk for integration points
572
+ └─ No → *create-brownfield-story
573
+ └─ Still run *risk if touching critical paths
574
+
575
+ Does the change touch legacy code?
576
+ ├─ Yes → Test Architect is MANDATORY
577
+ │ ├─ *risk → Identify regression potential
578
+ │ ├─ *design → Plan test coverage
579
+ │ └─ *review → Validate no breakage
580
+ └─ No → Test Architect is RECOMMENDED
581
+ └─ *review → Ensure quality standards
358
582
  ```
359
583
 
360
584
  ## Conclusion
361
585
 
362
- Brownfield development with BMad-Method provides structure and safety when modifying existing systems. The key is providing comprehensive context through documentation, using specialized templates that consider integration requirements, and following workflows that respect existing constraints while enabling progress.
586
+ Brownfield development with BMad Method provides structure and safety when modifying existing systems. The Test Architect becomes your critical safety net, using risk assessment, regression testing, and continuous validation to ensure new changes don't destabilize existing functionality.
587
+
588
+ **The Brownfield Success Formula:**
589
+
590
+ 1. **Document First** - Understand what exists
591
+ 2. **Assess Risk Early** - Use Test Architect `*risk` before coding
592
+ 3. **Plan Test Strategy** - Design regression + new feature tests
593
+ 4. **Validate Continuously** - Check integration health during development
594
+ 5. **Review Comprehensively** - Deep analysis before committing
595
+ 6. **Gate Decisively** - Document quality decisions
363
596
 
364
- Remember: **Document First, Plan Carefully, Integrate Safely**
597
+ Remember: **In brownfield, the Test Architect isn't optional - it's your insurance policy against breaking production.**
@@ -8,21 +8,21 @@ This expansion pack provides a complete, deployable starter kit for building and
8
8
 
9
9
  ## Features
10
10
 
11
- * **Automated GCP Setup**: `gcloud` scripts to configure your project, service accounts, and required APIs in minutes.
12
- * **Production-Ready Deployment**: Includes a `Dockerfile` and `cloudbuild.yaml` for easy, repeatable deployments to Google Cloud Run.
13
- * **Rich Template Library**: A comprehensive set of BMad-compatible templates for Teams, Agents, Tasks, Workflows, Documents, and Checklists.
14
- * **Pre-configured Agent Roles**: Includes powerful master templates for key agent archetypes like Orchestrators and Specialists.
15
- * **Highly Customizable**: Easily adapt the entire system with company-specific variables and industry-specific configurations.
16
- * **Powered by Google ADK**: Built on the official Google Agent Development Kit for robust and native integration with Vertex AI services.
11
+ - **Automated GCP Setup**: `gcloud` scripts to configure your project, service accounts, and required APIs in minutes.
12
+ - **Production-Ready Deployment**: Includes a `Dockerfile` and `cloudbuild.yaml` for easy, repeatable deployments to Google Cloud Run.
13
+ - **Rich Template Library**: A comprehensive set of BMad-compatible templates for Teams, Agents, Tasks, Workflows, Documents, and Checklists.
14
+ - **Pre-configured Agent Roles**: Includes powerful master templates for key agent archetypes like Orchestrators and Specialists.
15
+ - **Highly Customizable**: Easily adapt the entire system with company-specific variables and industry-specific configurations.
16
+ - **Powered by Google ADK**: Built on the official Google Agent Development Kit for robust and native integration with Vertex AI services.
17
17
 
18
18
  ## Prerequisites
19
19
 
20
20
  Before you begin, ensure you have the following installed and configured:
21
21
 
22
- * A Google Cloud Platform (GCP) Account with an active billing account.
23
- * The [Google Cloud SDK (`gcloud` CLI)](https://www.google.com/search?q=%5Bhttps://cloud.google.com/sdk/docs/install%5D\(https://cloud.google.com/sdk/docs/install\)) installed and authenticated.
24
- * [Docker](https://www.docker.com/products/docker-desktop/) installed on your local machine.
25
- * Python 3.11+
22
+ - A Google Cloud Platform (GCP) Account with an active billing account.
23
+ - The [Google Cloud SDK (`gcloud` CLI)](<https://www.google.com/search?q=%5Bhttps://cloud.google.com/sdk/docs/install%5D(https://cloud.google.com/sdk/docs/install)>) installed and authenticated.
24
+ - [Docker](https://www.docker.com/products/docker-desktop/) installed on your local machine.
25
+ - Python 3.11+
26
26
 
27
27
  ## Quick Start Guide
28
28
 
@@ -32,9 +32,9 @@ Follow these steps to get your own AI agent system running on Google Cloud.
32
32
 
33
33
  The setup scripts use placeholder variables. Before running them, open the files in the `/scripts` directory and replace the following placeholders with your own values:
34
34
 
35
- * `{{PROJECT_ID}}`: Your unique Google Cloud project ID.
36
- * `{{COMPANY_NAME}}`: Your company or project name (used for naming resources).
37
- * `{{LOCATION}}`: The GCP region you want to deploy to (e.g., `us-central1`).
35
+ - `{{PROJECT_ID}}`: Your unique Google Cloud project ID.
36
+ - `{{COMPANY_NAME}}`: Your company or project name (used for naming resources).
37
+ - `{{LOCATION}}`: The GCP region you want to deploy to (e.g., `us-central1`).
38
38
 
39
39
  ### 2\. Run the GCP Setup Scripts
40
40
 
@@ -106,4 +106,4 @@ This expansion pack has a comprehensive structure to get you started:
106
106
 
107
107
  ## Contributing
108
108
 
109
- Contributions are welcome\! Please follow the main project's `CONTRIBUTING.md` guidelines. For major changes or new features for this expansion pack, please open an issue or discussion first.
109
+ Contributions are welcome\! Please follow the main project's `CONTRIBUTING.md` guidelines. For major changes or new features for this expansion pack, please open an issue or discussion first.
@@ -39,13 +39,11 @@ You are developing games as a "Player Experience CEO" - thinking like a game dir
39
39
  ### Phase 1: Game Concept and Design
40
40
 
41
41
  1. **Game Designer**: Start with brainstorming and concept development
42
-
43
42
  - Use \*brainstorm to explore game concepts and mechanics
44
43
  - Create Game Brief using game-brief-tmpl
45
44
  - Develop core game pillars and player experience goals
46
45
 
47
46
  2. **Game Designer**: Create comprehensive Game Design Document
48
-
49
47
  - Use game-design-doc-tmpl to create detailed GDD
50
48
  - Define all game mechanics, progression, and balance
51
49
  - Specify technical requirements and platform targets
@@ -65,13 +63,11 @@ You are developing games as a "Player Experience CEO" - thinking like a game dir
65
63
  ### Phase 3: Story-Driven Development
66
64
 
67
65
  5. **Game Scrum Master**: Break down design into development stories
68
-
69
66
  - Use create-game-story task to create detailed implementation stories
70
67
  - Each story should be immediately actionable by game developers
71
68
  - Apply game-story-dod-checklist to ensure story quality
72
69
 
73
70
  6. **Game Developer**: Implement game features story by story
74
-
75
71
  - Follow TypeScript strict mode and Phaser 3 best practices
76
72
  - Maintain 60 FPS performance target throughout development
77
73
  - Use test-driven development for game logic components
@@ -380,7 +380,9 @@ class InputManager {
380
380
  }
381
381
 
382
382
  private setupKeyboard(): void {
383
- this.keys = this.scene.input.keyboard.addKeys("W,A,S,D,SPACE,ESC,UP,DOWN,LEFT,RIGHT");
383
+ this.keys = this.scene.input.keyboard.addKeys(
384
+ "W,A,S,D,SPACE,ESC,UP,DOWN,LEFT,RIGHT",
385
+ );
384
386
  }
385
387
 
386
388
  private setupTouch(): void {
@@ -585,25 +587,21 @@ src/
585
587
  ### Story Implementation Process
586
588
 
587
589
  1. **Read Story Requirements:**
588
-
589
590
  - Understand acceptance criteria
590
591
  - Identify technical requirements
591
592
  - Review performance constraints
592
593
 
593
594
  2. **Plan Implementation:**
594
-
595
595
  - Identify files to create/modify
596
596
  - Consider component architecture
597
597
  - Plan testing approach
598
598
 
599
599
  3. **Implement Feature:**
600
-
601
600
  - Follow TypeScript strict mode
602
601
  - Use established patterns
603
602
  - Maintain 60 FPS performance
604
603
 
605
604
  4. **Test Implementation:**
606
-
607
605
  - Write unit tests for game logic
608
606
  - Test cross-platform functionality
609
607
  - Validate performance targets
@@ -18,7 +18,6 @@
18
18
  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.")
19
19
 
20
20
  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:
21
-
22
21
  - The entire section as a whole
23
22
  - Individual game elements within the section (specify which element when selecting an action)
24
23
 
@@ -9,7 +9,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
9
9
  [[LLM: Begin by understanding the game design context and goals. Ask clarifying questions if needed to determine the best approach for game-specific ideation.]]
10
10
 
11
11
  1. **Establish Game Context**
12
-
13
12
  - Understand the game genre or opportunity area
14
13
  - Identify target audience and platform constraints
15
14
  - Determine session goals (concept exploration vs. mechanic refinement)
@@ -27,7 +26,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
27
26
 
28
27
  1. **"What If" Game Scenarios**
29
28
  [[LLM: Generate provocative what-if questions that challenge game design assumptions and expand thinking beyond current genre limitations.]]
30
-
31
29
  - What if players could rewind time in any genre?
32
30
  - What if the game world reacted to the player's real-world location?
33
31
  - What if failure was more rewarding than success?
@@ -36,7 +34,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
36
34
 
37
35
  2. **Cross-Genre Fusion**
38
36
  [[LLM: Help user combine unexpected game genres and mechanics to create unique experiences.]]
39
-
40
37
  - "How might [genre A] mechanics work in [genre B]?"
41
38
  - Puzzle mechanics in action games
42
39
  - Dating sim elements in strategy games
@@ -45,7 +42,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
45
42
 
46
43
  3. **Player Motivation Reversal**
47
44
  [[LLM: Flip traditional player motivations to reveal new gameplay possibilities.]]
48
-
49
45
  - What if losing was the goal?
50
46
  - What if cooperation was forced in competitive games?
51
47
  - What if players had to help their enemies?
@@ -62,7 +58,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
62
58
 
63
59
  1. **SCAMPER for Game Mechanics**
64
60
  [[LLM: Guide through each SCAMPER prompt specifically for game design.]]
65
-
66
61
  - **S** = Substitute: What mechanics can be substituted? (walking → flying → swimming)
67
62
  - **C** = Combine: What systems can be merged? (inventory + character growth)
68
63
  - **A** = Adapt: What mechanics from other media? (books, movies, sports)
@@ -73,7 +68,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
73
68
 
74
69
  2. **Player Agency Spectrum**
75
70
  [[LLM: Explore different levels of player control and agency across game systems.]]
76
-
77
71
  - Full Control: Direct character movement, combat, building
78
72
  - Indirect Control: Setting rules, giving commands, environmental changes
79
73
  - Influence Only: Suggestions, preferences, emotional reactions
@@ -81,7 +75,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
81
75
 
82
76
  3. **Temporal Game Design**
83
77
  [[LLM: Explore how time affects gameplay and player experience.]]
84
-
85
78
  - Real-time vs. turn-based mechanics
86
79
  - Time travel and manipulation
87
80
  - Persistent vs. session-based progress
@@ -92,7 +85,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
92
85
 
93
86
  1. **Emotion-First Design**
94
87
  [[LLM: Start with target emotions and work backward to mechanics that create them.]]
95
-
96
88
  - Target Emotion: Wonder → Mechanics: Discovery, mystery, scale
97
89
  - Target Emotion: Triumph → Mechanics: Challenge, skill growth, recognition
98
90
  - Target Emotion: Connection → Mechanics: Cooperation, shared goals, communication
@@ -100,7 +92,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
100
92
 
101
93
  2. **Player Archetype Brainstorming**
102
94
  [[LLM: Design for different player types and motivations.]]
103
-
104
95
  - Achievers: Progression, completion, mastery
105
96
  - Explorers: Discovery, secrets, world-building
106
97
  - Socializers: Interaction, cooperation, community
@@ -109,7 +100,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
109
100
 
110
101
  3. **Accessibility-First Innovation**
111
102
  [[LLM: Generate ideas that make games more accessible while creating new gameplay.]]
112
-
113
103
  - Visual impairment considerations leading to audio-focused mechanics
114
104
  - Motor accessibility inspiring one-handed or simplified controls
115
105
  - Cognitive accessibility driving clear feedback and pacing
@@ -119,7 +109,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
119
109
 
120
110
  1. **Environmental Storytelling**
121
111
  [[LLM: Brainstorm ways the game world itself tells stories without explicit narrative.]]
122
-
123
112
  - How does the environment show history?
124
113
  - What do interactive objects reveal about characters?
125
114
  - How can level design communicate mood?
@@ -127,7 +116,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
127
116
 
128
117
  2. **Player-Generated Narrative**
129
118
  [[LLM: Explore ways players create their own stories through gameplay.]]
130
-
131
119
  - Emergent storytelling through player choices
132
120
  - Procedural narrative generation
133
121
  - Player-to-player story sharing
@@ -135,7 +123,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
135
123
 
136
124
  3. **Genre Expectation Subversion**
137
125
  [[LLM: Identify and deliberately subvert player expectations within genres.]]
138
-
139
126
  - Fantasy RPG where magic is mundane
140
127
  - Horror game where monsters are friendly
141
128
  - Racing game where going slow is optimal
@@ -145,7 +132,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
145
132
 
146
133
  1. **Platform-Specific Design**
147
134
  [[LLM: Generate ideas that leverage unique platform capabilities.]]
148
-
149
135
  - Mobile: GPS, accelerometer, camera, always-connected
150
136
  - Web: URLs, tabs, social sharing, real-time collaboration
151
137
  - Console: Controllers, TV viewing, couch co-op
@@ -153,7 +139,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
153
139
 
154
140
  2. **Constraint-Based Creativity**
155
141
  [[LLM: Use technical or design constraints as creative catalysts.]]
156
-
157
142
  - One-button games
158
143
  - Games without graphics
159
144
  - Games that play in notification bars
@@ -199,19 +184,16 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
199
184
  [[LLM: Guide the brainstorming session with appropriate pacing for game design exploration.]]
200
185
 
201
186
  1. **Inspiration Phase** (10-15 min)
202
-
203
187
  - Reference existing games and mechanics
204
188
  - Explore player experiences and emotions
205
189
  - Gather visual and thematic inspiration
206
190
 
207
191
  2. **Divergent Exploration** (25-35 min)
208
-
209
192
  - Generate many game concepts or mechanics
210
193
  - Use expansion and fusion techniques
211
194
  - Encourage wild and impossible ideas
212
195
 
213
196
  3. **Player-Centered Filtering** (15-20 min)
214
-
215
197
  - Consider target audience reactions
216
198
  - Evaluate emotional impact and engagement
217
199
  - Group ideas by player experience goals