bmad-method 4.44.0 → 4.44.2

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 (68) hide show
  1. package/.github/ISSUE_TEMPLATE/config.yml +5 -0
  2. package/.github/workflows/manual-release.yaml +1 -1
  3. package/PR-opencode-agents-generator.md +40 -0
  4. package/README.md +38 -44
  5. package/bmad-core/agents/analyst.md +1 -1
  6. package/bmad-core/agents/architect.md +1 -1
  7. package/bmad-core/agents/bmad-master.md +7 -7
  8. package/bmad-core/agents/bmad-orchestrator.md +2 -2
  9. package/bmad-core/agents/dev.md +1 -1
  10. package/bmad-core/agents/pm.md +1 -1
  11. package/bmad-core/agents/po.md +1 -1
  12. package/bmad-core/agents/qa.md +2 -6
  13. package/bmad-core/agents/sm.md +1 -1
  14. package/bmad-core/agents/ux-expert.md +1 -1
  15. package/bmad-core/checklists/po-master-checklist.md +3 -3
  16. package/bmad-core/data/bmad-kb.md +1 -1
  17. package/bmad-core/tasks/apply-qa-fixes.md +4 -4
  18. package/bmad-core/tasks/nfr-assess.md +3 -3
  19. package/bmad-core/tasks/qa-gate.md +2 -2
  20. package/bmad-core/tasks/review-story.md +1 -1
  21. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +6 -6
  22. package/dist/agents/analyst.txt +3 -11
  23. package/dist/agents/architect.txt +1 -7
  24. package/dist/agents/bmad-master.txt +7 -31
  25. package/dist/agents/bmad-orchestrator.txt +1 -8
  26. package/dist/agents/dev.txt +5 -10
  27. package/dist/agents/pm.txt +0 -10
  28. package/dist/agents/po.txt +4 -10
  29. package/dist/agents/qa.txt +7 -15
  30. package/dist/agents/sm.txt +0 -4
  31. package/dist/agents/ux-expert.txt +0 -4
  32. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -6
  33. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +0 -3
  34. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -3
  35. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +2 -25
  36. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +0 -9
  37. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -8
  38. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +1 -4
  39. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -4
  40. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +3 -35
  41. package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +0 -9
  42. package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +0 -8
  43. package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +0 -7
  44. package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +0 -8
  45. package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +0 -10
  46. package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +0 -8
  47. package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +0 -7
  48. package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +0 -9
  49. package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +0 -85
  50. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-developer.txt +2 -2
  51. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-qa.txt +1 -2
  52. package/dist/expansion-packs/bmad-godot-game-dev/teams/godot-game-team.txt +5 -6
  53. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -5
  54. package/dist/teams/team-all.txt +34 -69
  55. package/dist/teams/team-fullstack.txt +23 -46
  56. package/dist/teams/team-ide-minimal.txt +16 -42
  57. package/dist/teams/team-no-ui.txt +12 -34
  58. package/docs/user-guide.md +48 -1
  59. package/expansion-packs/bmad-godot-game-dev/agents/bmad-orchestrator.md +1 -1
  60. package/expansion-packs/bmad-godot-game-dev/agents/game-qa.md +1 -2
  61. package/expansion-packs/bmad-godot-game-dev/tasks/apply-qa-fixes.md +2 -2
  62. package/package.json +2 -1
  63. package/tools/installer/bin/bmad.js +46 -1
  64. package/tools/installer/config/install.config.yaml +18 -7
  65. package/tools/installer/lib/ide-setup.js +709 -77
  66. package/tools/installer/lib/installer.js +17 -4
  67. package/tools/installer/package.json +1 -1
  68. package/release_notes.md +0 -48
@@ -491,7 +491,6 @@ dependencies:
491
491
 
492
492
  ==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
493
493
  <!-- Powered by BMAD™ Core -->
494
-
495
494
  # Advanced Elicitation Task
496
495
 
497
496
  ## Purpose
@@ -613,7 +612,6 @@ Choose a number (0-8) or 9 to proceed:
613
612
 
614
613
  ==================== START: .bmad-core/tasks/create-doc.md ====================
615
614
  <!-- Powered by BMAD™ Core -->
616
-
617
615
  # Create Document from Template (YAML Driven)
618
616
 
619
617
  ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -719,7 +717,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
719
717
 
720
718
  ==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
721
719
  <!-- Powered by BMAD™ Core -->
722
-
723
720
  # KB Mode Interaction Task
724
721
 
725
722
  ## Purpose
@@ -799,7 +796,6 @@ Or ask me about anything else related to BMad-Method!
799
796
 
800
797
  ==================== START: .bmad-core/data/bmad-kb.md ====================
801
798
  <!-- Powered by BMAD™ Core -->
802
-
803
799
  # BMAD™ Knowledge Base
804
800
 
805
801
  ## Overview
@@ -902,7 +898,6 @@ npx bmad-method install
902
898
  - **Cline**: VS Code extension with AI features
903
899
  - **Roo Code**: Web-based IDE with agent support
904
900
  - **GitHub Copilot**: VS Code extension with AI peer programming assistant
905
- - **Auggie CLI (Augment Code)**: AI-powered development environment
906
901
 
907
902
  **Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
908
903
 
@@ -981,7 +976,7 @@ npx bmad-method install
981
976
 
982
977
  ## Core Configuration (core-config.yaml)
983
978
 
984
- **New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
979
+ **New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
985
980
 
986
981
  ### What is core-config.yaml?
987
982
 
@@ -1611,7 +1606,6 @@ Use the **expansion-creator** pack to build your own:
1611
1606
 
1612
1607
  ==================== START: .bmad-core/data/elicitation-methods.md ====================
1613
1608
  <!-- Powered by BMAD™ Core -->
1614
-
1615
1609
  # Elicitation Methods Data
1616
1610
 
1617
1611
  ## Core Reflective Methods
@@ -1770,7 +1764,6 @@ Use the **expansion-creator** pack to build your own:
1770
1764
 
1771
1765
  ==================== START: .bmad-core/utils/workflow-management.md ====================
1772
1766
  <!-- Powered by BMAD™ Core -->
1773
-
1774
1767
  # Workflow Management
1775
1768
 
1776
1769
  Enables BMad orchestrator to manage and execute team workflows.
@@ -1844,7 +1837,6 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
1844
1837
 
1845
1838
  ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
1846
1839
  <!-- Powered by BMAD™ Core -->
1847
-
1848
1840
  # Create Deep Research Prompt Task
1849
1841
 
1850
1842
  This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
@@ -2127,7 +2119,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
2127
2119
 
2128
2120
  ==================== START: .bmad-core/tasks/document-project.md ====================
2129
2121
  <!-- Powered by BMAD™ Core -->
2130
-
2131
2122
  # Document an Existing Project
2132
2123
 
2133
2124
  ## Purpose
@@ -2474,11 +2465,10 @@ Apply the advanced elicitation task after major sections to refine based on user
2474
2465
  ==================== END: .bmad-core/tasks/document-project.md ====================
2475
2466
 
2476
2467
  ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
2477
- ## <!-- Powered by BMAD™ Core -->
2478
-
2468
+ <!-- Powered by BMAD™ Core -->
2469
+ ---
2479
2470
  docOutputLocation: docs/brainstorming-session-results.md
2480
2471
  template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
2481
-
2482
2472
  ---
2483
2473
 
2484
2474
  # Facilitate Brainstorming Session Task
@@ -3566,7 +3556,6 @@ sections:
3566
3556
 
3567
3557
  ==================== START: .bmad-core/data/brainstorming-techniques.md ====================
3568
3558
  <!-- Powered by BMAD™ Core -->
3569
-
3570
3559
  # Brainstorming Techniques Data
3571
3560
 
3572
3561
  ## Creative Expansion
@@ -3607,7 +3596,6 @@ sections:
3607
3596
 
3608
3597
  ==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
3609
3598
  <!-- Powered by BMAD™ Core -->
3610
-
3611
3599
  # Create Brownfield Epic Task
3612
3600
 
3613
3601
  ## Purpose
@@ -3772,7 +3760,6 @@ The epic creation is successful when:
3772
3760
 
3773
3761
  ==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
3774
3762
  <!-- Powered by BMAD™ Core -->
3775
-
3776
3763
  # Create Brownfield Story Task
3777
3764
 
3778
3765
  ## Purpose
@@ -3924,7 +3911,6 @@ The story creation is successful when:
3924
3911
 
3925
3912
  ==================== START: .bmad-core/tasks/correct-course.md ====================
3926
3913
  <!-- Powered by BMAD™ Core -->
3927
-
3928
3914
  # Correct Course Task
3929
3915
 
3930
3916
  ## Purpose
@@ -3999,7 +3985,6 @@ The story creation is successful when:
3999
3985
 
4000
3986
  ==================== START: .bmad-core/tasks/execute-checklist.md ====================
4001
3987
  <!-- Powered by BMAD™ Core -->
4002
-
4003
3988
  # Checklist Validation Task
4004
3989
 
4005
3990
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -4090,7 +4075,6 @@ The LLM will:
4090
4075
 
4091
4076
  ==================== START: .bmad-core/tasks/shard-doc.md ====================
4092
4077
  <!-- Powered by BMAD™ Core -->
4093
-
4094
4078
  # Document Sharding Task
4095
4079
 
4096
4080
  ## Purpose
@@ -4770,7 +4754,6 @@ sections:
4770
4754
 
4771
4755
  ==================== START: .bmad-core/checklists/change-checklist.md ====================
4772
4756
  <!-- Powered by BMAD™ Core -->
4773
-
4774
4757
  # Change Navigation Checklist
4775
4758
 
4776
4759
  **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -4957,7 +4940,6 @@ Keep it action-oriented and forward-looking.]]
4957
4940
 
4958
4941
  ==================== START: .bmad-core/checklists/pm-checklist.md ====================
4959
4942
  <!-- Powered by BMAD™ Core -->
4960
-
4961
4943
  # Product Manager (PM) Requirements Checklist
4962
4944
 
4963
4945
  This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
@@ -5332,7 +5314,6 @@ After presenting the report, ask if the user wants:
5332
5314
 
5333
5315
  ==================== START: .bmad-core/data/technical-preferences.md ====================
5334
5316
  <!-- Powered by BMAD™ Core -->
5335
-
5336
5317
  # User-Defined Preferred Patterns and Preferences
5337
5318
 
5338
5319
  None Listed
@@ -5340,7 +5321,6 @@ None Listed
5340
5321
 
5341
5322
  ==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
5342
5323
  <!-- Powered by BMAD™ Core -->
5343
-
5344
5324
  # Create AI Frontend Prompt Task
5345
5325
 
5346
5326
  ## Purpose
@@ -6427,7 +6407,7 @@ sections:
6427
6407
  1. **Verify Complexity**: Confirm this enhancement requires architectural planning. For simple additions, recommend: "For simpler changes that don't require architectural planning, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead."
6428
6408
 
6429
6409
  2. **REQUIRED INPUTS**:
6430
- - Completed brownfield-prd.md
6410
+ - Completed prd.md
6431
6411
  - Existing project technical documentation (from docs folder or user-provided)
6432
6412
  - Access to existing project structure (IDE or uploaded files)
6433
6413
 
@@ -7932,7 +7912,6 @@ sections:
7932
7912
 
7933
7913
  ==================== START: .bmad-core/checklists/architect-checklist.md ====================
7934
7914
  <!-- Powered by BMAD™ Core -->
7935
-
7936
7915
  # Architect Solution Validation Checklist
7937
7916
 
7938
7917
  This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
@@ -8375,7 +8354,6 @@ After presenting the report, ask the user if they would like detailed analysis o
8375
8354
 
8376
8355
  ==================== START: .bmad-core/tasks/validate-next-story.md ====================
8377
8356
  <!-- Powered by BMAD™ Core -->
8378
-
8379
8357
  # Validate Next Story Task
8380
8358
 
8381
8359
  ## Purpose
@@ -8397,7 +8375,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
8397
8375
 
8398
8376
  ### 1. Template Completeness Validation
8399
8377
 
8400
- - Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
8378
+ - Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
8401
8379
  - **Missing sections check**: Compare story sections against template sections to verify all required sections are present
8402
8380
  - **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
8403
8381
  - **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -8655,7 +8633,6 @@ sections:
8655
8633
 
8656
8634
  ==================== START: .bmad-core/checklists/po-master-checklist.md ====================
8657
8635
  <!-- Powered by BMAD™ Core -->
8658
-
8659
8636
  # Product Owner (PO) Master Validation Checklist
8660
8637
 
8661
8638
  This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable.
@@ -8671,7 +8648,7 @@ First, determine the project type by checking:
8671
8648
 
8672
8649
  2. Is this a BROWNFIELD project (enhancing existing system)?
8673
8650
  - Look for: References to existing codebase, enhancement/modification language
8674
- - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
8651
+ - Check for: prd.md, architecture.md, existing system analysis
8675
8652
 
8676
8653
  3. Does the project include UI/UX components?
8677
8654
  - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -8689,8 +8666,8 @@ For GREENFIELD projects:
8689
8666
 
8690
8667
  For BROWNFIELD projects:
8691
8668
 
8692
- - brownfield-prd.md - The brownfield enhancement requirements
8693
- - brownfield-architecture.md - The enhancement architecture
8669
+ - prd.md - The brownfield enhancement requirements
8670
+ - architecture.md - The enhancement architecture
8694
8671
  - Existing project codebase access (CRITICAL - cannot proceed without this)
8695
8672
  - Current deployment configuration and infrastructure details
8696
8673
  - Database schemas, API documentation, monitoring setup
@@ -9253,7 +9230,7 @@ workflow:
9253
9230
  - Dev Agent (New Chat): Address remaining items
9254
9231
  - Return to QA for final approval
9255
9232
 
9256
- - step: repeat_development_cycle
9233
+ - repeat_development_cycle:
9257
9234
  action: continue_for_all_stories
9258
9235
  notes: |
9259
9236
  Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -9270,7 +9247,7 @@ workflow:
9270
9247
  - Validate epic was completed correctly
9271
9248
  - Document learnings and improvements
9272
9249
 
9273
- - step: workflow_end
9250
+ - workflow_end:
9274
9251
  action: project_complete
9275
9252
  notes: |
9276
9253
  All stories implemented and reviewed!
@@ -9500,7 +9477,7 @@ workflow:
9500
9477
  - Dev Agent (New Chat): Address remaining items
9501
9478
  - Return to QA for final approval
9502
9479
 
9503
- - step: repeat_development_cycle
9480
+ - repeat_development_cycle:
9504
9481
  action: continue_for_all_stories
9505
9482
  notes: |
9506
9483
  Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -9517,7 +9494,7 @@ workflow:
9517
9494
  - Validate epic was completed correctly
9518
9495
  - Document learnings and improvements
9519
9496
 
9520
- - step: workflow_end
9497
+ - workflow_end:
9521
9498
  action: project_complete
9522
9499
  notes: |
9523
9500
  All stories implemented and reviewed!
@@ -9698,7 +9675,7 @@ workflow:
9698
9675
  - Dev Agent (New Chat): Address remaining items
9699
9676
  - Return to QA for final approval
9700
9677
 
9701
- - step: repeat_development_cycle
9678
+ - repeat_development_cycle:
9702
9679
  action: continue_for_all_stories
9703
9680
  notes: |
9704
9681
  Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -9715,7 +9692,7 @@ workflow:
9715
9692
  - Validate epic was completed correctly
9716
9693
  - Document learnings and improvements
9717
9694
 
9718
- - step: workflow_end
9695
+ - workflow_end:
9719
9696
  action: project_complete
9720
9697
  notes: |
9721
9698
  All stories implemented and reviewed!
@@ -9851,12 +9828,12 @@ workflow:
9851
9828
  condition: po_checklist_issues
9852
9829
  notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
9853
9830
 
9854
- - step: project_setup_guidance
9831
+ - project_setup_guidance:
9855
9832
  action: guide_project_structure
9856
9833
  condition: user_has_generated_ui
9857
9834
  notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo alongside backend repo. For monorepo, place in apps/web or packages/frontend directory. Review architecture document for specific guidance."
9858
9835
 
9859
- - step: development_order_guidance
9836
+ - development_order_guidance:
9860
9837
  action: guide_development_sequence
9861
9838
  notes: "Based on PRD stories: If stories are frontend-heavy, start with frontend project/directory first. If backend-heavy or API-first, start with backend. For tightly coupled features, follow story sequence in monorepo setup. Reference sharded PRD epics for development order."
9862
9839
 
@@ -9924,7 +9901,7 @@ workflow:
9924
9901
  - Dev Agent (New Chat): Address remaining items
9925
9902
  - Return to QA for final approval
9926
9903
 
9927
- - step: repeat_development_cycle
9904
+ - repeat_development_cycle:
9928
9905
  action: continue_for_all_stories
9929
9906
  notes: |
9930
9907
  Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -9941,7 +9918,7 @@ workflow:
9941
9918
  - Validate epic was completed correctly
9942
9919
  - Document learnings and improvements
9943
9920
 
9944
- - step: workflow_end
9921
+ - workflow_end:
9945
9922
  action: project_complete
9946
9923
  notes: |
9947
9924
  All stories implemented and reviewed!
@@ -10144,7 +10121,7 @@ workflow:
10144
10121
  - Dev Agent (New Chat): Address remaining items
10145
10122
  - Return to QA for final approval
10146
10123
 
10147
- - step: repeat_development_cycle
10124
+ - repeat_development_cycle:
10148
10125
  action: continue_for_all_stories
10149
10126
  notes: |
10150
10127
  Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -10161,7 +10138,7 @@ workflow:
10161
10138
  - Validate epic was completed correctly
10162
10139
  - Document learnings and improvements
10163
10140
 
10164
- - step: workflow_end
10141
+ - workflow_end:
10165
10142
  action: project_complete
10166
10143
  notes: |
10167
10144
  All stories implemented and reviewed!
@@ -10304,7 +10281,7 @@ workflow:
10304
10281
  condition: po_checklist_issues
10305
10282
  notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
10306
10283
 
10307
- - step: project_setup_guidance
10284
+ - project_setup_guidance:
10308
10285
  action: guide_project_structure
10309
10286
  condition: user_has_generated_ui
10310
10287
  notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo. For monorepo, place in apps/web or frontend/ directory. Review architecture document for specific guidance."
@@ -10373,7 +10350,7 @@ workflow:
10373
10350
  - Dev Agent (New Chat): Address remaining items
10374
10351
  - Return to QA for final approval
10375
10352
 
10376
- - step: repeat_development_cycle
10353
+ - repeat_development_cycle:
10377
10354
  action: continue_for_all_stories
10378
10355
  notes: |
10379
10356
  Repeat story cycle (SM → Dev → QA) for all epic stories
@@ -10390,7 +10367,7 @@ workflow:
10390
10367
  - Validate epic was completed correctly
10391
10368
  - Document learnings and improvements
10392
10369
 
10393
- - step: workflow_end
10370
+ - workflow_end:
10394
10371
  action: project_complete
10395
10372
  notes: |
10396
10373
  All stories implemented and reviewed!
@@ -309,7 +309,6 @@ persona:
309
309
  focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
310
310
  core_principles:
311
311
  - CRITICAL: Story has ALL info you will need aside from what you loaded during the startup commands. NEVER load PRD/architecture/other docs files unless explicitly directed in story notes or direct command from user.
312
- - CRITICAL: ALWAYS check current folder structure before starting your story tasks, don't create new working directory if it already exists. Create new one when you're sure it's a brand new project.
313
312
  - CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
314
313
  - CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
315
314
  - Numbered Options - Always use numbered lists when presenting choices to the user
@@ -354,8 +353,7 @@ agent:
354
353
  id: qa
355
354
  title: Test Architect & Quality Advisor
356
355
  icon: 🧪
357
- whenToUse: |
358
- Use for comprehensive test architecture review, quality gate decisions,
356
+ whenToUse: Use for comprehensive test architecture review, quality gate decisions,
359
357
  and code improvement. Provides thorough analysis including requirements
360
358
  traceability, risk assessment, and test strategy.
361
359
  Advisory only - teams choose their quality bar.
@@ -411,7 +409,6 @@ dependencies:
411
409
 
412
410
  ==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
413
411
  <!-- Powered by BMAD™ Core -->
414
-
415
412
  # Advanced Elicitation Task
416
413
 
417
414
  ## Purpose
@@ -533,7 +530,6 @@ Choose a number (0-8) or 9 to proceed:
533
530
 
534
531
  ==================== START: .bmad-core/tasks/create-doc.md ====================
535
532
  <!-- Powered by BMAD™ Core -->
536
-
537
533
  # Create Document from Template (YAML Driven)
538
534
 
539
535
  ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -639,7 +635,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
639
635
 
640
636
  ==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
641
637
  <!-- Powered by BMAD™ Core -->
642
-
643
638
  # KB Mode Interaction Task
644
639
 
645
640
  ## Purpose
@@ -719,7 +714,6 @@ Or ask me about anything else related to BMad-Method!
719
714
 
720
715
  ==================== START: .bmad-core/data/bmad-kb.md ====================
721
716
  <!-- Powered by BMAD™ Core -->
722
-
723
717
  # BMAD™ Knowledge Base
724
718
 
725
719
  ## Overview
@@ -822,7 +816,6 @@ npx bmad-method install
822
816
  - **Cline**: VS Code extension with AI features
823
817
  - **Roo Code**: Web-based IDE with agent support
824
818
  - **GitHub Copilot**: VS Code extension with AI peer programming assistant
825
- - **Auggie CLI (Augment Code)**: AI-powered development environment
826
819
 
827
820
  **Note for VS Code Users**: BMAD-METHOD™ assumes when you mention "VS Code" that you're using it with an AI-powered extension like GitHub Copilot, Cline, or Roo. Standard VS Code without AI capabilities cannot run BMad agents. The installer includes built-in support for Cline and Roo.
828
821
 
@@ -901,7 +894,7 @@ npx bmad-method install
901
894
 
902
895
  ## Core Configuration (core-config.yaml)
903
896
 
904
- **New in V4**: The `bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
897
+ **New in V4**: The `.bmad-core/core-config.yaml` file is a critical innovation that enables BMad to work seamlessly with any project structure, providing maximum flexibility and backwards compatibility.
905
898
 
906
899
  ### What is core-config.yaml?
907
900
 
@@ -1531,7 +1524,6 @@ Use the **expansion-creator** pack to build your own:
1531
1524
 
1532
1525
  ==================== START: .bmad-core/data/elicitation-methods.md ====================
1533
1526
  <!-- Powered by BMAD™ Core -->
1534
-
1535
1527
  # Elicitation Methods Data
1536
1528
 
1537
1529
  ## Core Reflective Methods
@@ -1690,7 +1682,6 @@ Use the **expansion-creator** pack to build your own:
1690
1682
 
1691
1683
  ==================== START: .bmad-core/utils/workflow-management.md ====================
1692
1684
  <!-- Powered by BMAD™ Core -->
1693
-
1694
1685
  # Workflow Management
1695
1686
 
1696
1687
  Enables BMad orchestrator to manage and execute team workflows.
@@ -1764,7 +1755,6 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
1764
1755
 
1765
1756
  ==================== START: .bmad-core/tasks/correct-course.md ====================
1766
1757
  <!-- Powered by BMAD™ Core -->
1767
-
1768
1758
  # Correct Course Task
1769
1759
 
1770
1760
  ## Purpose
@@ -1839,7 +1829,6 @@ Agents should be workflow-aware: know active workflow, their role, access artifa
1839
1829
 
1840
1830
  ==================== START: .bmad-core/tasks/execute-checklist.md ====================
1841
1831
  <!-- Powered by BMAD™ Core -->
1842
-
1843
1832
  # Checklist Validation Task
1844
1833
 
1845
1834
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -1930,7 +1919,6 @@ The LLM will:
1930
1919
 
1931
1920
  ==================== START: .bmad-core/tasks/shard-doc.md ====================
1932
1921
  <!-- Powered by BMAD™ Core -->
1933
-
1934
1922
  # Document Sharding Task
1935
1923
 
1936
1924
  ## Purpose
@@ -2120,7 +2108,6 @@ Document sharded successfully:
2120
2108
 
2121
2109
  ==================== START: .bmad-core/tasks/validate-next-story.md ====================
2122
2110
  <!-- Powered by BMAD™ Core -->
2123
-
2124
2111
  # Validate Next Story Task
2125
2112
 
2126
2113
  ## Purpose
@@ -2142,7 +2129,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
2142
2129
 
2143
2130
  ### 1. Template Completeness Validation
2144
2131
 
2145
- - Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
2132
+ - Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
2146
2133
  - **Missing sections check**: Compare story sections against template sections to verify all required sections are present
2147
2134
  - **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
2148
2135
  - **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -2400,7 +2387,6 @@ sections:
2400
2387
 
2401
2388
  ==================== START: .bmad-core/checklists/change-checklist.md ====================
2402
2389
  <!-- Powered by BMAD™ Core -->
2403
-
2404
2390
  # Change Navigation Checklist
2405
2391
 
2406
2392
  **Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
@@ -2587,7 +2573,6 @@ Keep it action-oriented and forward-looking.]]
2587
2573
 
2588
2574
  ==================== START: .bmad-core/checklists/po-master-checklist.md ====================
2589
2575
  <!-- Powered by BMAD™ Core -->
2590
-
2591
2576
  # Product Owner (PO) Master Validation Checklist
2592
2577
 
2593
2578
  This checklist serves as a comprehensive framework for the Product Owner to validate project plans before development execution. It adapts intelligently based on project type (greenfield vs brownfield) and includes UI/UX considerations when applicable.
@@ -2603,7 +2588,7 @@ First, determine the project type by checking:
2603
2588
 
2604
2589
  2. Is this a BROWNFIELD project (enhancing existing system)?
2605
2590
  - Look for: References to existing codebase, enhancement/modification language
2606
- - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
2591
+ - Check for: prd.md, architecture.md, existing system analysis
2607
2592
 
2608
2593
  3. Does the project include UI/UX components?
2609
2594
  - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -2621,8 +2606,8 @@ For GREENFIELD projects:
2621
2606
 
2622
2607
  For BROWNFIELD projects:
2623
2608
 
2624
- - brownfield-prd.md - The brownfield enhancement requirements
2625
- - brownfield-architecture.md - The enhancement architecture
2609
+ - prd.md - The brownfield enhancement requirements
2610
+ - architecture.md - The enhancement architecture
2626
2611
  - Existing project codebase access (CRITICAL - cannot proceed without this)
2627
2612
  - Current deployment configuration and infrastructure details
2628
2613
  - Database schemas, API documentation, monitoring setup
@@ -3024,7 +3009,6 @@ After presenting the report, ask if the user wants:
3024
3009
 
3025
3010
  ==================== START: .bmad-core/tasks/create-next-story.md ====================
3026
3011
  <!-- Powered by BMAD™ Core -->
3027
-
3028
3012
  # Create Next Story Task
3029
3013
 
3030
3014
  ## Purpose
@@ -3141,7 +3125,6 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
3141
3125
 
3142
3126
  ==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
3143
3127
  <!-- Powered by BMAD™ Core -->
3144
-
3145
3128
  # Story Draft Checklist
3146
3129
 
3147
3130
  The Scrum Master should use this checklist to validate that each story contains sufficient context for a developer agent to implement it successfully, while assuming the dev agent has reasonable capabilities to figure things out.
@@ -3299,7 +3282,6 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
3299
3282
 
3300
3283
  ==================== START: .bmad-core/tasks/apply-qa-fixes.md ====================
3301
3284
  <!-- Powered by BMAD™ Core -->
3302
-
3303
3285
  # apply-qa-fixes
3304
3286
 
3305
3287
  Implement fixes based on QA results (gate and assessments) for a specific story. This task is for the Dev agent to systematically consume QA outputs and apply code/test changes while only updating allowed sections in the story file.
@@ -3316,8 +3298,8 @@ Implement fixes based on QA results (gate and assessments) for a specific story.
3316
3298
  ```yaml
3317
3299
  required:
3318
3300
  - story_id: '{epic}.{story}' # e.g., "2.2"
3319
- - qa_root: from `bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
3320
- - story_root: from `bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
3301
+ - qa_root: from `.bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
3302
+ - story_root: from `.bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
3321
3303
 
3322
3304
  optional:
3323
3305
  - story_title: '{title}' # derive from story H1 if missing
@@ -3345,7 +3327,7 @@ optional:
3345
3327
 
3346
3328
  ### 0) Load Core Config & Locate Story
3347
3329
 
3348
- - Read `bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
3330
+ - Read `.bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
3349
3331
  - Locate story file in `{story_root}/{epic}.{story}.*.md`
3350
3332
  - HALT if missing and ask for correct story id/path
3351
3333
 
@@ -3413,7 +3395,7 @@ Status Rule:
3413
3395
 
3414
3396
  ## Blocking Conditions
3415
3397
 
3416
- - Missing `bmad-core/core-config.yaml`
3398
+ - Missing `.bmad-core/core-config.yaml`
3417
3399
  - Story file not found for `story_id`
3418
3400
  - No QA artifacts found (neither gate nor assessments)
3419
3401
  - HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)
@@ -3452,7 +3434,6 @@ Fix plan:
3452
3434
 
3453
3435
  ==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
3454
3436
  <!-- Powered by BMAD™ Core -->
3455
-
3456
3437
  # Story Definition of Done (DoD) Checklist
3457
3438
 
3458
3439
  ## Instructions for Developer Agent
@@ -3551,7 +3532,6 @@ Be honest - it's better to flag issues now than have them discovered later.]]
3551
3532
 
3552
3533
  ==================== START: .bmad-core/tasks/nfr-assess.md ====================
3553
3534
  <!-- Powered by BMAD™ Core -->
3554
-
3555
3535
  # nfr-assess
3556
3536
 
3557
3537
  Quick NFR validation focused on the core four: security, performance, reliability, maintainability.
@@ -3561,11 +3541,11 @@ Quick NFR validation focused on the core four: security, performance, reliabilit
3561
3541
  ```yaml
3562
3542
  required:
3563
3543
  - story_id: '{epic}.{story}' # e.g., "1.3"
3564
- - story_path: `bmad-core/core-config.yaml` for the `devStoryLocation`
3544
+ - story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
3565
3545
 
3566
3546
  optional:
3567
- - architecture_refs: `bmad-core/core-config.yaml` for the `architecture.architectureFile`
3568
- - technical_preferences: `bmad-core/core-config.yaml` for the `technicalPreferences`
3547
+ - architecture_refs: `.bmad-core/core-config.yaml` for the `architecture.architectureFile`
3548
+ - technical_preferences: `.bmad-core/core-config.yaml` for the `technicalPreferences`
3569
3549
  - acceptance_criteria: From story file
3570
3550
  ```
3571
3551
 
@@ -3899,7 +3879,6 @@ performance_deep_dive:
3899
3879
 
3900
3880
  ==================== START: .bmad-core/tasks/qa-gate.md ====================
3901
3881
  <!-- Powered by BMAD™ Core -->
3902
-
3903
3882
  # qa-gate
3904
3883
 
3905
3884
  Create or update a quality gate decision file for a story based on review findings.
@@ -3916,7 +3895,7 @@ Generate a standalone quality gate file that provides a clear pass/fail decision
3916
3895
 
3917
3896
  ## Gate File Location
3918
3897
 
3919
- **ALWAYS** check the `bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
3898
+ **ALWAYS** check the `.bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
3920
3899
 
3921
3900
  Slug rules:
3922
3901
 
@@ -4026,7 +4005,7 @@ waiver:
4026
4005
 
4027
4006
  ## Output Requirements
4028
4007
 
4029
- 1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `bmad-core/core-config.yaml`
4008
+ 1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `.bmad-core/core-config.yaml`
4030
4009
  2. **ALWAYS** append this exact format to story's QA Results section:
4031
4010
 
4032
4011
  ```text
@@ -4065,7 +4044,6 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml
4065
4044
 
4066
4045
  ==================== START: .bmad-core/tasks/review-story.md ====================
4067
4046
  <!-- Powered by BMAD™ Core -->
4068
-
4069
4047
  # review-story
4070
4048
 
4071
4049
  Perform a comprehensive test architecture review with quality gate decision. This adaptive, risk-aware review creates both a story update and a detailed gate file.
@@ -4252,7 +4230,7 @@ NFR assessment: qa.qaLocation/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
4252
4230
  **Template and Directory:**
4253
4231
 
4254
4232
  - Render from `../templates/qa-gate-tmpl.yaml`
4255
- - Create directory defined in `qa.qaLocation/gates` (see `bmad-core/core-config.yaml`) if missing
4233
+ - Create directory defined in `qa.qaLocation/gates` (see `.bmad-core/core-config.yaml`) if missing
4256
4234
  - Save to: `qa.qaLocation/gates/{epic}.{story}-{slug}.yml`
4257
4235
 
4258
4236
  Gate file structure:
@@ -4384,7 +4362,6 @@ After review:
4384
4362
 
4385
4363
  ==================== START: .bmad-core/tasks/risk-profile.md ====================
4386
4364
  <!-- Powered by BMAD™ Core -->
4387
-
4388
4365
  # risk-profile
4389
4366
 
4390
4367
  Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis.
@@ -4742,7 +4719,6 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
4742
4719
 
4743
4720
  ==================== START: .bmad-core/tasks/test-design.md ====================
4744
4721
  <!-- Powered by BMAD™ Core -->
4745
-
4746
4722
  # test-design
4747
4723
 
4748
4724
  Create comprehensive test scenarios with appropriate test level recommendations for story implementation.
@@ -4921,7 +4897,6 @@ Before finalizing, verify:
4921
4897
 
4922
4898
  ==================== START: .bmad-core/tasks/trace-requirements.md ====================
4923
4899
  <!-- Powered by BMAD™ Core -->
4924
-
4925
4900
  # trace-requirements
4926
4901
 
4927
4902
  Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability.
@@ -5296,7 +5271,6 @@ optional_fields_examples:
5296
5271
 
5297
5272
  ==================== START: .bmad-core/data/technical-preferences.md ====================
5298
5273
  <!-- Powered by BMAD™ Core -->
5299
-
5300
5274
  # User-Defined Preferred Patterns and Preferences
5301
5275
 
5302
5276
  None Listed