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.
- package/.github/ISSUE_TEMPLATE/config.yml +5 -0
- package/.github/workflows/manual-release.yaml +1 -1
- package/PR-opencode-agents-generator.md +40 -0
- package/README.md +38 -44
- package/bmad-core/agents/analyst.md +1 -1
- package/bmad-core/agents/architect.md +1 -1
- package/bmad-core/agents/bmad-master.md +7 -7
- package/bmad-core/agents/bmad-orchestrator.md +2 -2
- package/bmad-core/agents/dev.md +1 -1
- package/bmad-core/agents/pm.md +1 -1
- package/bmad-core/agents/po.md +1 -1
- package/bmad-core/agents/qa.md +2 -6
- package/bmad-core/agents/sm.md +1 -1
- package/bmad-core/agents/ux-expert.md +1 -1
- package/bmad-core/checklists/po-master-checklist.md +3 -3
- package/bmad-core/data/bmad-kb.md +1 -1
- package/bmad-core/tasks/apply-qa-fixes.md +4 -4
- package/bmad-core/tasks/nfr-assess.md +3 -3
- package/bmad-core/tasks/qa-gate.md +2 -2
- package/bmad-core/tasks/review-story.md +1 -1
- package/bmad-core/templates/brownfield-architecture-tmpl.yaml +6 -6
- package/dist/agents/analyst.txt +3 -11
- package/dist/agents/architect.txt +1 -7
- package/dist/agents/bmad-master.txt +7 -31
- package/dist/agents/bmad-orchestrator.txt +1 -8
- package/dist/agents/dev.txt +5 -10
- package/dist/agents/pm.txt +0 -10
- package/dist/agents/po.txt +4 -10
- package/dist/agents/qa.txt +7 -15
- package/dist/agents/sm.txt +0 -4
- package/dist/agents/ux-expert.txt +0 -4
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -6
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +0 -3
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -3
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +2 -25
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +0 -9
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -8
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +1 -4
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -4
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +3 -35
- package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +0 -9
- package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +0 -8
- package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +0 -7
- package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +0 -8
- package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +0 -10
- package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +0 -8
- package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +0 -7
- package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +0 -9
- package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +0 -85
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-developer.txt +2 -2
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-qa.txt +1 -2
- package/dist/expansion-packs/bmad-godot-game-dev/teams/godot-game-team.txt +5 -6
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -5
- package/dist/teams/team-all.txt +34 -69
- package/dist/teams/team-fullstack.txt +23 -46
- package/dist/teams/team-ide-minimal.txt +16 -42
- package/dist/teams/team-no-ui.txt +12 -34
- package/docs/user-guide.md +48 -1
- package/expansion-packs/bmad-godot-game-dev/agents/bmad-orchestrator.md +1 -1
- package/expansion-packs/bmad-godot-game-dev/agents/game-qa.md +1 -2
- package/expansion-packs/bmad-godot-game-dev/tasks/apply-qa-fixes.md +2 -2
- package/package.json +2 -1
- package/tools/installer/bin/bmad.js +46 -1
- package/tools/installer/config/install.config.yaml +18 -7
- package/tools/installer/lib/ide-setup.js +709 -77
- package/tools/installer/lib/installer.js +17 -4
- package/tools/installer/package.json +1 -1
- 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
|
|
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
|
-
|
|
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
|
|
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
|
|
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:
|
|
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
|
-
-
|
|
8693
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
|
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
|
|
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:
|
|
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
|
-
-
|
|
2625
|
-
-
|
|
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
|
|
3320
|
-
- story_root: from
|
|
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
|
|
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
|
|
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:
|
|
3544
|
+
- story_path: `.bmad-core/core-config.yaml` for the `devStoryLocation`
|
|
3565
3545
|
|
|
3566
3546
|
optional:
|
|
3567
|
-
- architecture_refs:
|
|
3568
|
-
- technical_preferences:
|
|
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
|
|
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
|
|
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
|
|
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
|