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
@@ -128,7 +128,6 @@ dependencies:
128
128
 
129
129
  ==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
130
130
  <!-- Powered by BMAD™ Core -->
131
-
132
131
  # Advanced Elicitation Task
133
132
 
134
133
  ## Purpose
@@ -250,7 +249,6 @@ Choose a number (0-8) or 9 to proceed:
250
249
 
251
250
  ==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
252
251
  <!-- Powered by BMAD™ Core -->
253
-
254
252
  # Create Brownfield Epic Task
255
253
 
256
254
  ## Purpose
@@ -415,7 +413,6 @@ The epic creation is successful when:
415
413
 
416
414
  ==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
417
415
  <!-- Powered by BMAD™ Core -->
418
-
419
416
  # Create Brownfield Story Task
420
417
 
421
418
  ## Purpose
@@ -567,7 +564,6 @@ The story creation is successful when:
567
564
 
568
565
  ==================== START: .bmad-core/tasks/correct-course.md ====================
569
566
  <!-- Powered by BMAD™ Core -->
570
-
571
567
  # Correct Course Task
572
568
 
573
569
  ## Purpose
@@ -642,7 +638,6 @@ The story creation is successful when:
642
638
 
643
639
  ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
644
640
  <!-- Powered by BMAD™ Core -->
645
-
646
641
  # Create Deep Research Prompt Task
647
642
 
648
643
  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.
@@ -925,7 +920,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
925
920
 
926
921
  ==================== START: .bmad-core/tasks/create-doc.md ====================
927
922
  <!-- Powered by BMAD™ Core -->
928
-
929
923
  # Create Document from Template (YAML Driven)
930
924
 
931
925
  ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -1031,7 +1025,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
1031
1025
 
1032
1026
  ==================== START: .bmad-core/tasks/create-next-story.md ====================
1033
1027
  <!-- Powered by BMAD™ Core -->
1034
-
1035
1028
  # Create Next Story Task
1036
1029
 
1037
1030
  ## Purpose
@@ -1148,7 +1141,6 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
1148
1141
 
1149
1142
  ==================== START: .bmad-core/tasks/document-project.md ====================
1150
1143
  <!-- Powered by BMAD™ Core -->
1151
-
1152
1144
  # Document an Existing Project
1153
1145
 
1154
1146
  ## Purpose
@@ -1496,7 +1488,6 @@ Apply the advanced elicitation task after major sections to refine based on user
1496
1488
 
1497
1489
  ==================== START: .bmad-core/tasks/execute-checklist.md ====================
1498
1490
  <!-- Powered by BMAD™ Core -->
1499
-
1500
1491
  # Checklist Validation Task
1501
1492
 
1502
1493
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -1586,11 +1577,10 @@ The LLM will:
1586
1577
  ==================== END: .bmad-core/tasks/execute-checklist.md ====================
1587
1578
 
1588
1579
  ==================== START: .bmad-core/tasks/facilitate-brainstorming-session.md ====================
1589
- ## <!-- Powered by BMAD™ Core -->
1590
-
1580
+ <!-- Powered by BMAD™ Core -->
1581
+ ---
1591
1582
  docOutputLocation: docs/brainstorming-session-results.md
1592
1583
  template: '.bmad-core/templates/brainstorming-output-tmpl.yaml'
1593
-
1594
1584
  ---
1595
1585
 
1596
1586
  # Facilitate Brainstorming Session Task
@@ -1728,7 +1718,6 @@ Generate structured document with these sections:
1728
1718
 
1729
1719
  ==================== START: .bmad-core/tasks/generate-ai-frontend-prompt.md ====================
1730
1720
  <!-- Powered by BMAD™ Core -->
1731
-
1732
1721
  # Create AI Frontend Prompt Task
1733
1722
 
1734
1723
  ## Purpose
@@ -1784,7 +1773,6 @@ You will now synthesize the inputs and the above principles into a final, compre
1784
1773
 
1785
1774
  ==================== START: .bmad-core/tasks/index-docs.md ====================
1786
1775
  <!-- Powered by BMAD™ Core -->
1787
-
1788
1776
  # Index Documentation Task
1789
1777
 
1790
1778
  ## Purpose
@@ -1962,7 +1950,6 @@ Would you like to proceed with documentation indexing? Please provide the requir
1962
1950
 
1963
1951
  ==================== START: .bmad-core/tasks/shard-doc.md ====================
1964
1952
  <!-- Powered by BMAD™ Core -->
1965
-
1966
1953
  # Document Sharding Task
1967
1954
 
1968
1955
  ## Purpose
@@ -2830,7 +2817,7 @@ sections:
2830
2817
  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."
2831
2818
 
2832
2819
  2. **REQUIRED INPUTS**:
2833
- - Completed brownfield-prd.md
2820
+ - Completed prd.md
2834
2821
  - Existing project technical documentation (from docs folder or user-provided)
2835
2822
  - Access to existing project structure (IDE or uploaded files)
2836
2823
 
@@ -6110,7 +6097,6 @@ sections:
6110
6097
 
6111
6098
  ==================== START: .bmad-core/checklists/architect-checklist.md ====================
6112
6099
  <!-- Powered by BMAD™ Core -->
6113
-
6114
6100
  # Architect Solution Validation Checklist
6115
6101
 
6116
6102
  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.
@@ -6553,7 +6539,6 @@ After presenting the report, ask the user if they would like detailed analysis o
6553
6539
 
6554
6540
  ==================== START: .bmad-core/checklists/change-checklist.md ====================
6555
6541
  <!-- Powered by BMAD™ Core -->
6556
-
6557
6542
  # Change Navigation Checklist
6558
6543
 
6559
6544
  **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.
@@ -6740,7 +6725,6 @@ Keep it action-oriented and forward-looking.]]
6740
6725
 
6741
6726
  ==================== START: .bmad-core/checklists/pm-checklist.md ====================
6742
6727
  <!-- Powered by BMAD™ Core -->
6743
-
6744
6728
  # Product Manager (PM) Requirements Checklist
6745
6729
 
6746
6730
  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.
@@ -7115,7 +7099,6 @@ After presenting the report, ask if the user wants:
7115
7099
 
7116
7100
  ==================== START: .bmad-core/checklists/po-master-checklist.md ====================
7117
7101
  <!-- Powered by BMAD™ Core -->
7118
-
7119
7102
  # Product Owner (PO) Master Validation Checklist
7120
7103
 
7121
7104
  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.
@@ -7131,7 +7114,7 @@ First, determine the project type by checking:
7131
7114
 
7132
7115
  2. Is this a BROWNFIELD project (enhancing existing system)?
7133
7116
  - Look for: References to existing codebase, enhancement/modification language
7134
- - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
7117
+ - Check for: prd.md, architecture.md, existing system analysis
7135
7118
 
7136
7119
  3. Does the project include UI/UX components?
7137
7120
  - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -7149,8 +7132,8 @@ For GREENFIELD projects:
7149
7132
 
7150
7133
  For BROWNFIELD projects:
7151
7134
 
7152
- - brownfield-prd.md - The brownfield enhancement requirements
7153
- - brownfield-architecture.md - The enhancement architecture
7135
+ - prd.md - The brownfield enhancement requirements
7136
+ - architecture.md - The enhancement architecture
7154
7137
  - Existing project codebase access (CRITICAL - cannot proceed without this)
7155
7138
  - Current deployment configuration and infrastructure details
7156
7139
  - Database schemas, API documentation, monitoring setup
@@ -7552,7 +7535,6 @@ After presenting the report, ask if the user wants:
7552
7535
 
7553
7536
  ==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
7554
7537
  <!-- Powered by BMAD™ Core -->
7555
-
7556
7538
  # Story Definition of Done (DoD) Checklist
7557
7539
 
7558
7540
  ## Instructions for Developer Agent
@@ -7651,7 +7633,6 @@ Be honest - it's better to flag issues now than have them discovered later.]]
7651
7633
 
7652
7634
  ==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
7653
7635
  <!-- Powered by BMAD™ Core -->
7654
-
7655
7636
  # Story Draft Checklist
7656
7637
 
7657
7638
  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.
@@ -7809,7 +7790,6 @@ Be pragmatic - perfect documentation doesn't exist, but it must be enough to pro
7809
7790
 
7810
7791
  ==================== START: .bmad-core/data/bmad-kb.md ====================
7811
7792
  <!-- Powered by BMAD™ Core -->
7812
-
7813
7793
  # BMAD™ Knowledge Base
7814
7794
 
7815
7795
  ## Overview
@@ -7912,7 +7892,6 @@ npx bmad-method install
7912
7892
  - **Cline**: VS Code extension with AI features
7913
7893
  - **Roo Code**: Web-based IDE with agent support
7914
7894
  - **GitHub Copilot**: VS Code extension with AI peer programming assistant
7915
- - **Auggie CLI (Augment Code)**: AI-powered development environment
7916
7895
 
7917
7896
  **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.
7918
7897
 
@@ -7991,7 +7970,7 @@ npx bmad-method install
7991
7970
 
7992
7971
  ## Core Configuration (core-config.yaml)
7993
7972
 
7994
- **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.
7973
+ **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.
7995
7974
 
7996
7975
  ### What is core-config.yaml?
7997
7976
 
@@ -8621,7 +8600,6 @@ Use the **expansion-creator** pack to build your own:
8621
8600
 
8622
8601
  ==================== START: .bmad-core/data/brainstorming-techniques.md ====================
8623
8602
  <!-- Powered by BMAD™ Core -->
8624
-
8625
8603
  # Brainstorming Techniques Data
8626
8604
 
8627
8605
  ## Creative Expansion
@@ -8662,7 +8640,6 @@ Use the **expansion-creator** pack to build your own:
8662
8640
 
8663
8641
  ==================== START: .bmad-core/data/elicitation-methods.md ====================
8664
8642
  <!-- Powered by BMAD™ Core -->
8665
-
8666
8643
  # Elicitation Methods Data
8667
8644
 
8668
8645
  ## Core Reflective Methods
@@ -8821,7 +8798,6 @@ Use the **expansion-creator** pack to build your own:
8821
8798
 
8822
8799
  ==================== START: .bmad-core/data/technical-preferences.md ====================
8823
8800
  <!-- Powered by BMAD™ Core -->
8824
-
8825
8801
  # User-Defined Preferred Patterns and Preferences
8826
8802
 
8827
8803
  None Listed
@@ -168,7 +168,6 @@ dependencies:
168
168
 
169
169
  ==================== START: .bmad-core/tasks/advanced-elicitation.md ====================
170
170
  <!-- Powered by BMAD™ Core -->
171
-
172
171
  # Advanced Elicitation Task
173
172
 
174
173
  ## Purpose
@@ -290,7 +289,6 @@ Choose a number (0-8) or 9 to proceed:
290
289
 
291
290
  ==================== START: .bmad-core/tasks/create-doc.md ====================
292
291
  <!-- Powered by BMAD™ Core -->
293
-
294
292
  # Create Document from Template (YAML Driven)
295
293
 
296
294
  ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -396,7 +394,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
396
394
 
397
395
  ==================== START: .bmad-core/tasks/kb-mode-interaction.md ====================
398
396
  <!-- Powered by BMAD™ Core -->
399
-
400
397
  # KB Mode Interaction Task
401
398
 
402
399
  ## Purpose
@@ -476,7 +473,6 @@ Or ask me about anything else related to BMad-Method!
476
473
 
477
474
  ==================== START: .bmad-core/data/bmad-kb.md ====================
478
475
  <!-- Powered by BMAD™ Core -->
479
-
480
476
  # BMAD™ Knowledge Base
481
477
 
482
478
  ## Overview
@@ -579,7 +575,6 @@ npx bmad-method install
579
575
  - **Cline**: VS Code extension with AI features
580
576
  - **Roo Code**: Web-based IDE with agent support
581
577
  - **GitHub Copilot**: VS Code extension with AI peer programming assistant
582
- - **Auggie CLI (Augment Code)**: AI-powered development environment
583
578
 
584
579
  **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.
585
580
 
@@ -658,7 +653,7 @@ npx bmad-method install
658
653
 
659
654
  ## Core Configuration (core-config.yaml)
660
655
 
661
- **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.
656
+ **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.
662
657
 
663
658
  ### What is core-config.yaml?
664
659
 
@@ -1288,7 +1283,6 @@ Use the **expansion-creator** pack to build your own:
1288
1283
 
1289
1284
  ==================== START: .bmad-core/data/elicitation-methods.md ====================
1290
1285
  <!-- Powered by BMAD™ Core -->
1291
-
1292
1286
  # Elicitation Methods Data
1293
1287
 
1294
1288
  ## Core Reflective Methods
@@ -1447,7 +1441,6 @@ Use the **expansion-creator** pack to build your own:
1447
1441
 
1448
1442
  ==================== START: .bmad-core/utils/workflow-management.md ====================
1449
1443
  <!-- Powered by BMAD™ Core -->
1450
-
1451
1444
  # Workflow Management
1452
1445
 
1453
1446
  Enables BMad orchestrator to manage and execute team workflows.
@@ -64,7 +64,6 @@ persona:
64
64
  focus: Executing story tasks with precision, updating Dev Agent Record sections only, maintaining minimal context overhead
65
65
  core_principles:
66
66
  - 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.
67
- - 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.
68
67
  - CRITICAL: ONLY update story file Dev Agent Record sections (checkboxes/Debug Log/Completion Notes/Change Log)
69
68
  - CRITICAL: FOLLOW THE develop-story command when the user tells you to implement the story
70
69
  - Numbered Options - Always use numbered lists when presenting choices to the user
@@ -95,7 +94,6 @@ dependencies:
95
94
 
96
95
  ==================== START: .bmad-core/tasks/apply-qa-fixes.md ====================
97
96
  <!-- Powered by BMAD™ Core -->
98
-
99
97
  # apply-qa-fixes
100
98
 
101
99
  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.
@@ -112,8 +110,8 @@ Implement fixes based on QA results (gate and assessments) for a specific story.
112
110
  ```yaml
113
111
  required:
114
112
  - story_id: '{epic}.{story}' # e.g., "2.2"
115
- - qa_root: from `bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
116
- - story_root: from `bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
113
+ - qa_root: from `.bmad-core/core-config.yaml` key `qa.qaLocation` (e.g., `docs/project/qa`)
114
+ - story_root: from `.bmad-core/core-config.yaml` key `devStoryLocation` (e.g., `docs/project/stories`)
117
115
 
118
116
  optional:
119
117
  - story_title: '{title}' # derive from story H1 if missing
@@ -141,7 +139,7 @@ optional:
141
139
 
142
140
  ### 0) Load Core Config & Locate Story
143
141
 
144
- - Read `bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
142
+ - Read `.bmad-core/core-config.yaml` and resolve `qa_root` and `story_root`
145
143
  - Locate story file in `{story_root}/{epic}.{story}.*.md`
146
144
  - HALT if missing and ask for correct story id/path
147
145
 
@@ -209,7 +207,7 @@ Status Rule:
209
207
 
210
208
  ## Blocking Conditions
211
209
 
212
- - Missing `bmad-core/core-config.yaml`
210
+ - Missing `.bmad-core/core-config.yaml`
213
211
  - Story file not found for `story_id`
214
212
  - No QA artifacts found (neither gate nor assessments)
215
213
  - HALT and request QA to generate at least a gate file (or proceed only with clear developer-provided fix list)
@@ -248,7 +246,6 @@ Fix plan:
248
246
 
249
247
  ==================== START: .bmad-core/tasks/execute-checklist.md ====================
250
248
  <!-- Powered by BMAD™ Core -->
251
-
252
249
  # Checklist Validation Task
253
250
 
254
251
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -339,7 +336,6 @@ The LLM will:
339
336
 
340
337
  ==================== START: .bmad-core/tasks/validate-next-story.md ====================
341
338
  <!-- Powered by BMAD™ Core -->
342
-
343
339
  # Validate Next Story Task
344
340
 
345
341
  ## Purpose
@@ -361,7 +357,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
361
357
 
362
358
  ### 1. Template Completeness Validation
363
359
 
364
- - Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
360
+ - Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
365
361
  - **Missing sections check**: Compare story sections against template sections to verify all required sections are present
366
362
  - **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
367
363
  - **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -478,7 +474,6 @@ Provide a structured validation report including:
478
474
 
479
475
  ==================== START: .bmad-core/checklists/story-dod-checklist.md ====================
480
476
  <!-- Powered by BMAD™ Core -->
481
-
482
477
  # Story Definition of Done (DoD) Checklist
483
478
 
484
479
  ## Instructions for Developer Agent
@@ -105,7 +105,6 @@ dependencies:
105
105
 
106
106
  ==================== START: .bmad-core/tasks/brownfield-create-epic.md ====================
107
107
  <!-- Powered by BMAD™ Core -->
108
-
109
108
  # Create Brownfield Epic Task
110
109
 
111
110
  ## Purpose
@@ -270,7 +269,6 @@ The epic creation is successful when:
270
269
 
271
270
  ==================== START: .bmad-core/tasks/brownfield-create-story.md ====================
272
271
  <!-- Powered by BMAD™ Core -->
273
-
274
272
  # Create Brownfield Story Task
275
273
 
276
274
  ## Purpose
@@ -422,7 +420,6 @@ The story creation is successful when:
422
420
 
423
421
  ==================== START: .bmad-core/tasks/correct-course.md ====================
424
422
  <!-- Powered by BMAD™ Core -->
425
-
426
423
  # Correct Course Task
427
424
 
428
425
  ## Purpose
@@ -497,7 +494,6 @@ The story creation is successful when:
497
494
 
498
495
  ==================== START: .bmad-core/tasks/create-deep-research-prompt.md ====================
499
496
  <!-- Powered by BMAD™ Core -->
500
-
501
497
  # Create Deep Research Prompt Task
502
498
 
503
499
  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.
@@ -780,7 +776,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
780
776
 
781
777
  ==================== START: .bmad-core/tasks/create-doc.md ====================
782
778
  <!-- Powered by BMAD™ Core -->
783
-
784
779
  # Create Document from Template (YAML Driven)
785
780
 
786
781
  ## ⚠️ CRITICAL EXECUTION NOTICE ⚠️
@@ -886,7 +881,6 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
886
881
 
887
882
  ==================== START: .bmad-core/tasks/execute-checklist.md ====================
888
883
  <!-- Powered by BMAD™ Core -->
889
-
890
884
  # Checklist Validation Task
891
885
 
892
886
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -977,7 +971,6 @@ The LLM will:
977
971
 
978
972
  ==================== START: .bmad-core/tasks/shard-doc.md ====================
979
973
  <!-- Powered by BMAD™ Core -->
980
-
981
974
  # Document Sharding Task
982
975
 
983
976
  ## Purpose
@@ -1657,7 +1650,6 @@ sections:
1657
1650
 
1658
1651
  ==================== START: .bmad-core/checklists/change-checklist.md ====================
1659
1652
  <!-- Powered by BMAD™ Core -->
1660
-
1661
1653
  # Change Navigation Checklist
1662
1654
 
1663
1655
  **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.
@@ -1844,7 +1836,6 @@ Keep it action-oriented and forward-looking.]]
1844
1836
 
1845
1837
  ==================== START: .bmad-core/checklists/pm-checklist.md ====================
1846
1838
  <!-- Powered by BMAD™ Core -->
1847
-
1848
1839
  # Product Manager (PM) Requirements Checklist
1849
1840
 
1850
1841
  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.
@@ -2219,7 +2210,6 @@ After presenting the report, ask if the user wants:
2219
2210
 
2220
2211
  ==================== START: .bmad-core/data/technical-preferences.md ====================
2221
2212
  <!-- Powered by BMAD™ Core -->
2222
-
2223
2213
  # User-Defined Preferred Patterns and Preferences
2224
2214
 
2225
2215
  None Listed
@@ -100,7 +100,6 @@ dependencies:
100
100
 
101
101
  ==================== START: .bmad-core/tasks/correct-course.md ====================
102
102
  <!-- Powered by BMAD™ Core -->
103
-
104
103
  # Correct Course Task
105
104
 
106
105
  ## Purpose
@@ -175,7 +174,6 @@ dependencies:
175
174
 
176
175
  ==================== START: .bmad-core/tasks/execute-checklist.md ====================
177
176
  <!-- Powered by BMAD™ Core -->
178
-
179
177
  # Checklist Validation Task
180
178
 
181
179
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -266,7 +264,6 @@ The LLM will:
266
264
 
267
265
  ==================== START: .bmad-core/tasks/shard-doc.md ====================
268
266
  <!-- Powered by BMAD™ Core -->
269
-
270
267
  # Document Sharding Task
271
268
 
272
269
  ## Purpose
@@ -456,7 +453,6 @@ Document sharded successfully:
456
453
 
457
454
  ==================== START: .bmad-core/tasks/validate-next-story.md ====================
458
455
  <!-- Powered by BMAD™ Core -->
459
-
460
456
  # Validate Next Story Task
461
457
 
462
458
  ## Purpose
@@ -478,7 +474,7 @@ To comprehensively validate a story draft before implementation begins, ensuring
478
474
 
479
475
  ### 1. Template Completeness Validation
480
476
 
481
- - Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
477
+ - Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
482
478
  - **Missing sections check**: Compare story sections against template sections to verify all required sections are present
483
479
  - **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
484
480
  - **Agent section verification**: Confirm all sections from template exist for future agent use
@@ -736,7 +732,6 @@ sections:
736
732
 
737
733
  ==================== START: .bmad-core/checklists/change-checklist.md ====================
738
734
  <!-- Powered by BMAD™ Core -->
739
-
740
735
  # Change Navigation Checklist
741
736
 
742
737
  **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.
@@ -923,7 +918,6 @@ Keep it action-oriented and forward-looking.]]
923
918
 
924
919
  ==================== START: .bmad-core/checklists/po-master-checklist.md ====================
925
920
  <!-- Powered by BMAD™ Core -->
926
-
927
921
  # Product Owner (PO) Master Validation Checklist
928
922
 
929
923
  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.
@@ -939,7 +933,7 @@ First, determine the project type by checking:
939
933
 
940
934
  2. Is this a BROWNFIELD project (enhancing existing system)?
941
935
  - Look for: References to existing codebase, enhancement/modification language
942
- - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
936
+ - Check for: prd.md, architecture.md, existing system analysis
943
937
 
944
938
  3. Does the project include UI/UX components?
945
939
  - Check for: frontend-architecture.md, UI/UX specifications, design files
@@ -957,8 +951,8 @@ For GREENFIELD projects:
957
951
 
958
952
  For BROWNFIELD projects:
959
953
 
960
- - brownfield-prd.md - The brownfield enhancement requirements
961
- - brownfield-architecture.md - The enhancement architecture
954
+ - prd.md - The brownfield enhancement requirements
955
+ - architecture.md - The enhancement architecture
962
956
  - Existing project codebase access (CRITICAL - cannot proceed without this)
963
957
  - Current deployment configuration and infrastructure details
964
958
  - Database schemas, API documentation, monitoring setup
@@ -55,8 +55,7 @@ agent:
55
55
  id: qa
56
56
  title: Test Architect & Quality Advisor
57
57
  icon: 🧪
58
- whenToUse: |
59
- Use for comprehensive test architecture review, quality gate decisions,
58
+ whenToUse: Use for comprehensive test architecture review, quality gate decisions,
60
59
  and code improvement. Provides thorough analysis including requirements
61
60
  traceability, risk assessment, and test strategy.
62
61
  Advisory only - teams choose their quality bar.
@@ -112,7 +111,6 @@ dependencies:
112
111
 
113
112
  ==================== START: .bmad-core/tasks/nfr-assess.md ====================
114
113
  <!-- Powered by BMAD™ Core -->
115
-
116
114
  # nfr-assess
117
115
 
118
116
  Quick NFR validation focused on the core four: security, performance, reliability, maintainability.
@@ -122,11 +120,11 @@ Quick NFR validation focused on the core four: security, performance, reliabilit
122
120
  ```yaml
123
121
  required:
124
122
  - story_id: '{epic}.{story}' # e.g., "1.3"
125
- - story_path: `bmad-core/core-config.yaml` for the `devStoryLocation`
123
+ - story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
126
124
 
127
125
  optional:
128
- - architecture_refs: `bmad-core/core-config.yaml` for the `architecture.architectureFile`
129
- - technical_preferences: `bmad-core/core-config.yaml` for the `technicalPreferences`
126
+ - architecture_refs: `.bmad-core/core-config.yaml` for the `architecture.architectureFile`
127
+ - technical_preferences: `.bmad-core/core-config.yaml` for the `technicalPreferences`
130
128
  - acceptance_criteria: From story file
131
129
  ```
132
130
 
@@ -460,7 +458,6 @@ performance_deep_dive:
460
458
 
461
459
  ==================== START: .bmad-core/tasks/qa-gate.md ====================
462
460
  <!-- Powered by BMAD™ Core -->
463
-
464
461
  # qa-gate
465
462
 
466
463
  Create or update a quality gate decision file for a story based on review findings.
@@ -477,7 +474,7 @@ Generate a standalone quality gate file that provides a clear pass/fail decision
477
474
 
478
475
  ## Gate File Location
479
476
 
480
- **ALWAYS** check the `bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
477
+ **ALWAYS** check the `.bmad-core/core-config.yaml` for the `qa.qaLocation/gates`
481
478
 
482
479
  Slug rules:
483
480
 
@@ -587,7 +584,7 @@ waiver:
587
584
 
588
585
  ## Output Requirements
589
586
 
590
- 1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `bmad-core/core-config.yaml`
587
+ 1. **ALWAYS** create gate file at: `qa.qaLocation/gates` from `.bmad-core/core-config.yaml`
591
588
  2. **ALWAYS** append this exact format to story's QA Results section:
592
589
 
593
590
  ```text
@@ -626,7 +623,6 @@ Gate: CONCERNS → qa.qaLocation/gates/{epic}.{story}-{slug}.yml
626
623
 
627
624
  ==================== START: .bmad-core/tasks/review-story.md ====================
628
625
  <!-- Powered by BMAD™ Core -->
629
-
630
626
  # review-story
631
627
 
632
628
  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.
@@ -813,7 +809,7 @@ NFR assessment: qa.qaLocation/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
813
809
  **Template and Directory:**
814
810
 
815
811
  - Render from `../templates/qa-gate-tmpl.yaml`
816
- - Create directory defined in `qa.qaLocation/gates` (see `bmad-core/core-config.yaml`) if missing
812
+ - Create directory defined in `qa.qaLocation/gates` (see `.bmad-core/core-config.yaml`) if missing
817
813
  - Save to: `qa.qaLocation/gates/{epic}.{story}-{slug}.yml`
818
814
 
819
815
  Gate file structure:
@@ -945,7 +941,6 @@ After review:
945
941
 
946
942
  ==================== START: .bmad-core/tasks/risk-profile.md ====================
947
943
  <!-- Powered by BMAD™ Core -->
948
-
949
944
  # risk-profile
950
945
 
951
946
  Generate a comprehensive risk assessment matrix for a story implementation using probability × impact analysis.
@@ -1303,7 +1298,6 @@ Risk profile: qa.qaLocation/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
1303
1298
 
1304
1299
  ==================== START: .bmad-core/tasks/test-design.md ====================
1305
1300
  <!-- Powered by BMAD™ Core -->
1306
-
1307
1301
  # test-design
1308
1302
 
1309
1303
  Create comprehensive test scenarios with appropriate test level recommendations for story implementation.
@@ -1482,7 +1476,6 @@ Before finalizing, verify:
1482
1476
 
1483
1477
  ==================== START: .bmad-core/tasks/trace-requirements.md ====================
1484
1478
  <!-- Powered by BMAD™ Core -->
1485
-
1486
1479
  # trace-requirements
1487
1480
 
1488
1481
  Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability.
@@ -1998,7 +1991,6 @@ sections:
1998
1991
 
1999
1992
  ==================== START: .bmad-core/data/technical-preferences.md ====================
2000
1993
  <!-- Powered by BMAD™ Core -->
2001
-
2002
1994
  # User-Defined Preferred Patterns and Preferences
2003
1995
 
2004
1996
  None Listed
@@ -86,7 +86,6 @@ dependencies:
86
86
 
87
87
  ==================== START: .bmad-core/tasks/correct-course.md ====================
88
88
  <!-- Powered by BMAD™ Core -->
89
-
90
89
  # Correct Course Task
91
90
 
92
91
  ## Purpose
@@ -161,7 +160,6 @@ dependencies:
161
160
 
162
161
  ==================== START: .bmad-core/tasks/create-next-story.md ====================
163
162
  <!-- Powered by BMAD™ Core -->
164
-
165
163
  # Create Next Story Task
166
164
 
167
165
  ## Purpose
@@ -278,7 +276,6 @@ ALWAYS cite source documents: `[Source: architecture/{filename}.md#{section}]`
278
276
 
279
277
  ==================== START: .bmad-core/tasks/execute-checklist.md ====================
280
278
  <!-- Powered by BMAD™ Core -->
281
-
282
279
  # Checklist Validation Task
283
280
 
284
281
  This task provides instructions for validating documentation against checklists. The agent MUST follow these instructions to ensure thorough and systematic validation of documents.
@@ -510,7 +507,6 @@ sections:
510
507
 
511
508
  ==================== START: .bmad-core/checklists/story-draft-checklist.md ====================
512
509
  <!-- Powered by BMAD™ Core -->
513
-
514
510
  # Story Draft Checklist
515
511
 
516
512
  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.