bmad-method 4.19.2 → 4.20.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 (118) hide show
  1. package/.github/FUNDING.yml +15 -0
  2. package/.github/ISSUE_TEMPLATE/bug_report.md +32 -0
  3. package/.github/ISSUE_TEMPLATE/feature_request.md +22 -0
  4. package/.vscode/settings.json +6 -76
  5. package/CHANGELOG.md +7 -0
  6. package/CONTRIBUTING.md +1 -1
  7. package/GUIDING-PRINCIPLES.md +2 -2
  8. package/LICENSE +1 -1
  9. package/README.md +178 -220
  10. package/bmad-core/agents/dev.md +1 -1
  11. package/bmad-core/data/bmad-kb.md +1 -1
  12. package/dist/agents/analyst.txt +1 -1
  13. package/dist/agents/bmad-master.txt +1 -1
  14. package/dist/agents/bmad-orchestrator.txt +1 -1
  15. package/dist/teams/team-all.txt +39 -39
  16. package/dist/teams/team-fullstack.txt +39 -39
  17. package/dist/teams/team-ide-minimal.txt +1 -1
  18. package/dist/teams/team-no-ui.txt +13 -13
  19. package/docs/agentic-tools/claude-code-guide.md +36 -0
  20. package/docs/agentic-tools/cline-guide.md +42 -0
  21. package/docs/agentic-tools/cursor-guide.md +37 -0
  22. package/docs/agentic-tools/gemini-cli-guide.md +46 -0
  23. package/docs/agentic-tools/roo-code-guide.md +46 -0
  24. package/docs/agentic-tools/windsurf-guide.md +37 -0
  25. package/docs/core-architecture.md +174 -6
  26. package/docs/expansion-packs.md +15 -0
  27. package/docs/user-guide.md +283 -36
  28. package/docs/versioning-and-releases.md +2 -10
  29. package/docs/versions.md +0 -1
  30. package/docs/working-in-the-brownfield.md +4 -8
  31. package/package.json +1 -1
  32. package/tools/installer/bin/bmad.js +2 -2
  33. package/tools/installer/package.json +1 -1
  34. package/.claude/commands/analyst.md +0 -68
  35. package/.claude/commands/architect.md +0 -68
  36. package/.claude/commands/bmad-master.md +0 -105
  37. package/.claude/commands/bmad-orchestrator.md +0 -130
  38. package/.claude/commands/bmad-the-creator.md +0 -57
  39. package/.claude/commands/dev.md +0 -69
  40. package/.claude/commands/game-designer.md +0 -62
  41. package/.claude/commands/game-developer.md +0 -70
  42. package/.claude/commands/game-sm.md +0 -55
  43. package/.claude/commands/infra-devops-platform.md +0 -63
  44. package/.claude/commands/pm.md +0 -65
  45. package/.claude/commands/po.md +0 -67
  46. package/.claude/commands/qa.md +0 -54
  47. package/.claude/commands/sm.md +0 -55
  48. package/.claude/commands/ux-expert.md +0 -67
  49. package/.clinerules/01-bmad-master.md +0 -116
  50. package/.clinerules/02-bmad-orchestrator.md +0 -141
  51. package/.clinerules/03-pm.md +0 -76
  52. package/.clinerules/04-analyst.md +0 -79
  53. package/.clinerules/05-architect.md +0 -79
  54. package/.clinerules/06-po.md +0 -78
  55. package/.clinerules/07-sm.md +0 -66
  56. package/.clinerules/08-dev.md +0 -80
  57. package/.clinerules/09-qa.md +0 -65
  58. package/.clinerules/10-ux-expert.md +0 -78
  59. package/.clinerules/11-bmad-the-creator.md +0 -68
  60. package/.clinerules/12-game-designer.md +0 -73
  61. package/.clinerules/13-game-developer.md +0 -81
  62. package/.clinerules/14-game-sm.md +0 -66
  63. package/.clinerules/15-infra-devops-platform.md +0 -74
  64. package/.cursor/rules/analyst.mdc +0 -82
  65. package/.cursor/rules/architect.mdc +0 -82
  66. package/.cursor/rules/bmad-master.mdc +0 -119
  67. package/.cursor/rules/bmad-orchestrator.mdc +0 -144
  68. package/.cursor/rules/bmad-the-creator.mdc +0 -71
  69. package/.cursor/rules/dev.mdc +0 -83
  70. package/.cursor/rules/game-designer.mdc +0 -76
  71. package/.cursor/rules/game-developer.mdc +0 -84
  72. package/.cursor/rules/game-sm.mdc +0 -69
  73. package/.cursor/rules/infra-devops-platform.mdc +0 -77
  74. package/.cursor/rules/pm.mdc +0 -79
  75. package/.cursor/rules/po.mdc +0 -81
  76. package/.cursor/rules/qa.mdc +0 -68
  77. package/.cursor/rules/sm.mdc +0 -69
  78. package/.cursor/rules/ux-expert.mdc +0 -81
  79. package/.gemini/agents/analyst.md +0 -64
  80. package/.gemini/agents/architect.md +0 -64
  81. package/.gemini/agents/bmad-master.md +0 -101
  82. package/.gemini/agents/bmad-orchestrator.md +0 -126
  83. package/.gemini/agents/bmad-the-creator.md +0 -53
  84. package/.gemini/agents/dev.md +0 -65
  85. package/.gemini/agents/game-designer.md +0 -58
  86. package/.gemini/agents/game-developer.md +0 -66
  87. package/.gemini/agents/game-sm.md +0 -51
  88. package/.gemini/agents/infra-devops-platform.md +0 -59
  89. package/.gemini/agents/pm.md +0 -61
  90. package/.gemini/agents/po.md +0 -63
  91. package/.gemini/agents/qa.md +0 -50
  92. package/.gemini/agents/sm.md +0 -51
  93. package/.gemini/agents/ux-expert.md +0 -63
  94. package/.gemini/settings.json +0 -20
  95. package/.roomodes +0 -139
  96. package/.vscode/extensions.json +0 -6
  97. package/.vscode/tasks.json +0 -41
  98. package/.windsurf/rules/analyst.md +0 -76
  99. package/.windsurf/rules/architect.md +0 -76
  100. package/.windsurf/rules/bmad-master.md +0 -113
  101. package/.windsurf/rules/bmad-orchestrator.md +0 -138
  102. package/.windsurf/rules/bmad-the-creator.md +0 -65
  103. package/.windsurf/rules/dev.md +0 -77
  104. package/.windsurf/rules/game-designer.md +0 -70
  105. package/.windsurf/rules/game-developer.md +0 -78
  106. package/.windsurf/rules/game-sm.md +0 -63
  107. package/.windsurf/rules/infra-devops-platform.md +0 -71
  108. package/.windsurf/rules/pm.md +0 -73
  109. package/.windsurf/rules/po.md +0 -75
  110. package/.windsurf/rules/qa.md +0 -62
  111. package/.windsurf/rules/sm.md +0 -63
  112. package/.windsurf/rules/ux-expert.md +0 -75
  113. package/docs/claude-code-guide.md +0 -121
  114. package/docs/cursor-guide.md +0 -131
  115. package/docs/expansion-pack-ideas.md +0 -121
  116. package/docs/roo-code-guide.md +0 -142
  117. package/docs/windsurf-guide.md +0 -129
  118. /package/dist/expansion-packs/{expansion-creator → bmad-creator-tools}/agents/bmad-the-creator.txt +0 -0
@@ -1622,7 +1622,7 @@ Expansion packs extend BMAD-METHOD beyond traditional software development into
1622
1622
  ### Using Expansion Packs
1623
1623
 
1624
1624
  1. **Browse Available Packs**: Check `expansion-packs/` directory
1625
- 2. **Get Inspiration**: See `docs/expansion-pack-ideas.md` for detailed examples
1625
+ 2. **Get Inspiration**: See `docs/expansion-packs.md` for detailed examples and ideas
1626
1626
  3. **Install via CLI**:
1627
1627
  ```bash
1628
1628
  npx bmad-method install
@@ -9742,21 +9742,21 @@ workflow:
9742
9742
  notes: "Review existing documentation, codebase structure, and identify integration points. Document current system understanding before proceeding."
9743
9743
 
9744
9744
  - agent: pm
9745
- creates: brownfield-prd.md
9745
+ creates: prd.md
9746
9746
  uses: brownfield-prd-tmpl
9747
9747
  requires: existing_project_analysis
9748
- notes: "Creates comprehensive brownfield PRD with existing system analysis and enhancement planning. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
9748
+ notes: "Creates comprehensive PRD with existing system analysis and enhancement planning. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
9749
9749
 
9750
9750
  - agent: architect
9751
- creates: brownfield-architecture.md
9751
+ creates: architecture.md
9752
9752
  uses: brownfield-architecture-tmpl
9753
- requires: brownfield-prd.md
9754
- notes: "Creates brownfield architecture with integration strategy and existing system constraints. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
9753
+ requires: prd.md
9754
+ notes: "Creates architecture with integration strategy and existing system constraints. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
9755
9755
 
9756
9756
  - agent: po
9757
9757
  validates: all_artifacts
9758
9758
  uses: po-master-checklist
9759
- notes: "Validates all brownfield documents for integration safety and completeness. May require updates to any document."
9759
+ notes: "Validates all documents for integration safety and completeness. May require updates to any document."
9760
9760
 
9761
9761
  - agent: various
9762
9762
  updates: any_flagged_documents
@@ -9806,8 +9806,8 @@ workflow:
9806
9806
  ```mermaid
9807
9807
  graph TD
9808
9808
  A[Start: Brownfield Enhancement] --> B[analyst: analyze existing project]
9809
- B --> C[pm: brownfield-prd.md]
9810
- C --> D[architect: brownfield-architecture.md]
9809
+ B --> C[pm: prd.md]
9810
+ C --> D[architect: architecture.md]
9811
9811
  D --> E[po: validate with po-master-checklist]
9812
9812
  E --> F{PO finds issues?}
9813
9813
  F -->|Yes| G[Return to relevant agent for fixes]
@@ -9828,11 +9828,11 @@ workflow:
9828
9828
  - Multiple team members will work on related changes
9829
9829
 
9830
9830
  handoff_prompts:
9831
- analyst_to_pm: "Existing project analysis complete. Create comprehensive brownfield PRD with integration strategy."
9832
- pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the integration architecture."
9833
- architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for integration safety."
9831
+ analyst_to_pm: "Existing project analysis complete. Create comprehensive PRD with integration strategy."
9832
+ pm_to_architect: "PRD ready. Save it as docs/prd.md, then create the integration architecture."
9833
+ architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for integration safety."
9834
9834
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9835
- complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9835
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9836
9836
  ==================== END: workflows#brownfield-fullstack ====================
9837
9837
 
9838
9838
  ==================== START: workflows#brownfield-service ====================
@@ -9858,21 +9858,21 @@ workflow:
9858
9858
  notes: "Review existing service documentation, codebase, performance metrics, and identify integration dependencies."
9859
9859
 
9860
9860
  - agent: pm
9861
- creates: brownfield-prd.md
9861
+ creates: prd.md
9862
9862
  uses: brownfield-prd-tmpl
9863
9863
  requires: existing_service_analysis
9864
- notes: "Creates comprehensive brownfield PRD focused on service enhancement with existing system analysis. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
9864
+ notes: "Creates comprehensive PRD focused on service enhancement with existing system analysis. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
9865
9865
 
9866
9866
  - agent: architect
9867
- creates: brownfield-architecture.md
9867
+ creates: architecture.md
9868
9868
  uses: brownfield-architecture-tmpl
9869
- requires: brownfield-prd.md
9870
- notes: "Creates brownfield architecture with service integration strategy and API evolution planning. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
9869
+ requires: prd.md
9870
+ notes: "Creates architecture with service integration strategy and API evolution planning. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
9871
9871
 
9872
9872
  - agent: po
9873
9873
  validates: all_artifacts
9874
9874
  uses: po-master-checklist
9875
- notes: "Validates all brownfield documents for service integration safety and API compatibility. May require updates to any document."
9875
+ notes: "Validates all documents for service integration safety and API compatibility. May require updates to any document."
9876
9876
 
9877
9877
  - agent: various
9878
9878
  updates: any_flagged_documents
@@ -9922,8 +9922,8 @@ workflow:
9922
9922
  ```mermaid
9923
9923
  graph TD
9924
9924
  A[Start: Service Enhancement] --> B[analyst: analyze existing service]
9925
- B --> C[pm: brownfield-prd.md]
9926
- C --> D[architect: brownfield-architecture.md]
9925
+ B --> C[pm: prd.md]
9926
+ C --> D[architect: architecture.md]
9927
9927
  D --> E[po: validate with po-master-checklist]
9928
9928
  E --> F{PO finds issues?}
9929
9929
  F -->|Yes| G[Return to relevant agent for fixes]
@@ -9944,11 +9944,11 @@ workflow:
9944
9944
  - Multiple integration points affected
9945
9945
 
9946
9946
  handoff_prompts:
9947
- analyst_to_pm: "Service analysis complete. Create comprehensive brownfield PRD with service integration strategy."
9948
- pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the service architecture."
9949
- architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for service integration safety."
9947
+ analyst_to_pm: "Service analysis complete. Create comprehensive PRD with service integration strategy."
9948
+ pm_to_architect: "PRD ready. Save it as docs/prd.md, then create the service architecture."
9949
+ architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for service integration safety."
9950
9950
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9951
- complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9951
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9952
9952
  ==================== END: workflows#brownfield-service ====================
9953
9953
 
9954
9954
  ==================== START: workflows#brownfield-ui ====================
@@ -9973,29 +9973,29 @@ workflow:
9973
9973
  notes: "Review existing frontend application, user feedback, analytics data, and identify improvement areas."
9974
9974
 
9975
9975
  - agent: pm
9976
- creates: brownfield-prd.md
9976
+ creates: prd.md
9977
9977
  uses: brownfield-prd-tmpl
9978
9978
  requires: existing_ui_analysis
9979
- notes: "Creates comprehensive brownfield PRD focused on UI enhancement with existing system analysis. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
9979
+ notes: "Creates comprehensive PRD focused on UI enhancement with existing system analysis. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
9980
9980
 
9981
9981
  - agent: ux-expert
9982
9982
  creates: front-end-spec.md
9983
9983
  uses: front-end-spec-tmpl
9984
- requires: brownfield-prd.md
9985
- notes: "Creates UI/UX specification for brownfield enhancement that integrates with existing design patterns. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
9984
+ requires: prd.md
9985
+ notes: "Creates UI/UX specification that integrates with existing design patterns. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
9986
9986
 
9987
9987
  - agent: architect
9988
- creates: brownfield-architecture.md
9988
+ creates: architecture.md
9989
9989
  uses: brownfield-architecture-tmpl
9990
9990
  requires:
9991
- - brownfield-prd.md
9991
+ - prd.md
9992
9992
  - front-end-spec.md
9993
- notes: "Creates brownfield frontend architecture with component integration strategy and migration planning. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
9993
+ notes: "Creates frontend architecture with component integration strategy and migration planning. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
9994
9994
 
9995
9995
  - agent: po
9996
9996
  validates: all_artifacts
9997
9997
  uses: po-master-checklist
9998
- notes: "Validates all brownfield documents for UI integration safety and design consistency. May require updates to any document."
9998
+ notes: "Validates all documents for UI integration safety and design consistency. May require updates to any document."
9999
9999
 
10000
10000
  - agent: various
10001
10001
  updates: any_flagged_documents
@@ -10045,9 +10045,9 @@ workflow:
10045
10045
  ```mermaid
10046
10046
  graph TD
10047
10047
  A[Start: UI Enhancement] --> B[analyst: analyze existing UI]
10048
- B --> C[pm: brownfield-prd.md]
10048
+ B --> C[pm: prd.md]
10049
10049
  C --> D[ux-expert: front-end-spec.md]
10050
- D --> E[architect: brownfield-architecture.md]
10050
+ D --> E[architect: architecture.md]
10051
10051
  E --> F[po: validate with po-master-checklist]
10052
10052
  F --> G{PO finds issues?}
10053
10053
  G -->|Yes| H[Return to relevant agent for fixes]
@@ -10069,12 +10069,12 @@ workflow:
10069
10069
  - Multiple team members will work on related changes
10070
10070
 
10071
10071
  handoff_prompts:
10072
- analyst_to_pm: "UI analysis complete. Create comprehensive brownfield PRD with UI integration strategy."
10073
- pm_to_ux: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the UI/UX specification."
10072
+ analyst_to_pm: "UI analysis complete. Create comprehensive PRD with UI integration strategy."
10073
+ pm_to_ux: "PRD ready. Save it as docs/prd.md, then create the UI/UX specification."
10074
10074
  ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md, then create the frontend architecture."
10075
- architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for UI integration safety."
10075
+ architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for UI integration safety."
10076
10076
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
10077
- complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
10077
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
10078
10078
  ==================== END: workflows#brownfield-ui ====================
10079
10079
 
10080
10080
  ==================== START: workflows#greenfield-fullstack ====================
@@ -1466,7 +1466,7 @@ Expansion packs extend BMAD-METHOD beyond traditional software development into
1466
1466
  ### Using Expansion Packs
1467
1467
 
1468
1468
  1. **Browse Available Packs**: Check `expansion-packs/` directory
1469
- 2. **Get Inspiration**: See `docs/expansion-pack-ideas.md` for detailed examples
1469
+ 2. **Get Inspiration**: See `docs/expansion-packs.md` for detailed examples and ideas
1470
1470
  3. **Install via CLI**:
1471
1471
  ```bash
1472
1472
  npx bmad-method install
@@ -8930,21 +8930,21 @@ workflow:
8930
8930
  notes: "Review existing documentation, codebase structure, and identify integration points. Document current system understanding before proceeding."
8931
8931
 
8932
8932
  - agent: pm
8933
- creates: brownfield-prd.md
8933
+ creates: prd.md
8934
8934
  uses: brownfield-prd-tmpl
8935
8935
  requires: existing_project_analysis
8936
- notes: "Creates comprehensive brownfield PRD with existing system analysis and enhancement planning. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
8936
+ notes: "Creates comprehensive PRD with existing system analysis and enhancement planning. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
8937
8937
 
8938
8938
  - agent: architect
8939
- creates: brownfield-architecture.md
8939
+ creates: architecture.md
8940
8940
  uses: brownfield-architecture-tmpl
8941
- requires: brownfield-prd.md
8942
- notes: "Creates brownfield architecture with integration strategy and existing system constraints. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
8941
+ requires: prd.md
8942
+ notes: "Creates architecture with integration strategy and existing system constraints. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
8943
8943
 
8944
8944
  - agent: po
8945
8945
  validates: all_artifacts
8946
8946
  uses: po-master-checklist
8947
- notes: "Validates all brownfield documents for integration safety and completeness. May require updates to any document."
8947
+ notes: "Validates all documents for integration safety and completeness. May require updates to any document."
8948
8948
 
8949
8949
  - agent: various
8950
8950
  updates: any_flagged_documents
@@ -8994,8 +8994,8 @@ workflow:
8994
8994
  ```mermaid
8995
8995
  graph TD
8996
8996
  A[Start: Brownfield Enhancement] --> B[analyst: analyze existing project]
8997
- B --> C[pm: brownfield-prd.md]
8998
- C --> D[architect: brownfield-architecture.md]
8997
+ B --> C[pm: prd.md]
8998
+ C --> D[architect: architecture.md]
8999
8999
  D --> E[po: validate with po-master-checklist]
9000
9000
  E --> F{PO finds issues?}
9001
9001
  F -->|Yes| G[Return to relevant agent for fixes]
@@ -9016,11 +9016,11 @@ workflow:
9016
9016
  - Multiple team members will work on related changes
9017
9017
 
9018
9018
  handoff_prompts:
9019
- analyst_to_pm: "Existing project analysis complete. Create comprehensive brownfield PRD with integration strategy."
9020
- pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the integration architecture."
9021
- architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for integration safety."
9019
+ analyst_to_pm: "Existing project analysis complete. Create comprehensive PRD with integration strategy."
9020
+ pm_to_architect: "PRD ready. Save it as docs/prd.md, then create the integration architecture."
9021
+ architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for integration safety."
9022
9022
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9023
- complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9023
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9024
9024
  ==================== END: workflows#brownfield-fullstack ====================
9025
9025
 
9026
9026
  ==================== START: workflows#brownfield-service ====================
@@ -9046,21 +9046,21 @@ workflow:
9046
9046
  notes: "Review existing service documentation, codebase, performance metrics, and identify integration dependencies."
9047
9047
 
9048
9048
  - agent: pm
9049
- creates: brownfield-prd.md
9049
+ creates: prd.md
9050
9050
  uses: brownfield-prd-tmpl
9051
9051
  requires: existing_service_analysis
9052
- notes: "Creates comprehensive brownfield PRD focused on service enhancement with existing system analysis. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
9052
+ notes: "Creates comprehensive PRD focused on service enhancement with existing system analysis. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
9053
9053
 
9054
9054
  - agent: architect
9055
- creates: brownfield-architecture.md
9055
+ creates: architecture.md
9056
9056
  uses: brownfield-architecture-tmpl
9057
- requires: brownfield-prd.md
9058
- notes: "Creates brownfield architecture with service integration strategy and API evolution planning. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
9057
+ requires: prd.md
9058
+ notes: "Creates architecture with service integration strategy and API evolution planning. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
9059
9059
 
9060
9060
  - agent: po
9061
9061
  validates: all_artifacts
9062
9062
  uses: po-master-checklist
9063
- notes: "Validates all brownfield documents for service integration safety and API compatibility. May require updates to any document."
9063
+ notes: "Validates all documents for service integration safety and API compatibility. May require updates to any document."
9064
9064
 
9065
9065
  - agent: various
9066
9066
  updates: any_flagged_documents
@@ -9110,8 +9110,8 @@ workflow:
9110
9110
  ```mermaid
9111
9111
  graph TD
9112
9112
  A[Start: Service Enhancement] --> B[analyst: analyze existing service]
9113
- B --> C[pm: brownfield-prd.md]
9114
- C --> D[architect: brownfield-architecture.md]
9113
+ B --> C[pm: prd.md]
9114
+ C --> D[architect: architecture.md]
9115
9115
  D --> E[po: validate with po-master-checklist]
9116
9116
  E --> F{PO finds issues?}
9117
9117
  F -->|Yes| G[Return to relevant agent for fixes]
@@ -9132,11 +9132,11 @@ workflow:
9132
9132
  - Multiple integration points affected
9133
9133
 
9134
9134
  handoff_prompts:
9135
- analyst_to_pm: "Service analysis complete. Create comprehensive brownfield PRD with service integration strategy."
9136
- pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the service architecture."
9137
- architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for service integration safety."
9135
+ analyst_to_pm: "Service analysis complete. Create comprehensive PRD with service integration strategy."
9136
+ pm_to_architect: "PRD ready. Save it as docs/prd.md, then create the service architecture."
9137
+ architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for service integration safety."
9138
9138
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9139
- complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9139
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9140
9140
  ==================== END: workflows#brownfield-service ====================
9141
9141
 
9142
9142
  ==================== START: workflows#brownfield-ui ====================
@@ -9161,29 +9161,29 @@ workflow:
9161
9161
  notes: "Review existing frontend application, user feedback, analytics data, and identify improvement areas."
9162
9162
 
9163
9163
  - agent: pm
9164
- creates: brownfield-prd.md
9164
+ creates: prd.md
9165
9165
  uses: brownfield-prd-tmpl
9166
9166
  requires: existing_ui_analysis
9167
- notes: "Creates comprehensive brownfield PRD focused on UI enhancement with existing system analysis. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
9167
+ notes: "Creates comprehensive PRD focused on UI enhancement with existing system analysis. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
9168
9168
 
9169
9169
  - agent: ux-expert
9170
9170
  creates: front-end-spec.md
9171
9171
  uses: front-end-spec-tmpl
9172
- requires: brownfield-prd.md
9173
- notes: "Creates UI/UX specification for brownfield enhancement that integrates with existing design patterns. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
9172
+ requires: prd.md
9173
+ notes: "Creates UI/UX specification that integrates with existing design patterns. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
9174
9174
 
9175
9175
  - agent: architect
9176
- creates: brownfield-architecture.md
9176
+ creates: architecture.md
9177
9177
  uses: brownfield-architecture-tmpl
9178
9178
  requires:
9179
- - brownfield-prd.md
9179
+ - prd.md
9180
9180
  - front-end-spec.md
9181
- notes: "Creates brownfield frontend architecture with component integration strategy and migration planning. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
9181
+ notes: "Creates frontend architecture with component integration strategy and migration planning. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
9182
9182
 
9183
9183
  - agent: po
9184
9184
  validates: all_artifacts
9185
9185
  uses: po-master-checklist
9186
- notes: "Validates all brownfield documents for UI integration safety and design consistency. May require updates to any document."
9186
+ notes: "Validates all documents for UI integration safety and design consistency. May require updates to any document."
9187
9187
 
9188
9188
  - agent: various
9189
9189
  updates: any_flagged_documents
@@ -9233,9 +9233,9 @@ workflow:
9233
9233
  ```mermaid
9234
9234
  graph TD
9235
9235
  A[Start: UI Enhancement] --> B[analyst: analyze existing UI]
9236
- B --> C[pm: brownfield-prd.md]
9236
+ B --> C[pm: prd.md]
9237
9237
  C --> D[ux-expert: front-end-spec.md]
9238
- D --> E[architect: brownfield-architecture.md]
9238
+ D --> E[architect: architecture.md]
9239
9239
  E --> F[po: validate with po-master-checklist]
9240
9240
  F --> G{PO finds issues?}
9241
9241
  G -->|Yes| H[Return to relevant agent for fixes]
@@ -9257,12 +9257,12 @@ workflow:
9257
9257
  - Multiple team members will work on related changes
9258
9258
 
9259
9259
  handoff_prompts:
9260
- analyst_to_pm: "UI analysis complete. Create comprehensive brownfield PRD with UI integration strategy."
9261
- pm_to_ux: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the UI/UX specification."
9260
+ analyst_to_pm: "UI analysis complete. Create comprehensive PRD with UI integration strategy."
9261
+ pm_to_ux: "PRD ready. Save it as docs/prd.md, then create the UI/UX specification."
9262
9262
  ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md, then create the frontend architecture."
9263
- architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for UI integration safety."
9263
+ architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for UI integration safety."
9264
9264
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9265
- complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9265
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9266
9266
  ==================== END: workflows#brownfield-ui ====================
9267
9267
 
9268
9268
  ==================== START: workflows#greenfield-fullstack ====================
@@ -1366,7 +1366,7 @@ Expansion packs extend BMAD-METHOD beyond traditional software development into
1366
1366
  ### Using Expansion Packs
1367
1367
 
1368
1368
  1. **Browse Available Packs**: Check `expansion-packs/` directory
1369
- 2. **Get Inspiration**: See `docs/expansion-pack-ideas.md` for detailed examples
1369
+ 2. **Get Inspiration**: See `docs/expansion-packs.md` for detailed examples and ideas
1370
1370
  3. **Install via CLI**:
1371
1371
  ```bash
1372
1372
  npx bmad-method install
@@ -1398,7 +1398,7 @@ Expansion packs extend BMAD-METHOD beyond traditional software development into
1398
1398
  ### Using Expansion Packs
1399
1399
 
1400
1400
  1. **Browse Available Packs**: Check `expansion-packs/` directory
1401
- 2. **Get Inspiration**: See `docs/expansion-pack-ideas.md` for detailed examples
1401
+ 2. **Get Inspiration**: See `docs/expansion-packs.md` for detailed examples and ideas
1402
1402
  3. **Install via CLI**:
1403
1403
  ```bash
1404
1404
  npx bmad-method install
@@ -8528,21 +8528,21 @@ workflow:
8528
8528
  notes: "Review existing service documentation, codebase, performance metrics, and identify integration dependencies."
8529
8529
 
8530
8530
  - agent: pm
8531
- creates: brownfield-prd.md
8531
+ creates: prd.md
8532
8532
  uses: brownfield-prd-tmpl
8533
8533
  requires: existing_service_analysis
8534
- notes: "Creates comprehensive brownfield PRD focused on service enhancement with existing system analysis. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
8534
+ notes: "Creates comprehensive PRD focused on service enhancement with existing system analysis. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
8535
8535
 
8536
8536
  - agent: architect
8537
- creates: brownfield-architecture.md
8537
+ creates: architecture.md
8538
8538
  uses: brownfield-architecture-tmpl
8539
- requires: brownfield-prd.md
8540
- notes: "Creates brownfield architecture with service integration strategy and API evolution planning. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
8539
+ requires: prd.md
8540
+ notes: "Creates architecture with service integration strategy and API evolution planning. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
8541
8541
 
8542
8542
  - agent: po
8543
8543
  validates: all_artifacts
8544
8544
  uses: po-master-checklist
8545
- notes: "Validates all brownfield documents for service integration safety and API compatibility. May require updates to any document."
8545
+ notes: "Validates all documents for service integration safety and API compatibility. May require updates to any document."
8546
8546
 
8547
8547
  - agent: various
8548
8548
  updates: any_flagged_documents
@@ -8592,8 +8592,8 @@ workflow:
8592
8592
  ```mermaid
8593
8593
  graph TD
8594
8594
  A[Start: Service Enhancement] --> B[analyst: analyze existing service]
8595
- B --> C[pm: brownfield-prd.md]
8596
- C --> D[architect: brownfield-architecture.md]
8595
+ B --> C[pm: prd.md]
8596
+ C --> D[architect: architecture.md]
8597
8597
  D --> E[po: validate with po-master-checklist]
8598
8598
  E --> F{PO finds issues?}
8599
8599
  F -->|Yes| G[Return to relevant agent for fixes]
@@ -8614,9 +8614,9 @@ workflow:
8614
8614
  - Multiple integration points affected
8615
8615
 
8616
8616
  handoff_prompts:
8617
- analyst_to_pm: "Service analysis complete. Create comprehensive brownfield PRD with service integration strategy."
8618
- pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the service architecture."
8619
- architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for service integration safety."
8617
+ analyst_to_pm: "Service analysis complete. Create comprehensive PRD with service integration strategy."
8618
+ pm_to_architect: "PRD ready. Save it as docs/prd.md, then create the service architecture."
8619
+ architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for service integration safety."
8620
8620
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
8621
- complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
8621
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
8622
8622
  ==================== END: workflows#brownfield-service ====================
@@ -0,0 +1,36 @@
1
+ # BMAD Method Guide for Claude Code
2
+
3
+ This guide covers Claude Code-specific setup and usage with BMAD Method. For the complete workflow, see the [BMAD Workflow Guide](../bmad-workflow-guide.md).
4
+
5
+ ## Installation
6
+
7
+ When running `npx bmad-method install`, select **Claude Code** as your IDE. This creates:
8
+
9
+ - `.bmad-core/` folder with all agents
10
+ - `.claude/commands/` folder with agent command files (`.md`)
11
+
12
+ ## Using BMAD Agents in Claude Code
13
+
14
+ Type `/agent-name` in your chat to activate an agent:
15
+
16
+ - `/bmad-master` - Universal task executor
17
+ - `/sm` - Scrum Master
18
+ - `/dev` - Full-stack developer
19
+ - `/architect` - Solution architect
20
+ - `/pm` - Product manager
21
+ - `/analyst` - Business analyst
22
+ - `/qa` - QA specialist
23
+ - `/po` - Product owner
24
+ - `/ux-expert` - UX specialist
25
+
26
+ ## Claude Code-Specific Features
27
+
28
+ - **Command files**: Stored in `.claude/commands/` as `.md` files
29
+ - **Activation**: Use forward slash `/` prefix for all agents
30
+ - **Chat management**: Start new chats when switching agents for clean context
31
+
32
+ ## Tips for Claude Code Users
33
+
34
+ - Commands are auto-suggested as you type `/`
35
+ - Each agent supports `*help` to see available commands
36
+ - Claude Code maintains excellent context within each chat
@@ -0,0 +1,42 @@
1
+ # BMAD Method Guide for Cline (VS Code)
2
+
3
+ This guide covers Cline-specific setup and usage with BMAD Method. For the complete workflow, see the [BMAD Workflow Guide](../bmad-workflow-guide.md).
4
+
5
+ ## Installation
6
+
7
+ When running `npx bmad-method install`, select **Cline** as your IDE. This creates:
8
+
9
+ - `.clinerules/` directory with numbered agent rule files (`.md`)
10
+ - Agents ordered by priority (bmad-master first)
11
+
12
+ ## Using BMAD Agents in Cline
13
+
14
+ 1. **Open Cline panel** in VS Code
15
+ 2. **Type `@agent-name`** in the chat (e.g., `@dev`, `@sm`, `@architect`)
16
+ 3. The agent adopts that persona for the conversation
17
+
18
+ ## Available Agents
19
+
20
+ All agents use `@` prefix:
21
+
22
+ - `@bmad-master` - Universal task executor
23
+ - `@sm` - Scrum Master
24
+ - `@dev` - Full-stack developer
25
+ - `@architect` - Solution architect
26
+ - `@pm` - Product manager
27
+ - `@analyst` - Business analyst
28
+ - `@qa` - QA specialist
29
+ - `@po` - Product owner
30
+ - `@ux-expert` - UX specialist
31
+
32
+ ## Cline-Specific Features
33
+
34
+ - **Rule files**: Stored as numbered files in `.clinerules/` (e.g., `01-bmad-master.md`)
35
+ - **Agent ordering**: Prioritized list with core agents first
36
+ - **VS Code integration**: Works within VS Code's Cline extension panel
37
+
38
+ ## Tips for Cline Users
39
+
40
+ - Cline maintains conversation context well
41
+ - Use `@agent-name` at the start of your message for best results
42
+ - Agent rules are loaded automatically when mentioned
@@ -0,0 +1,37 @@
1
+ # BMAD Method Guide for Cursor
2
+
3
+ This guide covers Cursor-specific setup and usage with BMAD Method. For the complete workflow, see the [BMAD Workflow Guide](../bmad-workflow-guide.md).
4
+
5
+ ## Installation
6
+
7
+ When running `npx bmad-method install`, select **Cursor** as your IDE. This creates:
8
+
9
+ - `.bmad-core/` folder with all agents
10
+ - `.cursor/rules/` folder with agent rule files (`.mdc`)
11
+
12
+ ## Using BMAD Agents in Cursor
13
+
14
+ Type `@agent-name` in chat (Ctrl+L / Cmd+L) to activate an agent:
15
+
16
+ - `@bmad-master` - Universal task executor
17
+ - `@sm` - Scrum Master
18
+ - `@dev` - Full-stack developer
19
+ - `@architect` - Solution architect
20
+ - `@pm` - Product manager
21
+ - `@analyst` - Business analyst
22
+ - `@qa` - QA specialist
23
+ - `@po` - Product owner
24
+ - `@ux-expert` - UX specialist
25
+
26
+ ## Cursor-Specific Features
27
+
28
+ - **Rule files**: Stored in `.cursor/rules/` as `.mdc` files
29
+ - **Auto-completion**: Cursor suggests agents as you type `@`
30
+ - **Context awareness**: Agents can see your current file selection
31
+ - **Custom agents**: For better performance, copy agent content into Cursor's custom modes
32
+
33
+ ## Tips for Cursor Users
34
+
35
+ - Start new chats when switching agents
36
+ - Each agent supports `*help` to see available commands
37
+ - Leverage Cursor's file context for more accurate assistance
@@ -0,0 +1,46 @@
1
+ # BMAD Method Guide for Gemini CLI
2
+
3
+ This guide covers Gemini CLI-specific setup and usage with BMAD Method. For the complete workflow, see the [BMAD Workflow Guide](../bmad-workflow-guide.md).
4
+
5
+ ## Installation
6
+
7
+ When running `npx bmad-method install`, select **Gemini CLI** as your IDE. This creates:
8
+
9
+ - `.gemini/agents/` directory with all agent context files
10
+ - `.gemini/settings.json` configured to load all agents automatically
11
+
12
+ ## Using BMAD Agents with Gemini CLI
13
+
14
+ Simply mention the agent in your prompt:
15
+
16
+ - "As @dev, implement the login feature"
17
+ - "Acting as @architect, review this system design"
18
+ - "@sm, create the next story for our project"
19
+
20
+ The Gemini CLI automatically loads the appropriate agent context.
21
+
22
+ ## Available Agents
23
+
24
+ All agents are referenced with `@` in prompts:
25
+
26
+ - `@bmad-master` - Universal task executor
27
+ - `@sm` - Scrum Master
28
+ - `@dev` - Full-stack developer
29
+ - `@architect` - Solution architect
30
+ - `@pm` - Product manager
31
+ - `@analyst` - Business analyst
32
+ - `@qa` - QA specialist
33
+ - `@po` - Product owner
34
+ - `@ux-expert` - UX specialist
35
+
36
+ ## Gemini CLI-Specific Features
37
+
38
+ - **Context files**: All agents loaded as context in `.gemini/agents/`
39
+ - **Automatic loading**: Settings.json ensures agents are always available
40
+ - **Natural language**: No special syntax needed, just mention the agent
41
+
42
+ ## Tips for Gemini CLI Users
43
+
44
+ - Be explicit about which agent you're addressing
45
+ - You can switch agents mid-conversation by mentioning a different one
46
+ - The CLI maintains context across your session