bmad-method 6.2.3-next.7 → 6.2.3-next.9

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 (60) hide show
  1. package/.claude-plugin/marketplace.json +0 -1
  2. package/package.json +1 -1
  3. package/src/bmm-skills/1-analysis/bmad-agent-analyst/SKILL.md +6 -4
  4. package/src/bmm-skills/1-analysis/bmad-agent-tech-writer/SKILL.md +6 -4
  5. package/src/bmm-skills/1-analysis/bmad-document-project/workflow.md +8 -10
  6. package/src/bmm-skills/1-analysis/bmad-prfaq/SKILL.md +12 -9
  7. package/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md +1 -6
  8. package/src/bmm-skills/1-analysis/research/bmad-domain-research/workflow.md +8 -6
  9. package/src/bmm-skills/1-analysis/research/bmad-market-research/workflow.md +8 -6
  10. package/src/bmm-skills/1-analysis/research/bmad-technical-research/workflow.md +8 -6
  11. package/src/bmm-skills/2-plan-workflows/bmad-agent-pm/SKILL.md +6 -4
  12. package/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/SKILL.md +6 -4
  13. package/src/bmm-skills/2-plan-workflows/bmad-create-prd/workflow.md +8 -9
  14. package/src/bmm-skills/2-plan-workflows/bmad-create-ux-design/workflow.md +8 -9
  15. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +1 -1
  16. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +1 -1
  17. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +1 -1
  18. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +1 -1
  19. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +1 -1
  20. package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/workflow.md +8 -9
  21. package/src/bmm-skills/2-plan-workflows/bmad-validate-prd/workflow.md +8 -9
  22. package/src/bmm-skills/3-solutioning/bmad-agent-architect/SKILL.md +6 -4
  23. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/workflow.md +8 -10
  24. package/src/bmm-skills/3-solutioning/bmad-create-architecture/workflow.md +8 -14
  25. package/src/bmm-skills/3-solutioning/bmad-create-epics-and-stories/workflow.md +10 -12
  26. package/src/bmm-skills/3-solutioning/bmad-generate-project-context/workflow.md +8 -12
  27. package/src/bmm-skills/4-implementation/bmad-agent-dev/SKILL.md +6 -4
  28. package/src/bmm-skills/4-implementation/bmad-agent-qa/SKILL.md +6 -4
  29. package/src/bmm-skills/4-implementation/bmad-agent-quick-flow-solo-dev/SKILL.md +6 -4
  30. package/src/bmm-skills/4-implementation/bmad-agent-sm/SKILL.md +6 -4
  31. package/src/core-skills/bmad-advanced-elicitation/SKILL.md +1 -2
  32. package/src/core-skills/bmad-distillator/SKILL.md +0 -1
  33. package/src/core-skills/bmad-distillator/resources/distillate-format-reference.md +9 -9
  34. package/src/core-skills/bmad-party-mode/SKILL.md +119 -2
  35. package/src/bmm-skills/2-plan-workflows/create-prd/data/domain-complexity.csv +0 -15
  36. package/src/bmm-skills/2-plan-workflows/create-prd/data/prd-purpose.md +0 -197
  37. package/src/bmm-skills/2-plan-workflows/create-prd/data/project-types.csv +0 -11
  38. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +0 -224
  39. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md +0 -191
  40. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md +0 -209
  41. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md +0 -174
  42. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md +0 -214
  43. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md +0 -228
  44. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md +0 -217
  45. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md +0 -205
  46. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md +0 -243
  47. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md +0 -263
  48. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md +0 -209
  49. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +0 -264
  50. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md +0 -242
  51. package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +0 -232
  52. package/src/bmm-skills/2-plan-workflows/create-prd/workflow-validate-prd.md +0 -65
  53. package/src/core-skills/bmad-init/SKILL.md +0 -100
  54. package/src/core-skills/bmad-init/resources/core-module.yaml +0 -25
  55. package/src/core-skills/bmad-init/scripts/bmad_init.py +0 -624
  56. package/src/core-skills/bmad-init/scripts/tests/test_bmad_init.py +0 -393
  57. package/src/core-skills/bmad-party-mode/steps/step-01-agent-loading.md +0 -138
  58. package/src/core-skills/bmad-party-mode/steps/step-02-discussion-orchestration.md +0 -187
  59. package/src/core-skills/bmad-party-mode/steps/step-03-graceful-exit.md +0 -167
  60. package/src/core-skills/bmad-party-mode/workflow.md +0 -190
@@ -37,10 +37,12 @@ When you are in this persona and the user calls a skill, this persona must carry
37
37
 
38
38
  ## On Activation
39
39
 
40
- 1. **Load config via bmad-init skill** — Store all returned vars for use:
41
- - Use `{user_name}` from config for greeting
42
- - Use `{communication_language}` from config for all communications
43
- - Store any other config variables as `{var-name}` and use appropriately
40
+ 1. Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
41
+ - Use `{user_name}` for greeting
42
+ - Use `{communication_language}` for all communications
43
+ - Use `{document_output_language}` for output documents
44
+ - Use `{planning_artifacts}` for output location and artifact scanning
45
+ - Use `{project_knowledge}` for additional context scanning
44
46
 
45
47
  2. **Continue with steps below:**
46
48
  - **Load project context** — Search for `**/project-context.md`. If found, load as foundational reference for project standards and conventions. If not found, continue without it.
@@ -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
 
@@ -1,6 +1,123 @@
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. You never generate agent responses yourself.
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/bmm/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
+ Collect all agent responses and present them to the user as-is. Don't summarize, edit, or reorder them. If an agent's response is particularly brief or says they have nothing to add, that's fine — include it anyway so the user sees the full picture.
92
+
93
+ After presenting, you can optionally add a brief orchestrator note if it would help — like flagging a clear disagreement worth exploring, or noting an agent whose perspective might be relevant but wasn't included this round.
94
+
95
+ ### 4. Handle Follow-ups
96
+
97
+ The user drives what happens next. Common patterns:
98
+
99
+ | User says... | You do... |
100
+ |---|---|
101
+ | Continues the general discussion | Pick fresh agents, repeat the loop |
102
+ | "Winston, what do you think about what Sally said?" | Spawn just Winston with Sally's response as context |
103
+ | "Bring in Quinn on this" | Spawn Quinn with a summary of the discussion so far |
104
+ | "I agree with John, let's go deeper on that" | Spawn John + 1-2 others to expand on John's point |
105
+ | "What would Mary and Bob think about Winston's approach?" | Spawn Mary and Bob with Winston's response as context |
106
+ | Asks a question directed at everyone | Back to step 1 with all agents |
107
+
108
+ 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.
109
+
110
+ ## Keeping Context Manageable
111
+
112
+ 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.
113
+
114
+ ## When Things Go Sideways
115
+
116
+ - **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.
117
+ - **Discussion is going in circles**: Summarize the impasse and ask the user what angle they want to explore next.
118
+ - **User seems disengaged**: Ask directly — continue, change topic, or wrap up?
119
+ - **Agent gives a weak response**: Don't retry. Present it and let the user decide if they want more from that agent.
120
+
121
+ ## Exit
122
+
123
+ 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,15 +0,0 @@
1
- domain,signals,complexity,key_concerns,required_knowledge,suggested_workflow,web_searches,special_sections
2
- healthcare,"medical,diagnostic,clinical,FDA,patient,treatment,HIPAA,therapy,pharma,drug",high,"FDA approval;Clinical validation;HIPAA compliance;Patient safety;Medical device classification;Liability","Regulatory pathways;Clinical trial design;Medical standards;Data privacy;Integration requirements","domain-research","FDA software medical device guidance {date};HIPAA compliance software requirements;Medical software standards {date};Clinical validation software","clinical_requirements;regulatory_pathway;validation_methodology;safety_measures"
3
- fintech,"payment,banking,trading,investment,crypto,wallet,transaction,KYC,AML,funds,fintech",high,"Regional compliance;Security standards;Audit requirements;Fraud prevention;Data protection","KYC/AML requirements;PCI DSS;Open banking;Regional laws (US/EU/APAC);Crypto regulations","domain-research","fintech regulations {date};payment processing compliance {date};open banking API standards;cryptocurrency regulations {date}","compliance_matrix;security_architecture;audit_requirements;fraud_prevention"
4
- govtech,"government,federal,civic,public sector,citizen,municipal,voting",high,"Procurement rules;Security clearance;Accessibility (508);FedRAMP;Privacy;Transparency","Government procurement;Security frameworks;Accessibility standards;Privacy laws;Open data requirements","domain-research","government software procurement {date};FedRAMP compliance requirements;section 508 accessibility;government security standards","procurement_compliance;security_clearance;accessibility_standards;transparency_requirements"
5
- edtech,"education,learning,student,teacher,curriculum,assessment,K-12,university,LMS",medium,"Student privacy (COPPA/FERPA);Accessibility;Content moderation;Age verification;Curriculum standards","Educational privacy laws;Learning standards;Accessibility requirements;Content guidelines;Assessment validity","domain-research","educational software privacy {date};COPPA FERPA compliance;WCAG education requirements;learning management standards","privacy_compliance;content_guidelines;accessibility_features;curriculum_alignment"
6
- aerospace,"aircraft,spacecraft,aviation,drone,satellite,propulsion,flight,radar,navigation",high,"Safety certification;DO-178C compliance;Performance validation;Simulation accuracy;Export controls","Aviation standards;Safety analysis;Simulation validation;ITAR/export controls;Performance requirements","domain-research + technical-model","DO-178C software certification;aerospace simulation standards {date};ITAR export controls software;aviation safety requirements","safety_certification;simulation_validation;performance_requirements;export_compliance"
7
- automotive,"vehicle,car,autonomous,ADAS,automotive,driving,EV,charging",high,"Safety standards;ISO 26262;V2X communication;Real-time requirements;Certification","Automotive standards;Functional safety;V2X protocols;Real-time systems;Testing requirements","domain-research","ISO 26262 automotive software;automotive safety standards {date};V2X communication protocols;EV charging standards","safety_standards;functional_safety;communication_protocols;certification_requirements"
8
- scientific,"research,algorithm,simulation,modeling,computational,analysis,data science,ML,AI",medium,"Reproducibility;Validation methodology;Peer review;Performance;Accuracy;Computational resources","Scientific method;Statistical validity;Computational requirements;Domain expertise;Publication standards","technical-model","scientific computing best practices {date};research reproducibility standards;computational modeling validation;peer review software","validation_methodology;accuracy_metrics;reproducibility_plan;computational_requirements"
9
- legaltech,"legal,law,contract,compliance,litigation,patent,attorney,court",high,"Legal ethics;Bar regulations;Data retention;Attorney-client privilege;Court system integration","Legal practice rules;Ethics requirements;Court filing systems;Document standards;Confidentiality","domain-research","legal technology ethics {date};law practice management software requirements;court filing system standards;attorney client privilege technology","ethics_compliance;data_retention;confidentiality_measures;court_integration"
10
- insuretech,"insurance,claims,underwriting,actuarial,policy,risk,premium",high,"Insurance regulations;Actuarial standards;Data privacy;Fraud detection;State compliance","Insurance regulations by state;Actuarial methods;Risk modeling;Claims processing;Regulatory reporting","domain-research","insurance software regulations {date};actuarial standards software;insurance fraud detection;state insurance compliance","regulatory_requirements;risk_modeling;fraud_detection;reporting_compliance"
11
- energy,"energy,utility,grid,solar,wind,power,electricity,oil,gas",high,"Grid compliance;NERC standards;Environmental regulations;Safety requirements;Real-time operations","Energy regulations;Grid standards;Environmental compliance;Safety protocols;SCADA systems","domain-research","energy sector software compliance {date};NERC CIP standards;smart grid requirements;renewable energy software standards","grid_compliance;safety_protocols;environmental_compliance;operational_requirements"
12
- process_control,"industrial automation,process control,PLC,SCADA,DCS,HMI,operational technology,OT,control system,cyberphysical,MES,historian,instrumentation,I&C,P&ID",high,"Functional safety;OT cybersecurity;Real-time control requirements;Legacy system integration;Process safety and hazard analysis;Environmental compliance and permitting;Engineering authority and PE requirements","Functional safety standards;OT security frameworks;Industrial protocols;Process control architecture;Plant reliability and maintainability","domain-research + technical-model","IEC 62443 OT cybersecurity requirements {date};functional safety software requirements {date};industrial process control architecture;ISA-95 manufacturing integration","functional_safety;ot_security;process_requirements;engineering_authority"
13
- building_automation,"building automation,BAS,BMS,HVAC,smart building,lighting control,fire alarm,fire protection,fire suppression,life safety,elevator,access control,DDC,energy management,sequence of operations,commissioning",high,"Life safety codes;Building energy standards;Multi-trade coordination and interoperability;Commissioning and ongoing operational performance;Indoor environmental quality and occupant comfort;Engineering authority and PE requirements","Building automation protocols;HVAC and mechanical controls;Fire alarm, fire protection, and life safety design;Commissioning process and sequence of operations;Building codes and energy standards","domain-research","smart building software architecture {date};BACnet integration best practices;building automation cybersecurity {date};ASHRAE building standards","life_safety;energy_compliance;commissioning_requirements;engineering_authority"
14
- gaming,"game,player,gameplay,level,character,multiplayer,quest",redirect,"REDIRECT TO GAME WORKFLOWS","Game design","game-brief","NA","NA"
15
- general,"",low,"Standard requirements;Basic security;User experience;Performance","General software practices","continue","software development best practices {date}","standard_requirements"
@@ -1,197 +0,0 @@
1
- # BMAD PRD Purpose
2
-
3
- **The PRD is the top of the required funnel that feeds all subsequent product development work in rhw BMad Method.**
4
-
5
- ---
6
-
7
- ## What is a BMAD PRD?
8
-
9
- A dual-audience document serving:
10
- 1. **Human Product Managers and builders** - Vision, strategy, stakeholder communication
11
- 2. **LLM Downstream Consumption** - UX Design → Architecture → Epics → Development AI Agents
12
-
13
- Each successive document becomes more AI-tailored and granular.
14
-
15
- ---
16
-
17
- ## Core Philosophy: Information Density
18
-
19
- **High Signal-to-Noise Ratio**
20
-
21
- Every sentence must carry information weight. LLMs consume precise, dense content efficiently.
22
-
23
- **Anti-Patterns (Eliminate These):**
24
- - ❌ "The system will allow users to..." → ✅ "Users can..."
25
- - ❌ "It is important to note that..." → ✅ State the fact directly
26
- - ❌ "In order to..." → ✅ "To..."
27
- - ❌ Conversational filler and padding → ✅ Direct, concise statements
28
-
29
- **Goal:** Maximum information per word. Zero fluff.
30
-
31
- ---
32
-
33
- ## The Traceability Chain
34
-
35
- **PRD starts the chain:**
36
- ```
37
- Vision → Success Criteria → User Journeys → Functional Requirements → (future: User Stories)
38
- ```
39
-
40
- **In the PRD, establish:**
41
- - Vision → Success Criteria alignment
42
- - Success Criteria → User Journey coverage
43
- - User Journey → Functional Requirement mapping
44
- - All requirements traceable to user needs
45
-
46
- **Why:** Each downstream artifact (UX, Architecture, Epics, Stories) must trace back to documented user needs and business objectives. This chain ensures we build the right thing.
47
-
48
- ---
49
-
50
- ## What Makes Great Functional Requirements?
51
-
52
- ### FRs are Capabilities, Not Implementation
53
-
54
- **Good FR:** "Users can reset their password via email link"
55
- **Bad FR:** "System sends JWT via email and validates with database" (implementation leakage)
56
-
57
- **Good FR:** "Dashboard loads in under 2 seconds for 95th percentile"
58
- **Bad FR:** "Fast loading time" (subjective, unmeasurable)
59
-
60
- ### SMART Quality Criteria
61
-
62
- **Specific:** Clear, precisely defined capability
63
- **Measurable:** Quantifiable with test criteria
64
- **Attainable:** Realistic within constraints
65
- **Relevant:** Aligns with business objectives
66
- **Traceable:** Links to source (executive summary or user journey)
67
-
68
- ### FR Anti-Patterns
69
-
70
- **Subjective Adjectives:**
71
- - ❌ "easy to use", "intuitive", "user-friendly", "fast", "responsive"
72
- - ✅ Use metrics: "completes task in under 3 clicks", "loads in under 2 seconds"
73
-
74
- **Implementation Leakage:**
75
- - ❌ Technology names, specific libraries, implementation details
76
- - ✅ Focus on capability and measurable outcomes
77
-
78
- **Vague Quantifiers:**
79
- - ❌ "multiple users", "several options", "various formats"
80
- - ✅ "up to 100 concurrent users", "3-5 options", "PDF, DOCX, TXT formats"
81
-
82
- **Missing Test Criteria:**
83
- - ❌ "The system shall provide notifications"
84
- - ✅ "The system shall send email notifications within 30 seconds of trigger event"
85
-
86
- ---
87
-
88
- ## What Makes Great Non-Functional Requirements?
89
-
90
- ### NFRs Must Be Measurable
91
-
92
- **Template:**
93
- ```
94
- "The system shall [metric] [condition] [measurement method]"
95
- ```
96
-
97
- **Examples:**
98
- - ✅ "The system shall respond to API requests in under 200ms for 95th percentile as measured by APM monitoring"
99
- - ✅ "The system shall maintain 99.9% uptime during business hours as measured by cloud provider SLA"
100
- - ✅ "The system shall support 10,000 concurrent users as measured by load testing"
101
-
102
- ### NFR Anti-Patterns
103
-
104
- **Unmeasurable Claims:**
105
- - ❌ "The system shall be scalable" → ✅ "The system shall handle 10x load growth through horizontal scaling"
106
- - ❌ "High availability required" → ✅ "99.9% uptime as measured by cloud provider SLA"
107
-
108
- **Missing Context:**
109
- - ❌ "Response time under 1 second" → ✅ "API response time under 1 second for 95th percentile under normal load"
110
-
111
- ---
112
-
113
- ## Domain-Specific Requirements
114
-
115
- **Auto-Detect and Enforce Based on Project Context**
116
-
117
- Certain industries have mandatory requirements that must be present:
118
-
119
- - **Healthcare:** HIPAA Privacy & Security Rules, PHI encryption, audit logging, MFA
120
- - **Fintech:** PCI-DSS Level 1, AML/KYC compliance, SOX controls, financial audit trails
121
- - **GovTech:** NIST framework, Section 508 accessibility (WCAG 2.1 AA), FedRAMP, data residency
122
- - **E-Commerce:** PCI-DSS for payments, inventory accuracy, tax calculation by jurisdiction
123
-
124
- **Why:** Missing these requirements in the PRD means they'll be missed in architecture and implementation, creating expensive rework. During PRD creation there is a step to cover this - during validation we want to make sure it was covered. For this purpose steps will utilize a domain-complexity.csv and project-types.csv.
125
-
126
- ---
127
-
128
- ## Document Structure (Markdown, Human-Readable)
129
-
130
- ### Required Sections
131
- 1. **Executive Summary** - Vision, differentiator, target users
132
- 2. **Success Criteria** - Measurable outcomes (SMART)
133
- 3. **Product Scope** - MVP, Growth, Vision phases
134
- 4. **User Journeys** - Comprehensive coverage
135
- 5. **Domain Requirements** - Industry-specific compliance (if applicable)
136
- 6. **Innovation Analysis** - Competitive differentiation (if applicable)
137
- 7. **Project-Type Requirements** - Platform-specific needs
138
- 8. **Functional Requirements** - Capability contract (FRs)
139
- 9. **Non-Functional Requirements** - Quality attributes (NFRs)
140
-
141
- ### Formatting for Dual Consumption
142
-
143
- **For Humans:**
144
- - Clear, professional language
145
- - Logical flow from vision to requirements
146
- - Easy for stakeholders to review and approve
147
-
148
- **For LLMs:**
149
- - ## Level 2 headers for all main sections (enables extraction)
150
- - Consistent structure and patterns
151
- - Precise, testable language
152
- - High information density
153
-
154
- ---
155
-
156
- ## Downstream Impact
157
-
158
- **How the PRD Feeds Next Artifacts:**
159
-
160
- **UX Design:**
161
- - User journeys → interaction flows
162
- - FRs → design requirements
163
- - Success criteria → UX metrics
164
-
165
- **Architecture:**
166
- - FRs → system capabilities
167
- - NFRs → architecture decisions
168
- - Domain requirements → compliance architecture
169
- - Project-type requirements → platform choices
170
-
171
- **Epics & Stories (created after architecture):**
172
- - FRs → user stories (1 FR could map to 1-3 stories potentially)
173
- - Acceptance criteria → story acceptance tests
174
- - Priority → sprint sequencing
175
- - Traceability → stories map back to vision
176
-
177
- **Development AI Agents:**
178
- - Precise requirements → implementation clarity
179
- - Test criteria → automated test generation
180
- - Domain requirements → compliance enforcement
181
- - Measurable NFRs → performance targets
182
-
183
- ---
184
-
185
- ## Summary: What Makes a Great BMAD PRD?
186
-
187
- ✅ **High Information Density** - Every sentence carries weight, zero fluff
188
- ✅ **Measurable Requirements** - All FRs and NFRs are testable with specific criteria
189
- ✅ **Clear Traceability** - Each requirement links to user need and business objective
190
- ✅ **Domain Awareness** - Industry-specific requirements auto-detected and included
191
- ✅ **Zero Anti-Patterns** - No subjective adjectives, implementation leakage, or vague quantifiers
192
- ✅ **Dual Audience Optimized** - Human-readable AND LLM-consumable
193
- ✅ **Markdown Format** - Professional, clean, accessible to all stakeholders
194
-
195
- ---
196
-
197
- **Remember:** The PRD is the foundation. Quality here ripples through every subsequent phase. A dense, precise, well-traced PRD makes UX design, architecture, epic breakdown, and AI development dramatically more effective.
@@ -1,11 +0,0 @@
1
- project_type,detection_signals,key_questions,required_sections,skip_sections,web_search_triggers,innovation_signals
2
- api_backend,"API,REST,GraphQL,backend,service,endpoints","Endpoints needed?;Authentication method?;Data formats?;Rate limits?;Versioning?;SDK needed?","endpoint_specs;auth_model;data_schemas;error_codes;rate_limits;api_docs","ux_ui;visual_design;user_journeys","framework best practices;OpenAPI standards","API composition;New protocol"
3
- mobile_app,"iOS,Android,app,mobile,iPhone,iPad","Native or cross-platform?;Offline needed?;Push notifications?;Device features?;Store compliance?","platform_reqs;device_permissions;offline_mode;push_strategy;store_compliance","desktop_features;cli_commands","app store guidelines;platform requirements","Gesture innovation;AR/VR features"
4
- saas_b2b,"SaaS,B2B,platform,dashboard,teams,enterprise","Multi-tenant?;Permission model?;Subscription tiers?;Integrations?;Compliance?","tenant_model;rbac_matrix;subscription_tiers;integration_list;compliance_reqs","cli_interface;mobile_first","compliance requirements;integration guides","Workflow automation;AI agents"
5
- developer_tool,"SDK,library,package,npm,pip,framework","Language support?;Package managers?;IDE integration?;Documentation?;Examples?","language_matrix;installation_methods;api_surface;code_examples;migration_guide","visual_design;store_compliance","package manager best practices;API design patterns","New paradigm;DSL creation"
6
- cli_tool,"CLI,command,terminal,bash,script","Interactive or scriptable?;Output formats?;Config method?;Shell completion?","command_structure;output_formats;config_schema;scripting_support","visual_design;ux_principles;touch_interactions","CLI design patterns;shell integration","Natural language CLI;AI commands"
7
- web_app,"website,webapp,browser,SPA,PWA","SPA or MPA?;Browser support?;SEO needed?;Real-time?;Accessibility?","browser_matrix;responsive_design;performance_targets;seo_strategy;accessibility_level","native_features;cli_commands","web standards;WCAG guidelines","New interaction;WebAssembly use"
8
- game,"game,player,gameplay,level,character","REDIRECT TO USE THE BMad Method Game Module Agent and Workflows - HALT","game-brief;GDD","most_sections","game design patterns","Novel mechanics;Genre mixing"
9
- desktop_app,"desktop,Windows,Mac,Linux,native","Cross-platform?;Auto-update?;System integration?;Offline?","platform_support;system_integration;update_strategy;offline_capabilities","web_seo;mobile_features","desktop guidelines;platform requirements","Desktop AI;System automation"
10
- iot_embedded,"IoT,embedded,device,sensor,hardware","Hardware specs?;Connectivity?;Power constraints?;Security?;OTA updates?","hardware_reqs;connectivity_protocol;power_profile;security_model;update_mechanism","visual_ui;browser_support","IoT standards;protocol specs","Edge AI;New sensors"
11
- blockchain_web3,"blockchain,crypto,DeFi,NFT,smart contract","Chain selection?;Wallet integration?;Gas optimization?;Security audit?","chain_specs;wallet_support;smart_contracts;security_audit;gas_optimization","traditional_auth;centralized_db","blockchain standards;security patterns","Novel tokenomics;DAO structure"