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.
- package/.claude-plugin/marketplace.json +0 -1
- package/package.json +1 -1
- package/src/bmm-skills/1-analysis/bmad-agent-analyst/SKILL.md +6 -4
- package/src/bmm-skills/1-analysis/bmad-agent-tech-writer/SKILL.md +6 -4
- package/src/bmm-skills/1-analysis/bmad-document-project/workflow.md +8 -10
- package/src/bmm-skills/1-analysis/bmad-prfaq/SKILL.md +12 -9
- package/src/bmm-skills/1-analysis/bmad-product-brief/SKILL.md +1 -6
- package/src/bmm-skills/1-analysis/research/bmad-domain-research/workflow.md +8 -6
- package/src/bmm-skills/1-analysis/research/bmad-market-research/workflow.md +8 -6
- package/src/bmm-skills/1-analysis/research/bmad-technical-research/workflow.md +8 -6
- package/src/bmm-skills/2-plan-workflows/bmad-agent-pm/SKILL.md +6 -4
- package/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/SKILL.md +6 -4
- package/src/bmm-skills/2-plan-workflows/bmad-create-prd/workflow.md +8 -9
- package/src/bmm-skills/2-plan-workflows/bmad-create-ux-design/workflow.md +8 -9
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +1 -1
- package/src/bmm-skills/2-plan-workflows/bmad-edit-prd/workflow.md +8 -9
- package/src/bmm-skills/2-plan-workflows/bmad-validate-prd/workflow.md +8 -9
- package/src/bmm-skills/3-solutioning/bmad-agent-architect/SKILL.md +6 -4
- package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/workflow.md +8 -10
- package/src/bmm-skills/3-solutioning/bmad-create-architecture/workflow.md +8 -14
- package/src/bmm-skills/3-solutioning/bmad-create-epics-and-stories/workflow.md +10 -12
- package/src/bmm-skills/3-solutioning/bmad-generate-project-context/workflow.md +8 -12
- package/src/bmm-skills/4-implementation/bmad-agent-dev/SKILL.md +6 -4
- package/src/bmm-skills/4-implementation/bmad-agent-qa/SKILL.md +6 -4
- package/src/bmm-skills/4-implementation/bmad-agent-quick-flow-solo-dev/SKILL.md +6 -4
- package/src/bmm-skills/4-implementation/bmad-agent-sm/SKILL.md +6 -4
- package/src/core-skills/bmad-advanced-elicitation/SKILL.md +1 -2
- package/src/core-skills/bmad-distillator/SKILL.md +0 -1
- package/src/core-skills/bmad-distillator/resources/distillate-format-reference.md +9 -9
- package/src/core-skills/bmad-party-mode/SKILL.md +119 -2
- package/src/bmm-skills/2-plan-workflows/create-prd/data/domain-complexity.csv +0 -15
- package/src/bmm-skills/2-plan-workflows/create-prd/data/prd-purpose.md +0 -197
- package/src/bmm-skills/2-plan-workflows/create-prd/data/project-types.csv +0 -11
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +0 -224
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md +0 -191
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md +0 -209
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md +0 -174
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md +0 -214
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md +0 -228
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md +0 -217
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md +0 -205
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md +0 -243
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md +0 -263
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md +0 -209
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +0 -264
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md +0 -242
- package/src/bmm-skills/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +0 -232
- package/src/bmm-skills/2-plan-workflows/create-prd/workflow-validate-prd.md +0 -65
- package/src/core-skills/bmad-init/SKILL.md +0 -100
- package/src/core-skills/bmad-init/resources/core-module.yaml +0 -25
- package/src/core-skills/bmad-init/scripts/bmad_init.py +0 -624
- package/src/core-skills/bmad-init/scripts/tests/test_bmad_init.py +0 -393
- package/src/core-skills/bmad-party-mode/steps/step-01-agent-loading.md +0 -138
- package/src/core-skills/bmad-party-mode/steps/step-02-discussion-orchestration.md +0 -187
- package/src/core-skills/bmad-party-mode/steps/step-03-graceful-exit.md +0 -167
- 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.
|
|
41
|
-
- Use `{user_name}`
|
|
42
|
-
- Use `{communication_language}`
|
|
43
|
-
-
|
|
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
|
|
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-
|
|
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-
|
|
90
|
-
(solves
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
|
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
|
-
|
|
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"
|