bmad-method 4.24.6 → 4.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/bmad-core/agents/analyst.md +8 -5
  3. package/bmad-core/agents/architect.md +7 -5
  4. package/bmad-core/agents/bmad-master.md +19 -22
  5. package/bmad-core/agents/dev.md +20 -28
  6. package/bmad-core/agents/pm.md +6 -4
  7. package/bmad-core/agents/po.md +11 -7
  8. package/bmad-core/agents/qa.md +9 -3
  9. package/bmad-core/agents/sm.md +5 -5
  10. package/bmad-core/agents/ux-expert.md +6 -11
  11. package/bmad-core/checklists/story-draft-checklist.md +1 -1
  12. package/bmad-core/core-config.yaml +1 -1
  13. package/bmad-core/tasks/create-next-story.md +61 -224
  14. package/bmad-core/tasks/review-story.md +18 -8
  15. package/bmad-core/tasks/validate-next-story.md +134 -0
  16. package/bmad-core/templates/project-brief-tmpl.md +4 -2
  17. package/bmad-core/templates/story-tmpl.md +22 -33
  18. package/dist/agents/analyst.txt +10 -6
  19. package/dist/agents/architect.txt +5 -4
  20. package/dist/agents/bmad-master.txt +105 -281
  21. package/dist/agents/dev.txt +155 -26
  22. package/dist/agents/pm.txt +4 -3
  23. package/dist/agents/po.txt +168 -39
  24. package/dist/agents/qa.txt +25 -10
  25. package/dist/agents/sm.txt +87 -262
  26. package/dist/agents/ux-expert.txt +4 -10
  27. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +10 -6
  28. package/dist/teams/team-all.txt +299 -327
  29. package/dist/teams/team-fullstack.txt +191 -62
  30. package/dist/teams/team-ide-minimal.txt +276 -304
  31. package/dist/teams/team-no-ui.txt +187 -52
  32. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  33. package/expansion-packs/bmad-creator-tools/config.yaml +1 -1
  34. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  35. package/package.json +1 -1
  36. package/tools/installer/package.json +1 -1
@@ -232,11 +232,13 @@ startup:
232
232
  - Greet the user with your name and role, and inform of the *help command.
233
233
  commands:
234
234
  - help: Show numbered list of the following commands to allow selection
235
- - chat-mode: (Default) Strategic analysis consultation with advanced-elicitation
236
- - create-doc {template}: Create doc (no template = show available templates)
235
+ - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
236
+ - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
237
+ - doc-out: Output full document to current destination file
238
+ - execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
239
+ - research {topic}: execute task create-deep-research-prompt for architectural decisions
237
240
  - brainstorm {topic}: Facilitate structured brainstorming session
238
- - research {topic}: Generate deep research prompt for investigation
239
- - elicit: Run advanced elicitation to clarify requirements
241
+ - elicit: list the options under output set of information
240
242
  - document-project: Analyze and document existing project structure comprehensively
241
243
  - exit: Say goodbye as the Business Analyst, and then abandon inhabiting this persona
242
244
  dependencies:
@@ -293,9 +295,10 @@ startup:
293
295
  - Greet the user with your name and role, and inform of the *help command.
294
296
  commands:
295
297
  - help: Show numbered list of the following commands to allow selection
296
- - chat-mode: (Default) Deep conversation with advanced-elicitation
297
- - create-doc {template}: Create doc (no template = show available templates)
298
- - exit: Say goodbye as the PM, and then abandon inhabiting this persona
298
+ - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
299
+ - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
300
+ - doc-out: Output full document to current destination file
301
+ - exit: Exit (confirm)
299
302
  dependencies:
300
303
  tasks:
301
304
  - create-doc
@@ -357,10 +360,11 @@ startup:
357
360
  - When creating architecture, always start by understanding the complete picture - user needs, business constraints, team capabilities, and technical requirements.
358
361
  commands:
359
362
  - help: Show numbered list of the following commands to allow selection
360
- - chat-mode: (Default) Architect consultation with advanced-elicitation for complex system design
361
- - create-doc {template}: Create doc (no template = show available templates)
362
- - execute-checklist {checklist}: Run architectural validation checklist
363
- - research {topic}: Generate deep research prompt for architectural decisions
363
+ - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
364
+ - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
365
+ - doc-out: Output full document to current destination file
366
+ - execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
367
+ - research {topic}: execute task create-deep-research-prompt for architectural decisions
364
368
  - exit: Say goodbye as the Architect, and then abandon inhabiting this persona
365
369
  dependencies:
366
370
  tasks:
@@ -420,14 +424,16 @@ startup:
420
424
  - Greet the user with your name and role, and inform of the *help command.
421
425
  commands:
422
426
  - help: Show numbered list of the following commands to allow selection
423
- - chat-mode: (Default) Product Owner consultation with advanced-elicitation
424
- - create-doc {template}: Create doc (no template = show available templates)
425
- - execute-checklist {checklist}: Run validation checklist (default->po-master-checklist)
426
- - shard-doc {document}: Break down document into actionable parts
427
- - correct-course: Analyze and suggest project course corrections
427
+ - create-doc {template}: execute task create-doc (no template = ONLY show available templates listed under dependencies/templates below)
428
+ - execute-checklist {checklist}: Run task execute-checklist (default->po-master-checklist)
429
+ - shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
430
+ - correct-course: execute the correct-course task
428
431
  - create-epic: Create epic for brownfield projects (task brownfield-create-epic)
429
432
  - create-story: Create user story from requirements (task brownfield-create-story)
430
- - exit: Say goodbye as the Product Owner, and then abandon inhabiting this persona
433
+ - yolo: Toggle Yolo Mode off on - on will skip doc section confirmations
434
+ - doc-out: Output full document to current destination file
435
+ - validate-story-draft {story}: run the task validate-next-story against the provided story file
436
+ - exit: Exit (confirm)
431
437
  dependencies:
432
438
  tasks:
433
439
  - execute-checklist
@@ -435,6 +441,7 @@ dependencies:
435
441
  - correct-course
436
442
  - brownfield-create-epic
437
443
  - brownfield-create-story
444
+ - validate-next-story
438
445
  templates:
439
446
  - story-tmpl
440
447
  checklists:
@@ -3195,9 +3202,11 @@ Apply the advanced elicitation task after major sections to refine based on user
3195
3202
  ==================== END: tasks#document-project ====================
3196
3203
 
3197
3204
  ==================== START: templates#project-brief-tmpl ====================
3198
- # Project Brief: {{Project Name}}
3205
+ ---
3206
+ defaultOutput: docs/brief.md
3207
+ ---
3199
3208
 
3200
- [[LLM: The default path and filename unless specified is docs/brief.md]]
3209
+ # Project Brief: {{Project Name}}
3201
3210
 
3202
3211
  [[LLM: This template guides creation of a comprehensive Project Brief that serves as the foundational input for product development.
3203
3212
 
@@ -8680,18 +8689,170 @@ Now that you've completed the checklist, generate a comprehensive validation rep
8680
8689
  After presenting the report, ask the user if they would like detailed analysis of any specific section, especially those with warnings or failures.]]
8681
8690
  ==================== END: checklists#architect-checklist ====================
8682
8691
 
8692
+ ==================== START: tasks#validate-next-story ====================
8693
+ # Validate Next Story Task
8694
+
8695
+ ## Purpose
8696
+
8697
+ To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
8698
+
8699
+ ## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
8700
+
8701
+ ### 0. Load Core Configuration and Inputs
8702
+
8703
+ - Load `.bmad-core/core-config.yaml` from the project root
8704
+ - If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
8705
+ - Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
8706
+ - Identify and load the following inputs:
8707
+ - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
8708
+ - **Parent epic**: The epic containing this story's requirements
8709
+ - **Architecture documents**: Based on configuration (sharded or monolithic)
8710
+ - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
8711
+
8712
+ ### 1. Template Completeness Validation
8713
+
8714
+ - Load `bmad-core/templates/story-tmpl.md` and extract all section headings from the template
8715
+ - **Missing sections check**: Compare story sections against template sections to verify all required sections are present
8716
+ - **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
8717
+ - **Agent section verification**: Confirm all sections from template exist for future agent use
8718
+ - **Structure compliance**: Verify story follows template structure and formatting
8719
+
8720
+ ### 2. File Structure and Source Tree Validation
8721
+
8722
+ - **File paths clarity**: Are new/existing files to be created/modified clearly specified?
8723
+ - **Source tree relevance**: Is relevant project structure included in Dev Notes?
8724
+ - **Directory structure**: Are new directories/components properly located according to project structure?
8725
+ - **File creation sequence**: Do tasks specify where files should be created in logical order?
8726
+ - **Path accuracy**: Are file paths consistent with project structure from architecture docs?
8727
+
8728
+ ### 3. UI/Frontend Completeness Validation (if applicable)
8729
+
8730
+ - **Component specifications**: Are UI components sufficiently detailed for implementation?
8731
+ - **Styling/design guidance**: Is visual implementation guidance clear?
8732
+ - **User interaction flows**: Are UX patterns and behaviors specified?
8733
+ - **Responsive/accessibility**: Are these considerations addressed if required?
8734
+ - **Integration points**: Are frontend-backend integration points clear?
8735
+
8736
+ ### 4. Acceptance Criteria Satisfaction Assessment
8737
+
8738
+ - **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
8739
+ - **AC testability**: Are acceptance criteria measurable and verifiable?
8740
+ - **Missing scenarios**: Are edge cases or error conditions covered?
8741
+ - **Success definition**: Is "done" clearly defined for each AC?
8742
+ - **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
8743
+
8744
+ ### 5. Validation and Testing Instructions Review
8745
+
8746
+ - **Test approach clarity**: Are testing methods clearly specified?
8747
+ - **Test scenarios**: Are key test cases identified?
8748
+ - **Validation steps**: Are acceptance criteria validation steps clear?
8749
+ - **Testing tools/frameworks**: Are required testing tools specified?
8750
+ - **Test data requirements**: Are test data needs identified?
8751
+
8752
+ ### 6. Security Considerations Assessment (if applicable)
8753
+
8754
+ - **Security requirements**: Are security needs identified and addressed?
8755
+ - **Authentication/authorization**: Are access controls specified?
8756
+ - **Data protection**: Are sensitive data handling requirements clear?
8757
+ - **Vulnerability prevention**: Are common security issues addressed?
8758
+ - **Compliance requirements**: Are regulatory/compliance needs addressed?
8759
+
8760
+ ### 7. Tasks/Subtasks Sequence Validation
8761
+
8762
+ - **Logical order**: Do tasks follow proper implementation sequence?
8763
+ - **Dependencies**: Are task dependencies clear and correct?
8764
+ - **Granularity**: Are tasks appropriately sized and actionable?
8765
+ - **Completeness**: Do tasks cover all requirements and acceptance criteria?
8766
+ - **Blocking issues**: Are there any tasks that would block others?
8767
+
8768
+ ### 8. Anti-Hallucination Verification
8769
+
8770
+ - **Source verification**: Every technical claim must be traceable to source documents
8771
+ - **Architecture alignment**: Dev Notes content matches architecture specifications
8772
+ - **No invented details**: Flag any technical decisions not supported by source documents
8773
+ - **Reference accuracy**: Verify all source references are correct and accessible
8774
+ - **Fact checking**: Cross-reference claims against epic and architecture documents
8775
+
8776
+ ### 9. Dev Agent Implementation Readiness
8777
+
8778
+ - **Self-contained context**: Can the story be implemented without reading external docs?
8779
+ - **Clear instructions**: Are implementation steps unambiguous?
8780
+ - **Complete technical context**: Are all required technical details present in Dev Notes?
8781
+ - **Missing information**: Identify any critical information gaps
8782
+ - **Actionability**: Are all tasks actionable by a development agent?
8783
+
8784
+ ### 10. Generate Validation Report
8785
+
8786
+ Provide a structured validation report including:
8787
+
8788
+ #### Template Compliance Issues
8789
+
8790
+ - Missing sections from story template
8791
+ - Unfilled placeholders or template variables
8792
+ - Structural formatting issues
8793
+
8794
+ #### Critical Issues (Must Fix - Story Blocked)
8795
+
8796
+ - Missing essential information for implementation
8797
+ - Inaccurate or unverifiable technical claims
8798
+ - Incomplete acceptance criteria coverage
8799
+ - Missing required sections
8800
+
8801
+ #### Should-Fix Issues (Important Quality Improvements)
8802
+
8803
+ - Unclear implementation guidance
8804
+ - Missing security considerations
8805
+ - Task sequencing problems
8806
+ - Incomplete testing instructions
8807
+
8808
+ #### Nice-to-Have Improvements (Optional Enhancements)
8809
+
8810
+ - Additional context that would help implementation
8811
+ - Clarifications that would improve efficiency
8812
+ - Documentation improvements
8813
+
8814
+ #### Anti-Hallucination Findings
8815
+
8816
+ - Unverifiable technical claims
8817
+ - Missing source references
8818
+ - Inconsistencies with architecture documents
8819
+ - Invented libraries, patterns, or standards
8820
+
8821
+ #### Final Assessment
8822
+
8823
+ - **GO**: Story is ready for implementation
8824
+ - **NO-GO**: Story requires fixes before implementation
8825
+ - **Implementation Readiness Score**: 1-10 scale
8826
+ - **Confidence Level**: High/Medium/Low for successful implementation
8827
+ ==================== END: tasks#validate-next-story ====================
8828
+
8683
8829
  ==================== START: templates#story-tmpl ====================
8830
+ ---
8831
+ defaultOutput: docs/stories/{{EpicNum}}.{{StoryNum}}.{{Short Title Copied from Epic File specific story}}.md
8832
+ smAgent:
8833
+ editableSections: Status, Story, Acceptance Criteria, Tasks / Subtasks, Dev Notes, Testing, Change Log
8834
+ sectionSpecificInstructions:
8835
+ "Dev Notes":
8836
+ - Populate relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story
8837
+ - Do not invent information.
8838
+ - If known add Relevant Source Tree info that relates to this story.
8839
+ - If there were important notes from previous story that are relevant to this one, include them here.
8840
+ - Put enough information in this section so that the dev agent should NEVER need to read the architecture documents, these notes along with the tasks and subtasks must give the Dev Agent the complete context it needs to comprehend with the least amount of overhead the information to complete the story, meeting all AC and completing all tasks+subtasks.
8841
+ Testing:
8842
+ - List Relevant Testing Standards from Architecture the Developer needs to conform to (test file location, test standards, etc)
8843
+ ---
8844
+
8684
8845
  # Story {{EpicNum}}.{{StoryNum}}: {{Short Title Copied from Epic File specific story}}
8685
8846
 
8686
8847
  ## Status: {{ Draft | Approved | InProgress | Review | Done }}
8687
8848
 
8688
8849
  ## Story
8689
8850
 
8690
- - As a {{role}}
8691
- - I want {{action}}
8692
- - so that {{benefit}}
8851
+ **As a** {{role}},\
8852
+ **I want** {{action}},\
8853
+ **so that** {{benefit}}
8693
8854
 
8694
- ## Acceptance Criteria (ACs)
8855
+ ## Acceptance Criteria
8695
8856
 
8696
8857
  {{ Copy of Acceptance Criteria numbered list }}
8697
8858
 
@@ -8706,20 +8867,12 @@ After presenting the report, ask the user if they would like detailed analysis o
8706
8867
 
8707
8868
  ## Dev Notes
8708
8869
 
8709
- [[LLM: populates relevant information, only what was pulled from actual artifacts from docs folder, relevant to this story. Do not invent information. Critical: If known add Relevant Source Tree info that relates to this story. If there were important notes from previous story that are relevant to this one, also include them here if it will help the dev agent. You do NOT need to repeat anything from coding standards or test standards as the dev agent is already aware of those. The dev agent should NEVER need to read the PRD or architecture documents or child documents though to complete this self contained story, because your critical mission is to share the specific items needed here extremely concisely for the Dev Agent LLM to comprehend with the least about of context overhead token usage needed.]]
8710
-
8711
8870
  ### Testing
8712
8871
 
8713
- [[LLM: Scrum Master use `test-strategy-and-standards.md` to leave instruction for developer agent in the following concise format, leave unchecked if no specific test requirement of that type]]
8714
- Dev Note: Story Requires the following tests:
8715
-
8716
- - [ ] {{type f.e. Jest}} Unit Tests: (nextToFile: {{true|false}}), coverage requirement: {{from strategy or default 80%}}
8717
- - [ ] {{type f.e. Jest with in memory db}} Integration Test (Test Location): location: {{Integration test location f.e. `/tests/story-name/foo.spec.cs` or `next to handler`}}
8718
- - [ ] {{type f.e. Cypress}} E2E: location: {{f.e. `/e2e/{epic-name/bar.test.ts`}}
8872
+ ## Change Log
8719
8873
 
8720
- Manual Test Steps: [[LLM: Include how if possible the user can manually test the functionality when story is Ready for Review, if any]]
8721
-
8722
- {{ f.e. `- dev will create a script with task 3 above that you can run with "npm run test-initiate-launch-sequence" and validate Armageddon is initiated`}}
8874
+ | Date | Version | Description | Author |
8875
+ | :--- | :------ | :---------- | :----- |
8723
8876
 
8724
8877
  ## Dev Agent Record
8725
8878
 
@@ -8727,29 +8880,11 @@ Manual Test Steps: [[LLM: Include how if possible the user can manually test the
8727
8880
 
8728
8881
  ### Debug Log References
8729
8882
 
8730
- [[LLM: (SM Agent) When Drafting Story, leave next prompt in place for dev agent to remove and update]]
8731
- [[LLM: (Dev Agent) If the debug is logged to during the current story progress, create a table with the debug log and the specific task section in the debug log - do not repeat all the details in the story]]
8732
-
8733
8883
  ### Completion Notes List
8734
8884
 
8735
- [[LLM: (SM Agent) When Drafting Story, leave next prompt in place for dev agent to remove and update - remove this line to the SM]]
8736
- [[LLM: (Dev Agent) Anything the SM needs to know that deviated from the story that might impact drafting the next story.]]
8737
-
8738
8885
  ### File List
8739
8886
 
8740
- [[LLM: (Dev Agent) List every new file created, or existing file modified in a bullet list.]]
8741
-
8742
- ### Change Log
8743
-
8744
- [[LLM: (SM Agent) When Drafting Story, leave next prompt in place for dev agent to remove and update- remove this line to the SM]]
8745
- [[LLM: (Dev Agent) Track document versions and changes during development that deviate from story dev start]]
8746
-
8747
- | Date | Version | Description | Author |
8748
- | :--- | :------ | :---------- | :----- |
8749
-
8750
8887
  ## QA Results
8751
-
8752
- [[LLM: QA Agent Results]]
8753
8888
  ==================== END: templates#story-tmpl ====================
8754
8889
 
8755
8890
  ==================== START: checklists#po-master-checklist ====================
@@ -1,5 +1,5 @@
1
1
  name: bmad-2d-phaser-game-dev
2
- version: 1.5.0
2
+ version: 1.6.0
3
3
  short-title: 2D game development with Phaser 3 & TypeScript
4
4
  description: >-
5
5
  2D Game Development expansion pack for BMad Method - Phaser 3 & TypeScript
@@ -1,5 +1,5 @@
1
1
  name: bmad-creator-tools
2
- version: 1.4.0
2
+ version: 1.5.0
3
3
  short-title: Tools for creating BMad framework components
4
4
  description: Tools for creating and extending BMad framework components.
5
5
  author: Brian (BMad)
@@ -1,5 +1,5 @@
1
1
  name: bmad-infrastructure-devops
2
- version: 1.4.0
2
+ version: 1.5.0
3
3
  short-title: Infrastructure and DevOps capabilities
4
4
  description: >-
5
5
  This expansion pack extends BMad Method with comprehensive infrastructure and
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.24.6",
3
+ "version": "4.25.0",
4
4
  "description": "Breakthrough Method of Agile AI-driven Development",
5
5
  "main": "tools/cli.js",
6
6
  "bin": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.24.6",
3
+ "version": "4.25.0",
4
4
  "description": "BMad Method installer - AI-powered Agile development framework",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {