bmad-method 4.30.4 → 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.
Files changed (82) hide show
  1. package/.vscode/settings.json +1 -7
  2. package/CHANGELOG.md +117 -170
  3. package/README.md +46 -7
  4. package/bmad-core/agents/analyst.md +1 -1
  5. package/bmad-core/agents/architect.md +2 -3
  6. package/bmad-core/agents/bmad-master.md +0 -1
  7. package/bmad-core/agents/bmad-orchestrator.md +9 -10
  8. package/bmad-core/agents/dev.md +1 -2
  9. package/bmad-core/agents/pm.md +3 -1
  10. package/bmad-core/agents/po.md +1 -1
  11. package/bmad-core/agents/qa.md +1 -1
  12. package/bmad-core/agents/sm.md +1 -1
  13. package/bmad-core/agents/ux-expert.md +1 -1
  14. package/bmad-core/bmad-core/user-guide.md +0 -0
  15. package/bmad-core/data/bmad-kb.md +12 -2
  16. package/bmad-core/data/elicitation-methods.md +20 -0
  17. package/bmad-core/enhanced-ide-development-workflow.md +43 -0
  18. package/bmad-core/tasks/advanced-elicitation.md +2 -0
  19. package/bmad-core/tasks/create-brownfield-story.md +20 -3
  20. package/bmad-core/tasks/document-project.md +19 -13
  21. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  22. package/bmad-core/tasks/index-docs.md +0 -1
  23. package/bmad-core/tasks/kb-mode-interaction.md +3 -3
  24. package/bmad-core/tasks/review-story.md +18 -1
  25. package/bmad-core/user-guide.md +251 -0
  26. package/{docs → bmad-core}/working-in-the-brownfield.md +39 -36
  27. package/dist/agents/analyst.txt +6 -6
  28. package/dist/agents/architect.txt +8 -3
  29. package/dist/agents/bmad-master.txt +2 -1
  30. package/dist/agents/pm.txt +9 -2
  31. package/dist/agents/po.txt +2 -318
  32. package/dist/agents/qa.txt +0 -1
  33. package/dist/agents/sm.txt +3 -3
  34. package/dist/agents/ux-expert.txt +2 -297
  35. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +6 -6
  36. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +4047 -0
  37. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +1520 -185
  38. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +214 -1229
  39. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +537 -373
  40. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +6917 -2140
  41. package/dist/teams/team-all.txt +30 -25
  42. package/dist/teams/team-fullstack.txt +27 -21
  43. package/dist/teams/team-ide-minimal.txt +5 -322
  44. package/dist/teams/team-no-ui.txt +25 -16
  45. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +3 -1
  46. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +1 -0
  47. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +80 -0
  48. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +21 -16
  49. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +25 -25
  50. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +15 -14
  51. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +396 -0
  52. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +203 -0
  53. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +1 -1
  54. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +93 -121
  55. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +1 -1
  56. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +593 -68
  57. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +151 -0
  58. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +165 -198
  59. package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +200 -0
  60. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +938 -453
  61. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +3 -3
  62. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +517 -155
  63. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +12 -12
  64. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +11 -11
  65. package/package.json +79 -76
  66. package/tools/cli.js +9 -0
  67. package/tools/flattener/main.js +559 -0
  68. package/tools/installer/lib/installer.js +4 -0
  69. package/tools/installer/package.json +1 -1
  70. package/.husky/pre-commit +0 -2
  71. package/.prettierignore +0 -21
  72. package/.prettierrc +0 -23
  73. package/docs/agentic-tools/claude-code-guide.md +0 -19
  74. package/docs/agentic-tools/cline-guide.md +0 -16
  75. package/docs/agentic-tools/cursor-guide.md +0 -14
  76. package/docs/agentic-tools/gemini-cli-guide.md +0 -31
  77. package/docs/agentic-tools/github-copilot-guide.md +0 -42
  78. package/docs/agentic-tools/roo-code-guide.md +0 -15
  79. package/docs/agentic-tools/trae-guide.md +0 -14
  80. package/docs/agentic-tools/windsurf-guide.md +0 -14
  81. package/docs/bmad-workflow-guide.md +0 -166
  82. package/docs/user-guide.md +0 -1142
@@ -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-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
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
- - execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
233
- - research-prompt {topic}: execute task create-deep-research-prompt for architectural decisions
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-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
294
- - yolo: Toggle Yolo Mode
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 for architectural decisions
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-doc {template}: execute task create-doc for template provided, if no template then ONLY list dependencies.templates
402
- - yolo: Toggle Yolo Mode
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
- - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
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 {checklist}: Show numbered list of checklists if not provided, execute task execute-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-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
620
- - generate-ui-prompt: Create AI frontend generation 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-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
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
- - execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
237
- - research-prompt {topic}: execute task create-deep-research-prompt for architectural decisions
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-doc {template}: execute task create-doc for template provided, if no template then ONLY list dependencies.templates
294
- - yolo: Toggle Yolo Mode
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-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
352
- - generate-ui-prompt: Create AI frontend generation 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-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
407
- - yolo: Toggle Yolo Mode
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 for architectural decisions
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
- - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
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
- - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
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 {checklist}: Show numbered list of checklists if not provided, execute task execute-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