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
|
@@ -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:
|
|
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
|
|
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
|
|
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/
|
|
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
|
|
111
|
+
3. **Load the architect agent**: Upload `dist/agents/architect.txt`
|
|
112
112
|
4. **Run documentation**: Type `*document-project`
|
|
113
113
|
|
|
114
|
-
The
|
|
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/
|
|
210
|
-
docs/
|
|
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/
|
|
217
|
+
shard docs/prd.md
|
|
217
218
|
```
|
|
218
219
|
|
|
219
220
|
```bash
|
|
220
221
|
@po
|
|
221
|
-
shard docs/
|
|
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
|
-
|
|
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
|
-
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
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.
|
|
281
|
-
|
|
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.
|
|
288
|
-
|
|
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.
|
|
295
|
-
4.
|
|
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.
|
|
302
|
-
|
|
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
|
|
523
|
+
@architect *document-project
|
|
329
524
|
|
|
330
525
|
# Create enhancement PRD
|
|
331
|
-
@pm
|
|
526
|
+
@pm *create-brownfield-prd
|
|
332
527
|
|
|
333
528
|
# Create architecture with integration focus
|
|
334
|
-
@architect
|
|
529
|
+
@architect *create-brownfield-architecture
|
|
335
530
|
|
|
336
531
|
# Quick epic creation
|
|
337
|
-
@pm
|
|
532
|
+
@pm *create-brownfield-epic
|
|
338
533
|
|
|
339
534
|
# Single story creation
|
|
340
|
-
@pm
|
|
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-
|
|
357
|
-
└─
|
|
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
|
|
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: **
|
|
597
|
+
Remember: **In brownfield, the Test Architect isn't optional - it's your insurance policy against breaking production.**
|
package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md
CHANGED
|
@@ -8,21 +8,21 @@ This expansion pack provides a complete, deployable starter kit for building and
|
|
|
8
8
|
|
|
9
9
|
## Features
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
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
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
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
|
-
|
|
36
|
-
|
|
37
|
-
|
|
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(
|
|
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
|