bmad-method 6.2.3-next.3 → 6.2.3-next.30

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 (126) hide show
  1. package/.claude-plugin/marketplace.json +0 -4
  2. package/README.md +8 -9
  3. package/README_CN.md +1 -1
  4. package/README_VN.md +110 -0
  5. package/package.json +2 -1
  6. package/removals.txt +17 -0
  7. package/src/bmm-skills/1-analysis/bmad-agent-analyst/SKILL.md +7 -4
  8. package/src/bmm-skills/1-analysis/bmad-agent-tech-writer/SKILL.md +6 -4
  9. package/src/bmm-skills/1-analysis/bmad-document-project/workflow.md +8 -10
  10. package/src/bmm-skills/1-analysis/bmad-prfaq/SKILL.md +96 -0
  11. package/src/bmm-skills/1-analysis/bmad-prfaq/agents/artifact-analyzer.md +60 -0
  12. package/src/bmm-skills/1-analysis/bmad-prfaq/agents/web-researcher.md +49 -0
  13. package/src/bmm-skills/1-analysis/bmad-prfaq/assets/prfaq-template.md +62 -0
  14. package/src/bmm-skills/1-analysis/bmad-prfaq/bmad-manifest.json +16 -0
  15. package/src/bmm-skills/1-analysis/bmad-prfaq/references/customer-faq.md +55 -0
  16. package/src/bmm-skills/1-analysis/bmad-prfaq/references/internal-faq.md +51 -0
  17. package/src/bmm-skills/1-analysis/bmad-prfaq/references/press-release.md +60 -0
  18. package/src/bmm-skills/1-analysis/bmad-prfaq/references/verdict.md +79 -0
  19. package/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md +1 -6
  20. package/src/bmm-skills/1-analysis/bmad-product-brief/bmad-manifest.json +1 -1
  21. package/src/bmm-skills/1-analysis/research/bmad-domain-research/workflow.md +8 -6
  22. package/src/bmm-skills/1-analysis/research/bmad-market-research/workflow.md +8 -6
  23. package/src/bmm-skills/1-analysis/research/bmad-technical-research/workflow.md +8 -6
  24. package/src/bmm-skills/2-plan-workflows/bmad-agent-pm/SKILL.md +6 -4
  25. package/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/SKILL.md +6 -4
  26. package/src/bmm-skills/2-plan-workflows/bmad-create-prd/workflow.md +8 -9
  27. package/src/bmm-skills/2-plan-workflows/bmad-create-ux-design/steps/step-13-responsive-accessibility.md +1 -1
  28. package/src/bmm-skills/2-plan-workflows/bmad-create-ux-design/workflow.md +8 -9
  29. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +1 -1
  30. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +1 -1
  31. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +1 -1
  32. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +1 -1
  33. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +1 -3
  34. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/workflow.md +8 -9
  35. package/src/bmm-skills/2-plan-workflows/bmad-validate-prd/workflow.md +8 -9
  36. package/src/bmm-skills/3-solutioning/bmad-agent-architect/SKILL.md +6 -4
  37. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-01-document-discovery.md +1 -1
  38. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-02-prd-analysis.md +1 -1
  39. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-03-epic-coverage-validation.md +1 -1
  40. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/workflow.md +9 -11
  41. package/src/bmm-skills/3-solutioning/bmad-create-architecture/workflow.md +8 -14
  42. package/src/bmm-skills/3-solutioning/bmad-create-epics-and-stories/workflow.md +10 -12
  43. package/src/bmm-skills/3-solutioning/bmad-generate-project-context/workflow.md +8 -12
  44. package/src/bmm-skills/4-implementation/bmad-agent-dev/SKILL.md +11 -4
  45. package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/SKILL.md +29 -0
  46. package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/generate-trail.md +38 -0
  47. package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-01-orientation.md +105 -0
  48. package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-02-walkthrough.md +89 -0
  49. package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-03-detail-pass.md +106 -0
  50. package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-04-testing.md +74 -0
  51. package/src/bmm-skills/4-implementation/bmad-checkpoint-preview/step-05-wrapup.md +24 -0
  52. package/src/bmm-skills/4-implementation/bmad-code-review/steps/step-01-gather-context.md +38 -15
  53. package/src/bmm-skills/4-implementation/bmad-correct-course/checklist.md +2 -2
  54. package/src/bmm-skills/4-implementation/bmad-correct-course/workflow.md +8 -8
  55. package/src/bmm-skills/4-implementation/bmad-qa-generate-e2e-tests/checklist.md +1 -1
  56. package/src/bmm-skills/4-implementation/bmad-quick-dev/spec-template.md +1 -1
  57. package/src/bmm-skills/4-implementation/bmad-quick-dev/step-01-clarify-and-route.md +20 -6
  58. package/src/bmm-skills/4-implementation/bmad-quick-dev/step-02-plan.md +20 -8
  59. package/src/bmm-skills/4-implementation/bmad-quick-dev/step-03-implement.md +2 -0
  60. package/src/bmm-skills/4-implementation/bmad-quick-dev/step-oneshot.md +16 -4
  61. package/src/bmm-skills/4-implementation/bmad-quick-dev/workflow.md +1 -5
  62. package/src/bmm-skills/4-implementation/bmad-retrospective/workflow.md +134 -134
  63. package/src/bmm-skills/4-implementation/bmad-sprint-planning/sprint-status-template.yaml +1 -1
  64. package/src/bmm-skills/4-implementation/bmad-sprint-planning/workflow.md +3 -3
  65. package/src/bmm-skills/4-implementation/bmad-sprint-status/workflow.md +2 -2
  66. package/src/bmm-skills/module-help.csv +4 -1
  67. package/src/core-skills/bmad-advanced-elicitation/SKILL.md +1 -2
  68. package/src/core-skills/bmad-distillator/SKILL.md +0 -1
  69. package/src/core-skills/bmad-distillator/resources/distillate-format-reference.md +9 -9
  70. package/src/core-skills/bmad-help/SKILL.md +4 -2
  71. package/src/core-skills/bmad-party-mode/SKILL.md +121 -2
  72. package/src/core-skills/module-help.csv +1 -0
  73. package/tools/installer/cli-utils.js +18 -9
  74. package/tools/installer/commands/install.js +0 -1
  75. package/tools/installer/core/existing-install.js +2 -8
  76. package/tools/installer/core/install-paths.js +0 -3
  77. package/tools/installer/core/installer.js +176 -464
  78. package/tools/installer/core/manifest-generator.js +4 -12
  79. package/tools/installer/core/manifest.js +82 -97
  80. package/tools/installer/ide/_config-driven.js +149 -38
  81. package/tools/installer/ide/platform-codes.yaml +6 -4
  82. package/tools/installer/ide/shared/skill-manifest.js +1 -16
  83. package/tools/installer/install-messages.yaml +19 -26
  84. package/tools/installer/modules/community-manager.js +377 -0
  85. package/tools/installer/modules/custom-module-manager.js +308 -0
  86. package/tools/installer/modules/external-manager.js +65 -49
  87. package/tools/installer/modules/official-modules.js +37 -65
  88. package/tools/installer/modules/registry-client.js +66 -0
  89. package/tools/installer/{external-official-modules.yaml → modules/registry-fallback.yaml} +3 -12
  90. package/tools/installer/ui.js +340 -672
  91. package/tools/platform-codes.yaml +6 -0
  92. package/src/bmm-skills/2-plan-workflows/create-prd/data/domain-complexity.csv +0 -15
  93. package/src/bmm-skills/2-plan-workflows/create-prd/data/project-types.csv +0 -11
  94. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +0 -224
  95. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md +0 -191
  96. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md +0 -209
  97. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md +0 -174
  98. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md +0 -214
  99. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md +0 -228
  100. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md +0 -217
  101. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md +0 -205
  102. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md +0 -243
  103. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md +0 -263
  104. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md +0 -209
  105. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +0 -264
  106. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md +0 -242
  107. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +0 -232
  108. package/src/bmm-skills/2-plan-workflows/create-prd/workflow-validate-prd.md +0 -65
  109. package/src/bmm-skills/4-implementation/bmad-agent-qa/SKILL.md +0 -59
  110. package/src/bmm-skills/4-implementation/bmad-agent-qa/bmad-skill-manifest.yaml +0 -11
  111. package/src/bmm-skills/4-implementation/bmad-agent-quick-flow-solo-dev/SKILL.md +0 -51
  112. package/src/bmm-skills/4-implementation/bmad-agent-quick-flow-solo-dev/bmad-skill-manifest.yaml +0 -11
  113. package/src/bmm-skills/4-implementation/bmad-agent-sm/SKILL.md +0 -53
  114. package/src/bmm-skills/4-implementation/bmad-agent-sm/bmad-skill-manifest.yaml +0 -11
  115. package/src/core-skills/bmad-init/SKILL.md +0 -100
  116. package/src/core-skills/bmad-init/resources/core-module.yaml +0 -25
  117. package/src/core-skills/bmad-init/scripts/bmad_init.py +0 -624
  118. package/src/core-skills/bmad-init/scripts/tests/test_bmad_init.py +0 -393
  119. package/src/core-skills/bmad-party-mode/steps/step-01-agent-loading.md +0 -138
  120. package/src/core-skills/bmad-party-mode/steps/step-02-discussion-orchestration.md +0 -187
  121. package/src/core-skills/bmad-party-mode/steps/step-03-graceful-exit.md +0 -167
  122. package/src/core-skills/bmad-party-mode/workflow.md +0 -190
  123. package/tools/installer/core/custom-module-cache.js +0 -260
  124. package/tools/installer/custom-handler.js +0 -112
  125. package/tools/installer/modules/custom-modules.js +0 -197
  126. /package/src/bmm-skills/2-plan-workflows/{create-prd → bmad-edit-prd}/data/prd-purpose.md +0 -0
@@ -29,7 +29,7 @@
29
29
  # WORKFLOW NOTES:
30
30
  # ===============
31
31
  # - Mark epic as 'in-progress' when starting work on its first story
32
- # - SM typically creates next story ONLY after previous one is 'done' to incorporate learnings
32
+ # - Developer typically creates next story ONLY after previous one is 'done' to incorporate learnings
33
33
  # - Dev moves story to 'review', then Dev runs code-review (fresh context, ideally different LLM)
34
34
 
35
35
  # EXAMPLE STRUCTURE (your actual epics/stories will replace these):
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Goal:** Generate sprint status tracking from epics, detecting current story statuses and building a complete sprint-status.yaml file.
4
4
 
5
- **Your Role:** You are a Scrum Master generating and maintaining sprint tracking. Parse epic files, detect story statuses, and produce a structured sprint-status.yaml.
5
+ **Your Role:** You are a Developer generating and maintaining sprint tracking. Parse epic files, detect story statuses, and produce a structured sprint-status.yaml.
6
6
 
7
7
  ---
8
8
 
@@ -162,7 +162,7 @@ development_status:
162
162
  # ===============
163
163
  # - Epic transitions to 'in-progress' automatically when first story is created
164
164
  # - Stories can be worked in parallel if team capacity allows
165
- # - SM typically creates next story after previous one is 'done' to incorporate learnings
165
+ # - Developer typically creates next story after previous one is 'done' to incorporate learnings
166
166
  # - Dev moves story to 'review', then runs code-review (fresh context, different LLM recommended)
167
167
 
168
168
  generated: { date }
@@ -260,4 +260,4 @@ optional ↔ done
260
260
  2. **Sequential Default**: Stories are typically worked in order, but parallel work is supported
261
261
  3. **Parallel Work Supported**: Multiple stories can be `in-progress` if team capacity allows
262
262
  4. **Review Before Done**: Stories should pass through `review` before `done`
263
- 5. **Learning Transfer**: SM typically creates next story after previous one is `done` to incorporate learnings
263
+ 5. **Learning Transfer**: Developer typically creates next story after previous one is `done` to incorporate learnings
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Goal:** Summarize sprint status, surface risks, and recommend the next workflow action.
4
4
 
5
- **Your Role:** You are a Scrum Master providing clear, actionable sprint visibility. No time estimates — focus on status, risks, and next steps.
5
+ **Your Role:** You are a Developer providing clear, actionable sprint visibility. No time estimates — focus on status, risks, and next steps.
6
6
 
7
7
  ---
8
8
 
@@ -129,7 +129,7 @@ Enter corrections (e.g., "1=in-progress, 2=backlog") or "skip" to continue witho
129
129
  4. Else if any story status == backlog → recommend `create-story`
130
130
  5. Else if any retrospective status == optional → recommend `retrospective`
131
131
  6. Else → All implementation items done; congratulate the user - you both did amazing work together!
132
- <action>Store selected recommendation as: next_story_id, next_workflow_id, next_agent (SM/DEV as appropriate)</action>
132
+ <action>Store selected recommendation as: next_story_id, next_workflow_id, next_agent (DEV)</action>
133
133
  </step>
134
134
 
135
135
  <step n="4" goal="Display summary">
@@ -1,4 +1,5 @@
1
1
  module,skill,display-name,menu-code,description,action,args,phase,after,before,required,output-location,outputs
2
+ BMad Method,_meta,,,,,,,,,false,https://docs.bmad-method.org/llms.txt,
2
3
  BMad Method,bmad-document-project,Document Project,DP,Analyze an existing project to produce useful documentation.,,anytime,,,false,project-knowledge,*
3
4
  BMad Method,bmad-generate-project-context,Generate Project Context,GPC,Scan existing codebase to generate a lean LLM-optimized project-context.md. Essential for brownfield projects.,,anytime,,,false,output_folder,project context
4
5
  BMad Method,bmad-quick-dev,Quick Dev,QQ,Unified intent-in code-out workflow: clarify plan implement review and present.,,anytime,,,false,implementation_artifacts,spec and project implementation
@@ -12,7 +13,8 @@ BMad Method,bmad-brainstorming,Brainstorm Project,BP,Expert guided facilitation
12
13
  BMad Method,bmad-market-research,Market Research,MR,"Market analysis competitive landscape customer needs and trends.",,1-analysis,,,false,"planning_artifacts|project-knowledge",research documents
13
14
  BMad Method,bmad-domain-research,Domain Research,DR,Industry domain deep dive subject matter expertise and terminology.,,1-analysis,,,false,"planning_artifacts|project_knowledge",research documents
14
15
  BMad Method,bmad-technical-research,Technical Research,TR,Technical feasibility architecture options and implementation approaches.,,1-analysis,,,false,"planning_artifacts|project_knowledge",research documents
15
- BMad Method,bmad-product-brief,Create Brief,CB,A guided experience to nail down your product idea.,,1-analysis,,,false,planning_artifacts,product brief
16
+ BMad Method,bmad-product-brief,Create Brief,CB,An expert guided experience to nail down your product idea in a brief. a gentler approach than PRFAQ when you are already sure of your concept and nothing will sway you.,,-A,1-analysis,,,false,planning_artifacts,product brief
17
+ BMad Method,bmad-prfaq,PRFAQ Challenge,WB,Working Backwards guided experience to forge and stress-test your product concept to ensure you have a great product that users will love and need through the PRFAQ gauntlet to determine feasibility and alignment with user needs. alternative to product brief.,,-H,1-analysis,,,false,planning_artifacts,prfaq document
16
18
  BMad Method,bmad-create-prd,Create PRD,CP,Expert led facilitation to produce your Product Requirements Document.,,2-planning,,,true,planning_artifacts,prd
17
19
  BMad Method,bmad-validate-prd,Validate PRD,VP,,,[path],2-planning,bmad-create-prd,,false,planning_artifacts,prd validation report
18
20
  BMad Method,bmad-edit-prd,Edit PRD,EP,,,[path],2-planning,bmad-validate-prd,,false,planning_artifacts,updated prd
@@ -26,5 +28,6 @@ BMad Method,bmad-create-story,Create Story,CS,"Story cycle start: Prepare first
26
28
  BMad Method,bmad-create-story,Validate Story,VS,Validates story readiness and completeness before development work begins.,validate,,4-implementation,bmad-create-story:create,bmad-dev-story,false,implementation_artifacts,story validation report
27
29
  BMad Method,bmad-dev-story,Dev Story,DS,Story cycle: Execute story implementation tasks and tests then CR then back to DS if fixes needed.,,4-implementation,bmad-create-story:validate,,true,,
28
30
  BMad Method,bmad-code-review,Code Review,CR,Story cycle: If issues back to DS if approved then next CS or ER if epic complete.,,4-implementation,bmad-dev-story,,false,,
31
+ BMad Method,bmad-checkpoint-preview,Checkpoint,CK,Guided walkthrough of a change from purpose and context into details. Use for human review of commits branches or PRs.,,4-implementation,,,false,,
29
32
  BMad Method,bmad-qa-generate-e2e-tests,QA Automation Test,QA,Generate automated API and E2E tests for implemented code. NOT for code review or story validation — use CR for that.,,4-implementation,bmad-dev-story,,false,implementation_artifacts,test suite
30
33
  BMad Method,bmad-retrospective,Retrospective,ER,Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC.,,4-implementation,bmad-code-review,,false,implementation_artifacts,retrospective
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: bmad-advanced-elicitation
3
3
  description: 'Push the LLM to reconsider, refine, and improve its recent output. Use when user asks for deeper critique or mentions a known deeper critique method, e.g. socratic, first principles, pre-mortem, red team.'
4
- agent_party: '{project-root}/_bmad/_config/agent-manifest.csv'
5
4
  ---
6
5
 
7
6
  # Advanced Elicitation
@@ -36,7 +35,7 @@ When invoked from another prompt or process:
36
35
 
37
36
  ### Step 1: Method Registry Loading
38
37
 
39
- **Action:** Load and read `./methods.csv` and `{agent_party}`
38
+ **Action:** Load and read `./methods.csv` and '{project-root}/_bmad/_config/agent-manifest.csv'
40
39
 
41
40
  #### CSV Structure
42
41
 
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: bmad-distillator
3
3
  description: Lossless LLM-optimized compression of source documents. Use when the user requests to 'distill documents' or 'create a distillate'.
4
- argument-hint: "[to create provide input paths] [--validate distillate-path to confirm distillate is lossless and optimized]"
5
4
  ---
6
5
 
7
6
  # Distillator: A Document Distillation Engine
@@ -81,18 +81,18 @@ When the same fact appears in both a brief and discovery notes:
81
81
 
82
82
  **Brief says:**
83
83
  ```
84
- bmad-init must always be included as a base skill in every bundle
84
+ bmad-help must always be included as a base skill in every bundle
85
85
  ```
86
86
 
87
87
  **Discovery notes say:**
88
88
  ```
89
- bmad-init must always be included as a base skill in every bundle/install
90
- (solves bootstrapping problem)
89
+ bmad-help must always be included as a base skill in every bundle/install
90
+ (solves discoverability problem)
91
91
  ```
92
92
 
93
93
  **Distillate keeps the more contextual version:**
94
94
  ```
95
- - bmad-init: always included as base skill in every bundle (solves bootstrapping)
95
+ - bmad-help: always included as base skill in every bundle (solves discoverability)
96
96
  ```
97
97
 
98
98
  ### Decision/Rationale Compression
@@ -128,7 +128,7 @@ parts: 1
128
128
 
129
129
  ## Core Concept
130
130
  - BMAD Next-Gen Installer: replaces monolithic Node.js CLI with skill-based plugin architecture for distributing BMAD methodology across 40+ AI platforms
131
- - Three layers: self-describing plugins (bmad-manifest.json), cross-platform install via Vercel skills CLI (MIT), runtime registration via bmad-init skill
131
+ - Three layers: self-describing plugins (bmad-manifest.json), cross-platform install via Vercel skills CLI (MIT), runtime registration via bmad-setup skill
132
132
  - Transforms BMAD from dev-only methodology into open platform for any domain (creative, therapeutic, educational, personal)
133
133
 
134
134
  ## Problem
@@ -141,7 +141,7 @@ parts: 1
141
141
  - Plugins: skill bundles with Anthropic plugin standard as base format + bmad-manifest.json extending for BMAD-specific metadata (installer options, capabilities, help integration, phase ordering, dependencies)
142
142
  - Existing manifest example: `{"module-code":"bmm","replaces-skill":"bmad-create-product-brief","capabilities":[{"name":"create-brief","menu-code":"CB","supports-headless":true,"phase-name":"1-analysis","after":["brainstorming"],"before":["create-prd"],"is-required":true}]}`
143
143
  - Vercel skills CLI handles platform translation; integration pattern (wrap/fork/call) is PRD decision
144
- - bmad-init: global skill scanning installed bmad-manifest.json files, registering capabilities, configuring project settings; always included as base skill in every bundle (solves bootstrapping)
144
+ - bmad-setup: global skill scanning installed bmad-manifest.json files, registering capabilities, configuring project settings; always included as base skill in every bundle (solves bootstrapping)
145
145
  - bmad-update: plugin update path without full reinstall; technical approach (diff/replace/preserve customizations) is PRD decision
146
146
  - Distribution tiers: (1) NPX installer wrapping skills CLI for technical users, (2) zip bundle + platform-specific README for non-technical users, (3) future marketplace
147
147
  - Non-technical path has honest friction: "copy to right folder" requires knowing where; per-platform README instructions; improves over time as low-code space matures
@@ -161,13 +161,13 @@ parts: 1
161
161
  - Zero (or near-zero) custom platform directory code; delegated to skills CLI ecosystem
162
162
  - Installation verified on top platforms by volume; skills CLI handles long tail
163
163
  - Non-technical install path validated with non-developer users
164
- - bmad-init discovers/registers all plugins from manifests; clear errors for malformed manifests
164
+ - bmad-setup discovers/registers all plugins from manifests; clear errors for malformed manifests
165
165
  - At least one external module author successfully publishes plugin using manifest system
166
166
  - bmad-update works without full reinstall
167
167
  - Existing CLI users have documented migration path
168
168
 
169
169
  ## Scope
170
- - In: manifest spec, bmad-init, bmad-update, Vercel CLI integration, NPX installer, zip bundles, migration path
170
+ - In: manifest spec, bmad-setup, bmad-update, Vercel CLI integration, NPX installer, zip bundles, migration path
171
171
  - Out: BMAD Builder, marketplace web platform, skill conversion (prerequisite, separate), one-click install for all platforms, monetization, quality certification process (gated-submission principle is architectural requirement; process defined separately)
172
172
  - Deferred: CI/CD integration, telemetry for module authors, air-gapped enterprise install, zip bundle integrity verification (checksums/signing), deeper non-technical platform integrations
173
173
 
@@ -214,7 +214,7 @@ parts: 1
214
214
 
215
215
  ## Opportunities
216
216
  - Module authors as acquisition channel: each published plugin distributes BMAD to creator's audience
217
- - CI/CD integration: bmad-init as pipeline one-liner increases stickiness
217
+ - CI/CD integration: bmad-setup as pipeline one-liner increases stickiness
218
218
  - Educational institutions: structured methodology + non-technical install → university AI curriculum
219
219
  - Skill composability: mixing BMAD modules with third-party skills for custom methodology stacks
220
220
 
@@ -7,7 +7,7 @@ description: 'Analyzes current state and user query to answer BMad questions or
7
7
 
8
8
  ## Purpose
9
9
 
10
- Help the user understand where they are in their BMad workflow and what to do next. Answer BMad questions when asked.
10
+ Help the user understand where they are in their BMad workflow and what to do next, and also answer broader questions when asked that could be augmented with remote sources such as module documentation sources.
11
11
 
12
12
  ## Desired Outcomes
13
13
 
@@ -18,6 +18,7 @@ When this skill completes, the user should:
18
18
  3. **Know how to invoke it** — skill name, menu code, action context, and any args that shortcut the conversation
19
19
  4. **Get offered a quick start** — when a single skill is the clear next step, offer to run it for the user right now rather than just listing it
20
20
  5. **Feel oriented, not overwhelmed** — surface only what's relevant to their current position; don't dump the entire catalog
21
+ 6. **Get answers to general questions** — when the question doesn't map to a specific skill, use the module's registered documentation to give a grounded answer
21
22
 
22
23
  ## Data Sources
23
24
 
@@ -25,6 +26,7 @@ When this skill completes, the user should:
25
26
  - **Config**: `config.yaml` and `user-config.yaml` files in `{project-root}/_bmad/` and its subfolders — resolve `output-location` variables, provide `communication_language` and `project_knowledge`
26
27
  - **Artifacts**: Files matching `outputs` patterns at resolved `output-location` paths reveal which steps are possibly completed; their content may also provide grounding context for recommendations
27
28
  - **Project knowledge**: If `project_knowledge` resolves to an existing path, read it for grounding context. Never fabricate project-specific details.
29
+ - **Module docs**: Rows with `_meta` in the `skill` column carry a URL or path in `output-location` pointing to the module's documentation (e.g., llms.txt). Fetch and use these to answer general questions about that module.
28
30
 
29
31
  ## CSV Interpretation
30
32
 
@@ -70,4 +72,4 @@ For each recommended item, present:
70
72
  - Present all output in `{communication_language}`
71
73
  - Recommend running each skill in a **fresh context window**
72
74
  - Match the user's tone — conversational when they're casual, structured when they want specifics
73
- - If the active module is ambiguous, ask rather than guess
75
+ - If the active module is ambiguous, retrieve all meta rows remote sources to find relevant info also to help answer their question
@@ -1,6 +1,125 @@
1
1
  ---
2
2
  name: bmad-party-mode
3
- description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations. Use when user requests party mode.'
3
+ description: 'Orchestrates group discussions between installed BMAD agents, enabling natural multi-agent conversations where each agent is a real subagent with independent thinking. Use when user requests party mode, wants multiple agent perspectives, group discussion, roundtable, or multi-agent conversation about their project.'
4
4
  ---
5
5
 
6
- Follow the instructions in ./workflow.md.
6
+ # Party Mode
7
+
8
+ Facilitate roundtable discussions where BMAD agents participate as **real subagents** — each spawned independently via the Agent tool so they think for themselves. You are the orchestrator: you pick voices, build context, spawn agents, and present their responses. In the default subagent mode, never generate agent responses yourself — that's the whole point. In `--solo` mode, you roleplay all agents directly.
9
+
10
+ ## Why This Matters
11
+
12
+ The whole point of party mode is that each agent produces a genuinely independent perspective. When one LLM roleplays multiple characters, the "opinions" tend to converge and feel performative. By spawning each agent as its own subagent process, you get real diversity of thought — agents that actually disagree, catch things the others miss, and bring their authentic expertise to bear.
13
+
14
+ ## Arguments
15
+
16
+ Party mode accepts optional arguments when invoked:
17
+
18
+ - `--model <model>` — Force all subagents to use a specific model (e.g. `--model haiku`, `--model opus`). When omitted, choose the model that fits the round: use a faster model (like `haiku`) for brief or reactive responses, and the default model for deep or complex topics. Match model weight to the depth of thinking the round requires.
19
+ - `--solo` — Run without subagents. Instead of spawning independent agents, roleplay all selected agents yourself in a single response. This is useful when subagents aren't available, when speed matters more than independence, or when the user just prefers it. Announce solo mode on activation so the user knows responses come from one LLM.
20
+
21
+ ## On Activation
22
+
23
+ 1. **Parse arguments** — check for `--model` and `--solo` flags from the user's invocation.
24
+
25
+ 2. Load config from `{project-root}/_bmad/core/config.yaml` and resolve:
26
+ - Use `{user_name}` for greeting
27
+ - Use `{communication_language}` for all communications
28
+
29
+ 3. **Read the agent manifest** at `{project-root}/_bmad/_config/agent-manifest.csv`. Build an internal roster of available agents with their displayName, title, icon, role, identity, communicationStyle, and principles.
30
+
31
+ 4. **Load project context** — search for `**/project-context.md`. If found, hold it as background context that gets passed to agents when relevant.
32
+
33
+ 5. **Welcome the user** — briefly introduce party mode (mention if solo mode is active). Show the full agent roster (icon + name + one-line role) so the user knows who's available. Ask what they'd like to discuss.
34
+
35
+ ## The Core Loop
36
+
37
+ For each user message:
38
+
39
+ ### 1. Pick the Right Voices
40
+
41
+ Choose 2-4 agents whose expertise is most relevant to what the user is asking. Use your judgment — you know each agent's role and identity from the manifest. Some guidelines:
42
+
43
+ - **Simple question**: 2 agents with the most relevant expertise
44
+ - **Complex or cross-cutting topic**: 3-4 agents from different domains
45
+ - **User names specific agents**: Always include those, plus 1-2 complementary voices
46
+ - **User asks an agent to respond to another**: Spawn just that agent with the other's response as context
47
+ - **Rotate over time** — avoid the same 2 agents dominating every round
48
+
49
+ ### 2. Build Context and Spawn
50
+
51
+ For each selected agent, spawn a subagent using the Agent tool. Each subagent gets:
52
+
53
+ **The agent prompt** (built from the manifest data):
54
+ ```
55
+ You are {displayName} ({title}), a BMAD agent in a collaborative roundtable discussion.
56
+
57
+ ## Your Persona
58
+ - Icon: {icon}
59
+ - Communication Style: {communicationStyle}
60
+ - Principles: {principles}
61
+ - Identity: {identity}
62
+
63
+ ## Discussion Context
64
+ {summary of the conversation so far — keep under 400 words}
65
+
66
+ {project context if relevant}
67
+
68
+ ## What Other Agents Said This Round
69
+ {if this is a cross-talk or reaction request, include the responses being reacted to — otherwise omit this section}
70
+
71
+ ## The User's Message
72
+ {the user's actual message}
73
+
74
+ ## Guidelines
75
+ - Respond authentically as {displayName}. Your perspective should reflect your genuine expertise.
76
+ - Start your response with: {icon} **{displayName}:**
77
+ - Speak in {communication_language}.
78
+ - Scale your response to the substance — don't pad. If you have a brief point, make it briefly.
79
+ - Disagree with other agents when your expertise tells you to. Don't hedge or be polite about it.
80
+ - If you have nothing substantive to add, say so in one sentence rather than manufacturing an opinion.
81
+ - You may ask the user direct questions if something needs clarification.
82
+ - Do NOT use tools. Just respond with your perspective.
83
+ ```
84
+
85
+ **Spawn all agents in parallel** — put all Agent tool calls in a single response so they run concurrently. If `--model` was specified, use that model for all subagents. Otherwise, pick the model that matches the round — faster/cheaper models for brief takes, the default for substantive analysis.
86
+
87
+ **Solo mode** — if `--solo` is active, skip spawning. Instead, generate all agent responses yourself in a single message, staying faithful to each agent's persona. Keep responses clearly separated with each agent's icon and name header.
88
+
89
+ ### 3. Present Responses
90
+
91
+ Present each agent's full response to the user — distinct, complete, and in their own voice. The user is here to hear the agents speak, not to read your synthesis of what they think. Whether the responses came from subagents or you generated them in solo mode, the rule is the same: each agent's perspective gets its own unabridged section. Never blend, paraphrase, or condense agent responses into a summary.
92
+
93
+ The format is simple: each agent's response one after another, separated by a blank line. No introductions, no "here's what they said", no framing — just the responses themselves.
94
+
95
+ After all agent responses are presented in full, you may optionally add a brief **Orchestrator Note** — flagging a disagreement worth exploring, or suggesting an agent to bring in next round. Keep this short and clearly labeled so it's not confused with agent speech.
96
+
97
+ ### 4. Handle Follow-ups
98
+
99
+ The user drives what happens next. Common patterns:
100
+
101
+ | User says... | You do... |
102
+ |---|---|
103
+ | Continues the general discussion | Pick fresh agents, repeat the loop |
104
+ | "Winston, what do you think about what Sally said?" | Spawn just Winston with Sally's response as context |
105
+ | "Bring in Amelia on this" | Spawn Amelia with a summary of the discussion so far |
106
+ | "I agree with John, let's go deeper on that" | Spawn John + 1-2 others to expand on John's point |
107
+ | "What would Mary and Amelia think about Winston's approach?" | Spawn Mary and Amelia with Winston's response as context |
108
+ | Asks a question directed at everyone | Back to step 1 with all agents |
109
+
110
+ The key insight: you can spawn any combination at any time. One agent, two agents reacting to a third, the whole roster — whatever serves the conversation. Each spawn is cheap and independent.
111
+
112
+ ## Keeping Context Manageable
113
+
114
+ As the conversation grows, you'll need to summarize prior rounds rather than passing the full transcript to each subagent. Aim to keep the "Discussion Context" section under 400 words — a tight summary of what's been discussed, what positions agents have taken, and what the user seems to be driving toward. Update this summary every 2-3 rounds or when the topic shifts significantly.
115
+
116
+ ## When Things Go Sideways
117
+
118
+ - **Agents are all saying the same thing**: Bring in a contrarian voice, or ask a specific agent to play devil's advocate by framing the prompt that way.
119
+ - **Discussion is going in circles**: Summarize the impasse and ask the user what angle they want to explore next.
120
+ - **User seems disengaged**: Ask directly — continue, change topic, or wrap up?
121
+ - **Agent gives a weak response**: Don't retry. Present it and let the user decide if they want more from that agent.
122
+
123
+ ## Exit
124
+
125
+ When the user says they're done (any natural phrasing — "thanks", "that's all", "end party mode", etc.), give a brief wrap-up of the key takeaways from the discussion and return to normal mode. Don't force exit triggers — just read the room.
@@ -1,4 +1,5 @@
1
1
  module,skill,display-name,menu-code,description,action,args,phase,after,before,required,output-location,outputs
2
+ Core,_meta,,,,,,,,,false,https://docs.bmad-method.org/llms.txt,
2
3
  Core,bmad-brainstorming,Brainstorming,BSP,Use early in ideation or when stuck generating ideas.,,anytime,,,false,{output_folder}/brainstorming,brainstorming session
3
4
  Core,bmad-party-mode,Party Mode,PM,Orchestrate multi-agent discussions when you need multiple perspectives or want agents to collaborate.,,anytime,,,false,,
4
5
  Core,bmad-help,BMad Help,BH,,,anytime,,,false,,
@@ -19,24 +19,33 @@ const CLIUtils = {
19
19
  * Display BMAD logo and version using @clack intro + box
20
20
  */
21
21
  async displayLogo() {
22
- const version = this.getVersion();
23
22
  const color = await prompts.getColor();
24
-
25
- // ASCII art logo
26
- const logo = [
23
+ const termWidth = process.stdout.columns || 80;
24
+
25
+ // Full "BMad Method" logo for wide terminals, "BMad" only for narrow
26
+ const logoWide = [
27
+ ' ██████╗ ███╗ ███╗ █████╗ ██████╗ ███╗ ███╗███████╗████████╗██╗ ██╗ ██████╗ ██████╗ ™',
28
+ '██╔══██╗████╗ ████║██╔══██╗██╔══██╗ ████╗ ████║██╔════╝╚══██╔══╝██║ ██║██╔═══██╗██╔══██╗',
29
+ '██████╔╝██╔████╔██║███████║██║ ██║ ██╔████╔██║█████╗ ██║ ███████║██║ ██║██║ ██║',
30
+ '██╔══██╗██║╚██╔╝██║██╔══██║██║ ██║ ██║╚██╔╝██║██╔══╝ ██║ ██╔══██║██║ ██║██║ ██║',
31
+ '██████╔╝██║ ╚═╝ ██║██║ ██║██████╔╝ ██║ ╚═╝ ██║███████╗ ██║ ██║ ██║╚██████╔╝██████╔╝',
32
+ '╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ',
33
+ ];
34
+
35
+ const logoNarrow = [
27
36
  ' ██████╗ ███╗ ███╗ █████╗ ██████╗ ™',
28
37
  ' ██╔══██╗████╗ ████║██╔══██╗██╔══██╗',
29
38
  ' ██████╔╝██╔████╔██║███████║██║ ██║',
30
39
  ' ██╔══██╗██║╚██╔╝██║██╔══██║██║ ██║',
31
40
  ' ██████╔╝██║ ╚═╝ ██║██║ ██║██████╔╝',
32
41
  ' ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝',
33
- ]
34
- .map((line) => color.yellow(line))
35
- .join('\n');
42
+ ];
36
43
 
37
- const tagline = ' Build More, Architect Dreams';
44
+ const logoLines = termWidth >= 95 ? logoWide : logoNarrow;
45
+ const logo = logoLines.map((line) => color.blue(line)).join('\n');
46
+ const tagline = color.white(' Build More, Architect Dreams\n © BMad Code');
38
47
 
39
- await prompts.box(`${logo}\n${tagline}`, `v${version}`, {
48
+ await prompts.box(`${logo}\n${tagline}`, '', {
40
49
  contentAlign: 'center',
41
50
  rounded: true,
42
51
  formatBorder: color.blue,
@@ -17,7 +17,6 @@ module.exports = {
17
17
  '--tools <tools>',
18
18
  'Comma-separated list of tool/IDE IDs to configure (e.g., "claude-code,cursor"). Use "none" to skip tool configuration.',
19
19
  ],
20
- ['--custom-content <paths>', 'Comma-separated list of paths to custom modules/agents/workflows'],
21
20
  ['--action <type>', 'Action type for existing installations: install, update, or quick-update'],
22
21
  ['--user-name <name>', 'Name for agents to use (default: system username)'],
23
22
  ['--communication-language <lang>', 'Language for agent communication (default: English)'],
@@ -10,14 +10,13 @@ const { Manifest } = require('./manifest');
10
10
  class ExistingInstall {
11
11
  #version;
12
12
 
13
- constructor({ installed, version, hasCore, modules, ides, customModules }) {
13
+ constructor({ installed, version, hasCore, modules, ides }) {
14
14
  this.installed = installed;
15
15
  this.#version = version;
16
16
  this.hasCore = hasCore;
17
17
  this.modules = Object.freeze(modules.map((m) => Object.freeze({ ...m })));
18
18
  this.moduleIds = Object.freeze(this.modules.map((m) => m.id));
19
19
  this.ides = Object.freeze([...ides]);
20
- this.customModules = Object.freeze([...customModules]);
21
20
  Object.freeze(this);
22
21
  }
23
22
 
@@ -35,7 +34,6 @@ class ExistingInstall {
35
34
  hasCore: false,
36
35
  modules: [],
37
36
  ides: [],
38
- customModules: [],
39
37
  });
40
38
  }
41
39
 
@@ -53,15 +51,11 @@ class ExistingInstall {
53
51
  let hasCore = false;
54
52
  const modules = [];
55
53
  let ides = [];
56
- let customModules = [];
57
54
 
58
55
  const manifest = new Manifest();
59
56
  const manifestData = await manifest.read(bmadDir);
60
57
  if (manifestData) {
61
58
  version = manifestData.version;
62
- if (manifestData.customModules) {
63
- customModules = manifestData.customModules;
64
- }
65
59
  if (manifestData.ides) {
66
60
  ides = manifestData.ides.filter((ide) => ide && typeof ide === 'string');
67
61
  }
@@ -120,7 +114,7 @@ class ExistingInstall {
120
114
  return ExistingInstall.empty();
121
115
  }
122
116
 
123
- return new ExistingInstall({ installed, version, hasCore, modules, ides, customModules });
117
+ return new ExistingInstall({ installed, version, hasCore, modules, ides });
124
118
  }
125
119
  }
126
120
 
@@ -20,14 +20,12 @@ class InstallPaths {
20
20
 
21
21
  const configDir = path.join(bmadDir, '_config');
22
22
  const agentsDir = path.join(configDir, 'agents');
23
- const customCacheDir = path.join(configDir, 'custom');
24
23
  const coreDir = path.join(bmadDir, 'core');
25
24
 
26
25
  for (const [dir, label] of [
27
26
  [bmadDir, 'bmad directory'],
28
27
  [configDir, 'config directory'],
29
28
  [agentsDir, 'agents config directory'],
30
- [customCacheDir, 'custom modules cache'],
31
29
  [coreDir, 'core module directory'],
32
30
  ]) {
33
31
  await ensureWritableDir(dir, label);
@@ -40,7 +38,6 @@ class InstallPaths {
40
38
  bmadDir,
41
39
  configDir,
42
40
  agentsDir,
43
- customCacheDir,
44
41
  coreDir,
45
42
  isUpdate,
46
43
  });