bmad-method 4.31.0 → 4.32.0
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/.vscode/settings.json +1 -7
- package/CHANGELOG.md +108 -173
- package/README.md +40 -0
- 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 +1 -2
- package/bmad-core/agents/pm.md +3 -1
- package/bmad-core/agents/po.md +1 -1
- package/bmad-core/agents/qa.md +1 -1
- package/bmad-core/agents/sm.md +1 -1
- package/bmad-core/agents/ux-expert.md +1 -1
- package/bmad-core/bmad-core/user-guide.md +0 -0
- package/bmad-core/data/bmad-kb.md +12 -2
- package/bmad-core/data/elicitation-methods.md +20 -0
- package/bmad-core/enhanced-ide-development-workflow.md +43 -0
- package/bmad-core/tasks/advanced-elicitation.md +2 -0
- package/bmad-core/tasks/create-brownfield-story.md +20 -3
- package/bmad-core/tasks/document-project.md +19 -13
- package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
- package/bmad-core/tasks/index-docs.md +0 -1
- package/bmad-core/tasks/kb-mode-interaction.md +3 -3
- package/bmad-core/tasks/review-story.md +18 -1
- package/bmad-core/user-guide.md +7 -6
- package/bmad-core/working-in-the-brownfield.md +39 -36
- package/dist/agents/analyst.txt +6 -6
- package/dist/agents/architect.txt +8 -3
- package/dist/agents/bmad-master.txt +2 -1
- package/dist/agents/pm.txt +9 -2
- package/dist/agents/po.txt +2 -318
- package/dist/agents/qa.txt +0 -1
- package/dist/agents/sm.txt +3 -3
- package/dist/agents/ux-expert.txt +2 -297
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +6 -6
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +4047 -0
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +1520 -185
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +214 -1229
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +537 -373
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +6917 -2140
- package/dist/teams/team-all.txt +30 -25
- package/dist/teams/team-fullstack.txt +27 -21
- package/dist/teams/team-ide-minimal.txt +5 -322
- package/dist/teams/team-no-ui.txt +25 -16
- package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +3 -1
- package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +1 -0
- package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +80 -0
- package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +21 -16
- package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +25 -25
- package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +15 -14
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +396 -0
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +203 -0
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +1 -1
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +93 -121
- package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +1 -1
- package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +593 -68
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +151 -0
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +165 -198
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +200 -0
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +938 -453
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +3 -3
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +517 -155
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +12 -12
- package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +11 -11
- package/package.json +79 -76
- package/tools/cli.js +9 -0
- package/tools/flattener/main.js +559 -0
- package/tools/installer/lib/installer.js +1 -1
- package/tools/installer/package.json +1 -1
- package/.husky/pre-commit +0 -2
- package/.prettierignore +0 -21
- package/.prettierrc +0 -23
package/dist/teams/team-all.txt
CHANGED
|
@@ -226,14 +226,14 @@ persona:
|
|
|
226
226
|
- Numbered Options Protocol - Always use numbered lists for selections
|
|
227
227
|
commands:
|
|
228
228
|
- help: Show numbered list of the following commands to allow selection
|
|
229
|
-
- create-
|
|
229
|
+
- create-project-brief: use task create-doc with project-brief-tmpl.yaml
|
|
230
|
+
- perform-market-research: use task create-doc with market-research-tmpl.yaml
|
|
231
|
+
- create-competitor-analysis: use task create-doc with competitor-analysis-tmpl.yaml
|
|
230
232
|
- yolo: Toggle Yolo Mode
|
|
231
|
-
- doc-out: Output full document to current destination file
|
|
232
|
-
-
|
|
233
|
-
-
|
|
234
|
-
- brainstorm {topic}: Facilitate structured brainstorming session
|
|
233
|
+
- doc-out: Output full document in progress to current destination file
|
|
234
|
+
- research-prompt {topic}: execute task create-deep-research-prompt.md
|
|
235
|
+
- brainstorm {topic}: Facilitate structured brainstorming session (run task facilitate-brainstorming-session.md with template brainstorming-output-tmpl.yaml)
|
|
235
236
|
- elicit: run the task advanced-elicitation
|
|
236
|
-
- document-project: Analyze and document existing project structure comprehensively
|
|
237
237
|
- exit: Say goodbye as the Business Analyst, and then abandon inhabiting this persona
|
|
238
238
|
dependencies:
|
|
239
239
|
tasks:
|
|
@@ -290,11 +290,16 @@ persona:
|
|
|
290
290
|
- Living Architecture - Design for change and adaptation
|
|
291
291
|
commands:
|
|
292
292
|
- help: Show numbered list of the following commands to allow selection
|
|
293
|
-
- create-
|
|
294
|
-
-
|
|
293
|
+
- create-full-stack-architecture: use create-doc with fullstack-architecture-tmpl.yaml
|
|
294
|
+
- create-backend-architecture: use create-doc with architecture-tmpl.yaml
|
|
295
|
+
- create-front-end-architecture: use create-doc with front-end-architecture-tmpl.yaml
|
|
296
|
+
- create-brownfield-architecture: use create-doc with brownfield-architecture-tmpl.yaml
|
|
295
297
|
- doc-out: Output full document to current destination file
|
|
298
|
+
- document-project: execute the task document-project.md
|
|
296
299
|
- execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
|
|
297
|
-
- research {topic}: execute task create-deep-research-prompt
|
|
300
|
+
- research {topic}: execute task create-deep-research-prompt
|
|
301
|
+
- shard-prd: run the task shard-doc.md for the provided architecture.md (ask if not found)
|
|
302
|
+
- yolo: Toggle Yolo Mode
|
|
298
303
|
- exit: Say goodbye as the Architect, and then abandon inhabiting this persona
|
|
299
304
|
dependencies:
|
|
300
305
|
tasks:
|
|
@@ -398,9 +403,16 @@ persona:
|
|
|
398
403
|
- Strategic thinking & outcome-oriented
|
|
399
404
|
commands:
|
|
400
405
|
- help: Show numbered list of the following commands to allow selection
|
|
401
|
-
- create-
|
|
402
|
-
-
|
|
406
|
+
- create-prd: run task create-doc.md with template prd-tmpl.yaml
|
|
407
|
+
- create-brownfield-prd: run task create-doc.md with template brownfield-prd-tmpl.yaml
|
|
408
|
+
- create-brownfield-epic: run task brownfield-create-epic.md
|
|
409
|
+
- create-brownfield-story: run task brownfield-create-story.md
|
|
410
|
+
- create-epic: Create epic for brownfield projects (task brownfield-create-epic)
|
|
411
|
+
- create-story: Create user story from requirements (task brownfield-create-story)
|
|
403
412
|
- doc-out: Output full document to current destination file
|
|
413
|
+
- shard-prd: run the task shard-doc.md for the provided prd.md (ask if not found)
|
|
414
|
+
- correct-course: execute the correct-course task
|
|
415
|
+
- yolo: Toggle Yolo Mode
|
|
404
416
|
- exit: Exit (confirm)
|
|
405
417
|
dependencies:
|
|
406
418
|
tasks:
|
|
@@ -458,23 +470,20 @@ persona:
|
|
|
458
470
|
- Documentation Ecosystem Integrity - Maintain consistency across all documents
|
|
459
471
|
commands:
|
|
460
472
|
- help: Show numbered list of the following commands to allow selection
|
|
461
|
-
-
|
|
462
|
-
- execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
|
|
473
|
+
- execute-checklist-po: Run task execute-checklist (checklist po-master-checklist)
|
|
463
474
|
- shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
|
|
464
475
|
- correct-course: execute the correct-course task
|
|
465
476
|
- create-epic: Create epic for brownfield projects (task brownfield-create-epic)
|
|
466
477
|
- create-story: Create user story from requirements (task brownfield-create-story)
|
|
467
|
-
- yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
|
|
468
478
|
- doc-out: Output full document to current destination file
|
|
469
479
|
- validate-story-draft {story}: run the task validate-next-story against the provided story file
|
|
480
|
+
- yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
|
|
470
481
|
- exit: Exit (confirm)
|
|
471
482
|
dependencies:
|
|
472
483
|
tasks:
|
|
473
484
|
- execute-checklist.md
|
|
474
485
|
- shard-doc.md
|
|
475
486
|
- correct-course.md
|
|
476
|
-
- brownfield-create-epic.md
|
|
477
|
-
- brownfield-create-story.md
|
|
478
487
|
- validate-next-story.md
|
|
479
488
|
templates:
|
|
480
489
|
- story-tmpl.yaml
|
|
@@ -525,7 +534,6 @@ story-file-permissions:
|
|
|
525
534
|
commands:
|
|
526
535
|
- help: Show numbered list of the following commands to allow selection
|
|
527
536
|
- review {story}: execute the task review-story for the highest sequence story in docs/stories unless another is specified - keep any specified technical-preferences in mind as needed
|
|
528
|
-
- create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
|
|
529
537
|
- exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
|
|
530
538
|
dependencies:
|
|
531
539
|
tasks:
|
|
@@ -566,9 +574,9 @@ persona:
|
|
|
566
574
|
- You are NOT allowed to implement stories or modify code EVER!
|
|
567
575
|
commands:
|
|
568
576
|
- help: Show numbered list of the following commands to allow selection
|
|
569
|
-
- draft: Execute task create-next-story
|
|
570
|
-
- correct-course: Execute task correct-course
|
|
571
|
-
- checklist
|
|
577
|
+
- draft: Execute task create-next-story.md
|
|
578
|
+
- correct-course: Execute task correct-course.md
|
|
579
|
+
- story-checklist: Execute task execute-checklist.md with checklist story-draft-checklist.md
|
|
572
580
|
- exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona
|
|
573
581
|
dependencies:
|
|
574
582
|
tasks:
|
|
@@ -616,15 +624,12 @@ persona:
|
|
|
616
624
|
- You can craft effective prompts for AI UI generation tools like v0, or Lovable.
|
|
617
625
|
commands:
|
|
618
626
|
- help: Show numbered list of the following commands to allow selection
|
|
619
|
-
- create-
|
|
620
|
-
- generate-ui-prompt:
|
|
621
|
-
- research {topic}: Execute create-deep-research-prompt task to generate a prompt to init UX deep research
|
|
622
|
-
- execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
|
|
627
|
+
- create-front-end-spec: run task create-doc.md with template front-end-spec-tmpl.yaml
|
|
628
|
+
- generate-ui-prompt: Run task generate-ai-frontend-prompt.md
|
|
623
629
|
- exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona
|
|
624
630
|
dependencies:
|
|
625
631
|
tasks:
|
|
626
632
|
- generate-ai-frontend-prompt.md
|
|
627
|
-
- create-deep-research-prompt.md
|
|
628
633
|
- create-doc.md
|
|
629
634
|
- execute-checklist.md
|
|
630
635
|
templates:
|
|
@@ -230,14 +230,14 @@ persona:
|
|
|
230
230
|
- Numbered Options Protocol - Always use numbered lists for selections
|
|
231
231
|
commands:
|
|
232
232
|
- help: Show numbered list of the following commands to allow selection
|
|
233
|
-
- create-
|
|
233
|
+
- create-project-brief: use task create-doc with project-brief-tmpl.yaml
|
|
234
|
+
- perform-market-research: use task create-doc with market-research-tmpl.yaml
|
|
235
|
+
- create-competitor-analysis: use task create-doc with competitor-analysis-tmpl.yaml
|
|
234
236
|
- yolo: Toggle Yolo Mode
|
|
235
|
-
- doc-out: Output full document to current destination file
|
|
236
|
-
-
|
|
237
|
-
-
|
|
238
|
-
- brainstorm {topic}: Facilitate structured brainstorming session
|
|
237
|
+
- doc-out: Output full document in progress to current destination file
|
|
238
|
+
- research-prompt {topic}: execute task create-deep-research-prompt.md
|
|
239
|
+
- brainstorm {topic}: Facilitate structured brainstorming session (run task facilitate-brainstorming-session.md with template brainstorming-output-tmpl.yaml)
|
|
239
240
|
- elicit: run the task advanced-elicitation
|
|
240
|
-
- document-project: Analyze and document existing project structure comprehensively
|
|
241
241
|
- exit: Say goodbye as the Business Analyst, and then abandon inhabiting this persona
|
|
242
242
|
dependencies:
|
|
243
243
|
tasks:
|
|
@@ -290,9 +290,16 @@ persona:
|
|
|
290
290
|
- Strategic thinking & outcome-oriented
|
|
291
291
|
commands:
|
|
292
292
|
- help: Show numbered list of the following commands to allow selection
|
|
293
|
-
- create-
|
|
294
|
-
-
|
|
293
|
+
- create-prd: run task create-doc.md with template prd-tmpl.yaml
|
|
294
|
+
- create-brownfield-prd: run task create-doc.md with template brownfield-prd-tmpl.yaml
|
|
295
|
+
- create-brownfield-epic: run task brownfield-create-epic.md
|
|
296
|
+
- create-brownfield-story: run task brownfield-create-story.md
|
|
297
|
+
- create-epic: Create epic for brownfield projects (task brownfield-create-epic)
|
|
298
|
+
- create-story: Create user story from requirements (task brownfield-create-story)
|
|
295
299
|
- doc-out: Output full document to current destination file
|
|
300
|
+
- shard-prd: run the task shard-doc.md for the provided prd.md (ask if not found)
|
|
301
|
+
- correct-course: execute the correct-course task
|
|
302
|
+
- yolo: Toggle Yolo Mode
|
|
296
303
|
- exit: Exit (confirm)
|
|
297
304
|
dependencies:
|
|
298
305
|
tasks:
|
|
@@ -348,15 +355,12 @@ persona:
|
|
|
348
355
|
- You can craft effective prompts for AI UI generation tools like v0, or Lovable.
|
|
349
356
|
commands:
|
|
350
357
|
- help: Show numbered list of the following commands to allow selection
|
|
351
|
-
- create-
|
|
352
|
-
- generate-ui-prompt:
|
|
353
|
-
- research {topic}: Execute create-deep-research-prompt task to generate a prompt to init UX deep research
|
|
354
|
-
- execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
|
|
358
|
+
- create-front-end-spec: run task create-doc.md with template front-end-spec-tmpl.yaml
|
|
359
|
+
- generate-ui-prompt: Run task generate-ai-frontend-prompt.md
|
|
355
360
|
- exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona
|
|
356
361
|
dependencies:
|
|
357
362
|
tasks:
|
|
358
363
|
- generate-ai-frontend-prompt.md
|
|
359
|
-
- create-deep-research-prompt.md
|
|
360
364
|
- create-doc.md
|
|
361
365
|
- execute-checklist.md
|
|
362
366
|
templates:
|
|
@@ -403,11 +407,16 @@ persona:
|
|
|
403
407
|
- Living Architecture - Design for change and adaptation
|
|
404
408
|
commands:
|
|
405
409
|
- help: Show numbered list of the following commands to allow selection
|
|
406
|
-
- create-
|
|
407
|
-
-
|
|
410
|
+
- create-full-stack-architecture: use create-doc with fullstack-architecture-tmpl.yaml
|
|
411
|
+
- create-backend-architecture: use create-doc with architecture-tmpl.yaml
|
|
412
|
+
- create-front-end-architecture: use create-doc with front-end-architecture-tmpl.yaml
|
|
413
|
+
- create-brownfield-architecture: use create-doc with brownfield-architecture-tmpl.yaml
|
|
408
414
|
- doc-out: Output full document to current destination file
|
|
415
|
+
- document-project: execute the task document-project.md
|
|
409
416
|
- execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
|
|
410
|
-
- research {topic}: execute task create-deep-research-prompt
|
|
417
|
+
- research {topic}: execute task create-deep-research-prompt
|
|
418
|
+
- shard-prd: run the task shard-doc.md for the provided architecture.md (ask if not found)
|
|
419
|
+
- yolo: Toggle Yolo Mode
|
|
411
420
|
- exit: Say goodbye as the Architect, and then abandon inhabiting this persona
|
|
412
421
|
dependencies:
|
|
413
422
|
tasks:
|
|
@@ -463,23 +472,20 @@ persona:
|
|
|
463
472
|
- Documentation Ecosystem Integrity - Maintain consistency across all documents
|
|
464
473
|
commands:
|
|
465
474
|
- help: Show numbered list of the following commands to allow selection
|
|
466
|
-
-
|
|
467
|
-
- execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
|
|
475
|
+
- execute-checklist-po: Run task execute-checklist (checklist po-master-checklist)
|
|
468
476
|
- shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
|
|
469
477
|
- correct-course: execute the correct-course task
|
|
470
478
|
- create-epic: Create epic for brownfield projects (task brownfield-create-epic)
|
|
471
479
|
- create-story: Create user story from requirements (task brownfield-create-story)
|
|
472
|
-
- yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
|
|
473
480
|
- doc-out: Output full document to current destination file
|
|
474
481
|
- validate-story-draft {story}: run the task validate-next-story against the provided story file
|
|
482
|
+
- yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
|
|
475
483
|
- exit: Exit (confirm)
|
|
476
484
|
dependencies:
|
|
477
485
|
tasks:
|
|
478
486
|
- execute-checklist.md
|
|
479
487
|
- shard-doc.md
|
|
480
488
|
- correct-course.md
|
|
481
|
-
- brownfield-create-epic.md
|
|
482
|
-
- brownfield-create-story.md
|
|
483
489
|
- validate-next-story.md
|
|
484
490
|
templates:
|
|
485
491
|
- story-tmpl.yaml
|
|
@@ -221,23 +221,20 @@ persona:
|
|
|
221
221
|
- Documentation Ecosystem Integrity - Maintain consistency across all documents
|
|
222
222
|
commands:
|
|
223
223
|
- help: Show numbered list of the following commands to allow selection
|
|
224
|
-
-
|
|
225
|
-
- execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
|
|
224
|
+
- execute-checklist-po: Run task execute-checklist (checklist po-master-checklist)
|
|
226
225
|
- shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
|
|
227
226
|
- correct-course: execute the correct-course task
|
|
228
227
|
- create-epic: Create epic for brownfield projects (task brownfield-create-epic)
|
|
229
228
|
- create-story: Create user story from requirements (task brownfield-create-story)
|
|
230
|
-
- yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
|
|
231
229
|
- doc-out: Output full document to current destination file
|
|
232
230
|
- validate-story-draft {story}: run the task validate-next-story against the provided story file
|
|
231
|
+
- yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
|
|
233
232
|
- exit: Exit (confirm)
|
|
234
233
|
dependencies:
|
|
235
234
|
tasks:
|
|
236
235
|
- execute-checklist.md
|
|
237
236
|
- shard-doc.md
|
|
238
237
|
- correct-course.md
|
|
239
|
-
- brownfield-create-epic.md
|
|
240
|
-
- brownfield-create-story.md
|
|
241
238
|
- validate-next-story.md
|
|
242
239
|
templates:
|
|
243
240
|
- story-tmpl.yaml
|
|
@@ -276,9 +273,9 @@ persona:
|
|
|
276
273
|
- You are NOT allowed to implement stories or modify code EVER!
|
|
277
274
|
commands:
|
|
278
275
|
- help: Show numbered list of the following commands to allow selection
|
|
279
|
-
- draft: Execute task create-next-story
|
|
280
|
-
- correct-course: Execute task correct-course
|
|
281
|
-
- checklist
|
|
276
|
+
- draft: Execute task create-next-story.md
|
|
277
|
+
- correct-course: Execute task correct-course.md
|
|
278
|
+
- story-checklist: Execute task execute-checklist.md with checklist story-draft-checklist.md
|
|
282
279
|
- exit: Say goodbye as the Scrum Master, and then abandon inhabiting this persona
|
|
283
280
|
dependencies:
|
|
284
281
|
tasks:
|
|
@@ -384,7 +381,6 @@ story-file-permissions:
|
|
|
384
381
|
commands:
|
|
385
382
|
- help: Show numbered list of the following commands to allow selection
|
|
386
383
|
- review {story}: execute the task review-story for the highest sequence story in docs/stories unless another is specified - keep any specified technical-preferences in mind as needed
|
|
387
|
-
- create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
|
|
388
384
|
- exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
|
|
389
385
|
dependencies:
|
|
390
386
|
tasks:
|
|
@@ -2072,319 +2068,6 @@ Document sharded successfully:
|
|
|
2072
2068
|
- **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
|
|
2073
2069
|
==================== END: .bmad-core/tasks/correct-course.md ====================
|
|
2074
2070
|
|
|
2075
|
-
==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
|
|
2076
|
-
# Create Brownfield Epic Task
|
|
2077
|
-
|
|
2078
|
-
## Purpose
|
|
2079
|
-
|
|
2080
|
-
Create a single epic for smaller brownfield enhancements that don't require the full PRD and Architecture documentation process. This task is for isolated features or modifications that can be completed within a focused scope.
|
|
2081
|
-
|
|
2082
|
-
## When to Use This Task
|
|
2083
|
-
|
|
2084
|
-
**Use this task when:**
|
|
2085
|
-
|
|
2086
|
-
- The enhancement can be completed in 1-3 stories
|
|
2087
|
-
- No significant architectural changes are required
|
|
2088
|
-
- The enhancement follows existing project patterns
|
|
2089
|
-
- Integration complexity is minimal
|
|
2090
|
-
- Risk to existing system is low
|
|
2091
|
-
|
|
2092
|
-
**Use the full brownfield PRD/Architecture process when:**
|
|
2093
|
-
|
|
2094
|
-
- The enhancement requires multiple coordinated stories
|
|
2095
|
-
- Architectural planning is needed
|
|
2096
|
-
- Significant integration work is required
|
|
2097
|
-
- Risk assessment and mitigation planning is necessary
|
|
2098
|
-
|
|
2099
|
-
## Instructions
|
|
2100
|
-
|
|
2101
|
-
### 1. Project Analysis (Required)
|
|
2102
|
-
|
|
2103
|
-
Before creating the epic, gather essential information about the existing project:
|
|
2104
|
-
|
|
2105
|
-
**Existing Project Context:**
|
|
2106
|
-
|
|
2107
|
-
- [ ] Project purpose and current functionality understood
|
|
2108
|
-
- [ ] Existing technology stack identified
|
|
2109
|
-
- [ ] Current architecture patterns noted
|
|
2110
|
-
- [ ] Integration points with existing system identified
|
|
2111
|
-
|
|
2112
|
-
**Enhancement Scope:**
|
|
2113
|
-
|
|
2114
|
-
- [ ] Enhancement clearly defined and scoped
|
|
2115
|
-
- [ ] Impact on existing functionality assessed
|
|
2116
|
-
- [ ] Required integration points identified
|
|
2117
|
-
- [ ] Success criteria established
|
|
2118
|
-
|
|
2119
|
-
### 2. Epic Creation
|
|
2120
|
-
|
|
2121
|
-
Create a focused epic following this structure:
|
|
2122
|
-
|
|
2123
|
-
#### Epic Title
|
|
2124
|
-
|
|
2125
|
-
{{Enhancement Name}} - Brownfield Enhancement
|
|
2126
|
-
|
|
2127
|
-
#### Epic Goal
|
|
2128
|
-
|
|
2129
|
-
{{1-2 sentences describing what the epic will accomplish and why it adds value}}
|
|
2130
|
-
|
|
2131
|
-
#### Epic Description
|
|
2132
|
-
|
|
2133
|
-
**Existing System Context:**
|
|
2134
|
-
|
|
2135
|
-
- Current relevant functionality: {{brief description}}
|
|
2136
|
-
- Technology stack: {{relevant existing technologies}}
|
|
2137
|
-
- Integration points: {{where new work connects to existing system}}
|
|
2138
|
-
|
|
2139
|
-
**Enhancement Details:**
|
|
2140
|
-
|
|
2141
|
-
- What's being added/changed: {{clear description}}
|
|
2142
|
-
- How it integrates: {{integration approach}}
|
|
2143
|
-
- Success criteria: {{measurable outcomes}}
|
|
2144
|
-
|
|
2145
|
-
#### Stories
|
|
2146
|
-
|
|
2147
|
-
List 1-3 focused stories that complete the epic:
|
|
2148
|
-
|
|
2149
|
-
1. **Story 1:** {{Story title and brief description}}
|
|
2150
|
-
2. **Story 2:** {{Story title and brief description}}
|
|
2151
|
-
3. **Story 3:** {{Story title and brief description}}
|
|
2152
|
-
|
|
2153
|
-
#### Compatibility Requirements
|
|
2154
|
-
|
|
2155
|
-
- [ ] Existing APIs remain unchanged
|
|
2156
|
-
- [ ] Database schema changes are backward compatible
|
|
2157
|
-
- [ ] UI changes follow existing patterns
|
|
2158
|
-
- [ ] Performance impact is minimal
|
|
2159
|
-
|
|
2160
|
-
#### Risk Mitigation
|
|
2161
|
-
|
|
2162
|
-
- **Primary Risk:** {{main risk to existing system}}
|
|
2163
|
-
- **Mitigation:** {{how risk will be addressed}}
|
|
2164
|
-
- **Rollback Plan:** {{how to undo changes if needed}}
|
|
2165
|
-
|
|
2166
|
-
#### Definition of Done
|
|
2167
|
-
|
|
2168
|
-
- [ ] All stories completed with acceptance criteria met
|
|
2169
|
-
- [ ] Existing functionality verified through testing
|
|
2170
|
-
- [ ] Integration points working correctly
|
|
2171
|
-
- [ ] Documentation updated appropriately
|
|
2172
|
-
- [ ] No regression in existing features
|
|
2173
|
-
|
|
2174
|
-
### 3. Validation Checklist
|
|
2175
|
-
|
|
2176
|
-
Before finalizing the epic, ensure:
|
|
2177
|
-
|
|
2178
|
-
**Scope Validation:**
|
|
2179
|
-
|
|
2180
|
-
- [ ] Epic can be completed in 1-3 stories maximum
|
|
2181
|
-
- [ ] No architectural documentation is required
|
|
2182
|
-
- [ ] Enhancement follows existing patterns
|
|
2183
|
-
- [ ] Integration complexity is manageable
|
|
2184
|
-
|
|
2185
|
-
**Risk Assessment:**
|
|
2186
|
-
|
|
2187
|
-
- [ ] Risk to existing system is low
|
|
2188
|
-
- [ ] Rollback plan is feasible
|
|
2189
|
-
- [ ] Testing approach covers existing functionality
|
|
2190
|
-
- [ ] Team has sufficient knowledge of integration points
|
|
2191
|
-
|
|
2192
|
-
**Completeness Check:**
|
|
2193
|
-
|
|
2194
|
-
- [ ] Epic goal is clear and achievable
|
|
2195
|
-
- [ ] Stories are properly scoped
|
|
2196
|
-
- [ ] Success criteria are measurable
|
|
2197
|
-
- [ ] Dependencies are identified
|
|
2198
|
-
|
|
2199
|
-
### 4. Handoff to Story Manager
|
|
2200
|
-
|
|
2201
|
-
Once the epic is validated, provide this handoff to the Story Manager:
|
|
2202
|
-
|
|
2203
|
-
---
|
|
2204
|
-
|
|
2205
|
-
**Story Manager Handoff:**
|
|
2206
|
-
|
|
2207
|
-
"Please develop detailed user stories for this brownfield epic. Key considerations:
|
|
2208
|
-
|
|
2209
|
-
- This is an enhancement to an existing system running {{technology stack}}
|
|
2210
|
-
- Integration points: {{list key integration points}}
|
|
2211
|
-
- Existing patterns to follow: {{relevant existing patterns}}
|
|
2212
|
-
- Critical compatibility requirements: {{key requirements}}
|
|
2213
|
-
- Each story must include verification that existing functionality remains intact
|
|
2214
|
-
|
|
2215
|
-
The epic should maintain system integrity while delivering {{epic goal}}."
|
|
2216
|
-
|
|
2217
|
-
---
|
|
2218
|
-
|
|
2219
|
-
## Success Criteria
|
|
2220
|
-
|
|
2221
|
-
The epic creation is successful when:
|
|
2222
|
-
|
|
2223
|
-
1. Enhancement scope is clearly defined and appropriately sized
|
|
2224
|
-
2. Integration approach respects existing system architecture
|
|
2225
|
-
3. Risk to existing functionality is minimized
|
|
2226
|
-
4. Stories are logically sequenced for safe implementation
|
|
2227
|
-
5. Compatibility requirements are clearly specified
|
|
2228
|
-
6. Rollback plan is feasible and documented
|
|
2229
|
-
|
|
2230
|
-
## Important Notes
|
|
2231
|
-
|
|
2232
|
-
- This task is specifically for SMALL brownfield enhancements
|
|
2233
|
-
- If the scope grows beyond 3 stories, consider the full brownfield PRD process
|
|
2234
|
-
- Always prioritize existing system integrity over new functionality
|
|
2235
|
-
- When in doubt about scope or complexity, escalate to full brownfield planning
|
|
2236
|
-
==================== END: .bmad-core/tasks/brownfield-create-epic.md ====================
|
|
2237
|
-
|
|
2238
|
-
==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
|
|
2239
|
-
# Create Brownfield Story Task
|
|
2240
|
-
|
|
2241
|
-
## Purpose
|
|
2242
|
-
|
|
2243
|
-
Create a single user story for very small brownfield enhancements that can be completed in one focused development session. This task is for minimal additions or bug fixes that require existing system integration awareness.
|
|
2244
|
-
|
|
2245
|
-
## When to Use This Task
|
|
2246
|
-
|
|
2247
|
-
**Use this task when:**
|
|
2248
|
-
|
|
2249
|
-
- The enhancement can be completed in a single story
|
|
2250
|
-
- No new architecture or significant design is required
|
|
2251
|
-
- The change follows existing patterns exactly
|
|
2252
|
-
- Integration is straightforward with minimal risk
|
|
2253
|
-
- Change is isolated with clear boundaries
|
|
2254
|
-
|
|
2255
|
-
**Use brownfield-create-epic when:**
|
|
2256
|
-
|
|
2257
|
-
- The enhancement requires 2-3 coordinated stories
|
|
2258
|
-
- Some design work is needed
|
|
2259
|
-
- Multiple integration points are involved
|
|
2260
|
-
|
|
2261
|
-
**Use the full brownfield PRD/Architecture process when:**
|
|
2262
|
-
|
|
2263
|
-
- The enhancement requires multiple coordinated stories
|
|
2264
|
-
- Architectural planning is needed
|
|
2265
|
-
- Significant integration work is required
|
|
2266
|
-
|
|
2267
|
-
## Instructions
|
|
2268
|
-
|
|
2269
|
-
### 1. Quick Project Assessment
|
|
2270
|
-
|
|
2271
|
-
Gather minimal but essential context about the existing project:
|
|
2272
|
-
|
|
2273
|
-
**Current System Context:**
|
|
2274
|
-
|
|
2275
|
-
- [ ] Relevant existing functionality identified
|
|
2276
|
-
- [ ] Technology stack for this area noted
|
|
2277
|
-
- [ ] Integration point(s) clearly understood
|
|
2278
|
-
- [ ] Existing patterns for similar work identified
|
|
2279
|
-
|
|
2280
|
-
**Change Scope:**
|
|
2281
|
-
|
|
2282
|
-
- [ ] Specific change clearly defined
|
|
2283
|
-
- [ ] Impact boundaries identified
|
|
2284
|
-
- [ ] Success criteria established
|
|
2285
|
-
|
|
2286
|
-
### 2. Story Creation
|
|
2287
|
-
|
|
2288
|
-
Create a single focused story following this structure:
|
|
2289
|
-
|
|
2290
|
-
#### Story Title
|
|
2291
|
-
|
|
2292
|
-
{{Specific Enhancement}} - Brownfield Addition
|
|
2293
|
-
|
|
2294
|
-
#### User Story
|
|
2295
|
-
|
|
2296
|
-
As a {{user type}},
|
|
2297
|
-
I want {{specific action/capability}},
|
|
2298
|
-
So that {{clear benefit/value}}.
|
|
2299
|
-
|
|
2300
|
-
#### Story Context
|
|
2301
|
-
|
|
2302
|
-
**Existing System Integration:**
|
|
2303
|
-
|
|
2304
|
-
- Integrates with: {{existing component/system}}
|
|
2305
|
-
- Technology: {{relevant tech stack}}
|
|
2306
|
-
- Follows pattern: {{existing pattern to follow}}
|
|
2307
|
-
- Touch points: {{specific integration points}}
|
|
2308
|
-
|
|
2309
|
-
#### Acceptance Criteria
|
|
2310
|
-
|
|
2311
|
-
**Functional Requirements:**
|
|
2312
|
-
|
|
2313
|
-
1. {{Primary functional requirement}}
|
|
2314
|
-
2. {{Secondary functional requirement (if any)}}
|
|
2315
|
-
3. {{Integration requirement}}
|
|
2316
|
-
|
|
2317
|
-
**Integration Requirements:** 4. Existing {{relevant functionality}} continues to work unchanged 5. New functionality follows existing {{pattern}} pattern 6. Integration with {{system/component}} maintains current behavior
|
|
2318
|
-
|
|
2319
|
-
**Quality Requirements:** 7. Change is covered by appropriate tests 8. Documentation is updated if needed 9. No regression in existing functionality verified
|
|
2320
|
-
|
|
2321
|
-
#### Technical Notes
|
|
2322
|
-
|
|
2323
|
-
- **Integration Approach:** {{how it connects to existing system}}
|
|
2324
|
-
- **Existing Pattern Reference:** {{link or description of pattern to follow}}
|
|
2325
|
-
- **Key Constraints:** {{any important limitations or requirements}}
|
|
2326
|
-
|
|
2327
|
-
#### Definition of Done
|
|
2328
|
-
|
|
2329
|
-
- [ ] Functional requirements met
|
|
2330
|
-
- [ ] Integration requirements verified
|
|
2331
|
-
- [ ] Existing functionality regression tested
|
|
2332
|
-
- [ ] Code follows existing patterns and standards
|
|
2333
|
-
- [ ] Tests pass (existing and new)
|
|
2334
|
-
- [ ] Documentation updated if applicable
|
|
2335
|
-
|
|
2336
|
-
### 3. Risk and Compatibility Check
|
|
2337
|
-
|
|
2338
|
-
**Minimal Risk Assessment:**
|
|
2339
|
-
|
|
2340
|
-
- **Primary Risk:** {{main risk to existing system}}
|
|
2341
|
-
- **Mitigation:** {{simple mitigation approach}}
|
|
2342
|
-
- **Rollback:** {{how to undo if needed}}
|
|
2343
|
-
|
|
2344
|
-
**Compatibility Verification:**
|
|
2345
|
-
|
|
2346
|
-
- [ ] No breaking changes to existing APIs
|
|
2347
|
-
- [ ] Database changes (if any) are additive only
|
|
2348
|
-
- [ ] UI changes follow existing design patterns
|
|
2349
|
-
- [ ] Performance impact is negligible
|
|
2350
|
-
|
|
2351
|
-
### 4. Validation Checklist
|
|
2352
|
-
|
|
2353
|
-
Before finalizing the story, confirm:
|
|
2354
|
-
|
|
2355
|
-
**Scope Validation:**
|
|
2356
|
-
|
|
2357
|
-
- [ ] Story can be completed in one development session
|
|
2358
|
-
- [ ] Integration approach is straightforward
|
|
2359
|
-
- [ ] Follows existing patterns exactly
|
|
2360
|
-
- [ ] No design or architecture work required
|
|
2361
|
-
|
|
2362
|
-
**Clarity Check:**
|
|
2363
|
-
|
|
2364
|
-
- [ ] Story requirements are unambiguous
|
|
2365
|
-
- [ ] Integration points are clearly specified
|
|
2366
|
-
- [ ] Success criteria are testable
|
|
2367
|
-
- [ ] Rollback approach is simple
|
|
2368
|
-
|
|
2369
|
-
## Success Criteria
|
|
2370
|
-
|
|
2371
|
-
The story creation is successful when:
|
|
2372
|
-
|
|
2373
|
-
1. Enhancement is clearly defined and appropriately scoped for single session
|
|
2374
|
-
2. Integration approach is straightforward and low-risk
|
|
2375
|
-
3. Existing system patterns are identified and will be followed
|
|
2376
|
-
4. Rollback plan is simple and feasible
|
|
2377
|
-
5. Acceptance criteria include existing functionality verification
|
|
2378
|
-
|
|
2379
|
-
## Important Notes
|
|
2380
|
-
|
|
2381
|
-
- This task is for VERY SMALL brownfield changes only
|
|
2382
|
-
- If complexity grows during analysis, escalate to brownfield-create-epic
|
|
2383
|
-
- Always prioritize existing system integrity
|
|
2384
|
-
- When in doubt about integration complexity, use brownfield-create-epic instead
|
|
2385
|
-
- Stories should take no more than 4 hours of focused development work
|
|
2386
|
-
==================== END: .bmad-core/tasks/brownfield-create-story.md ====================
|
|
2387
|
-
|
|
2388
2071
|
==================== START: .bmad-core/tasks/validate-next-story.md ====================
|
|
2389
2072
|
# Validate Next Story Task
|
|
2390
2073
|
|