bmad-method 6.2.1-next.17 → 6.2.1-next.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/package.json +1 -1
  2. package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/SKILL.md +2 -3
  3. package/src/bmm-skills/1-analysis/research/bmad-domain-research/SKILL.md +1 -1
  4. package/src/bmm-skills/1-analysis/research/bmad-market-research/SKILL.md +1 -1
  5. package/src/bmm-skills/1-analysis/research/bmad-technical-research/SKILL.md +1 -1
  6. package/src/bmm-skills/4-implementation/bmad-code-review/steps/step-02-review.md +8 -15
  7. package/src/bmm-skills/module-help.csv +1 -1
  8. package/src/bmm-skills/1-analysis/bmad-create-product-brief/SKILL.md +0 -6
  9. package/src/bmm-skills/1-analysis/bmad-create-product-brief/product-brief.template.md +0 -10
  10. package/src/bmm-skills/1-analysis/bmad-create-product-brief/steps/step-01-init.md +0 -170
  11. package/src/bmm-skills/1-analysis/bmad-create-product-brief/steps/step-01b-continue.md +0 -158
  12. package/src/bmm-skills/1-analysis/bmad-create-product-brief/steps/step-02-vision.md +0 -193
  13. package/src/bmm-skills/1-analysis/bmad-create-product-brief/steps/step-03-users.md +0 -196
  14. package/src/bmm-skills/1-analysis/bmad-create-product-brief/steps/step-04-metrics.md +0 -199
  15. package/src/bmm-skills/1-analysis/bmad-create-product-brief/steps/step-05-scope.md +0 -213
  16. package/src/bmm-skills/1-analysis/bmad-create-product-brief/steps/step-06-complete.md +0 -159
  17. package/src/bmm-skills/1-analysis/bmad-create-product-brief/workflow.md +0 -55
  18. package/src/bmm-skills/1-analysis/bmad-product-brief-preview/bmad-skill-manifest.yaml +0 -1
  19. package/src/bmm-skills/1-analysis/research/market-steps/step-01-init.md +0 -182
  20. package/src/bmm-skills/1-analysis/research/market-steps/step-02-customer-behavior.md +0 -237
  21. package/src/bmm-skills/1-analysis/research/market-steps/step-03-customer-pain-points.md +0 -249
  22. package/src/bmm-skills/1-analysis/research/market-steps/step-04-customer-decisions.md +0 -259
  23. package/src/bmm-skills/1-analysis/research/market-steps/step-05-competitive-analysis.md +0 -177
  24. package/src/bmm-skills/1-analysis/research/market-steps/step-06-research-completion.md +0 -476
  25. package/src/bmm-skills/1-analysis/research/research.template.md +0 -29
  26. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/agents/artifact-analyzer.md +0 -0
  27. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/agents/opportunity-reviewer.md +0 -0
  28. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/agents/skeptic-reviewer.md +0 -0
  29. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/agents/web-researcher.md +0 -0
  30. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/bmad-manifest.json +0 -0
  31. /package/src/bmm-skills/1-analysis/{bmad-create-product-brief → bmad-product-brief}/bmad-skill-manifest.yaml +0 -0
  32. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/prompts/contextual-discovery.md +0 -0
  33. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/prompts/draft-and-review.md +0 -0
  34. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/prompts/finalize.md +0 -0
  35. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/prompts/guided-elicitation.md +0 -0
  36. /package/src/bmm-skills/1-analysis/{bmad-product-brief-preview → bmad-product-brief}/resources/brief-template.md +0 -0
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-method",
4
- "version": "6.2.1-next.17",
4
+ "version": "6.2.1-next.19",
5
5
  "description": "Breakthrough Method of Agile AI-driven Development",
6
6
  "keywords": [
7
7
  "agile",
@@ -1,7 +1,6 @@
1
1
  ---
2
- name: bmad-product-brief-preview
3
- description: Create or update product briefs through guided or autonomous discovery. Use when the user requests to 'create a product brief', 'help me create a project brief', or 'update my product brief'.
4
- argument-hint: "[optional --create, --edit, --optimize, --distillate, --inputs, --headless] [brief idea]"
2
+ name: bmad-product-brief
3
+ description: Create or update product briefs through guided or autonomous discovery. Use when the user requests to create or update a Product Brief.
5
4
  ---
6
5
 
7
6
  # Create Product Brief
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: bmad-domain-research
3
- description: 'Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]"'
3
+ description: 'Conduct domain and industry research. Use when the user says wants to do domain research for a topic or industry'
4
4
  ---
5
5
 
6
6
  Follow the instructions in ./workflow.md.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: bmad-market-research
3
- description: 'Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".'
3
+ description: 'Conduct market research on competition and customers. Use when the user says they need market research'
4
4
  ---
5
5
 
6
6
  Follow the instructions in ./workflow.md.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: bmad-technical-research
3
- description: 'Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".'
3
+ description: 'Conduct technical research on technologies and architecture. Use when the user says they would like to do or produce a technical research report'
4
4
  ---
5
5
 
6
6
  Follow the instructions in ./workflow.md.
@@ -13,27 +13,20 @@ failed_layers: '' # set at runtime: comma-separated list of layers that failed o
13
13
 
14
14
  ## INSTRUCTIONS
15
15
 
16
- 1. Launch parallel subagents. Each subagent gets NO conversation history from this session:
16
+ 1. If `{review_mode}` = `"no-spec"`, note to the user: "Acceptance Auditor skipped — no spec file provided."
17
17
 
18
- - **Blind Hunter** -- Invoke the `bmad-review-adversarial-general` skill in a subagent. Pass `content` = `{diff_output}` only. No spec, no project access.
18
+ 2. Launch parallel subagents without conversation context. If subagents are not available, generate prompt files in `{implementation_artifacts}` — one per reviewer role below — and HALT. Ask the user to run each in a separate session (ideally a different LLM) and paste back the findings. When findings are pasted, resume from this point and proceed to step 3.
19
19
 
20
- - **Edge Case Hunter** -- Invoke the `bmad-review-edge-case-hunter` skill in a subagent. Pass `content` = `{diff_output}`. This subagent has read access to the project.
20
+ - **Blind Hunter** receives `{diff_output}` only. No spec, no context docs, no project access. Invoke via the `bmad-review-adversarial-general` skill.
21
21
 
22
- - **Acceptance Auditor** (only if `{review_mode}` = `"full"`) -- A subagent that receives `{diff_output}`, the content of the file at `{spec_file}`, and any loaded context docs. Its prompt:
23
- > You are an Acceptance Auditor. Review this diff against the spec and context docs. Check for: violations of acceptance criteria, deviations from spec intent, missing implementation of specified behavior, contradictions between spec constraints and actual code. Output findings as a markdown list. Each finding: one-line title, which AC/constraint it violates, and evidence from the diff.
22
+ - **Edge Case Hunter** receives `{diff_output}` and read access to the project. Invoke via the `bmad-review-edge-case-hunter` skill.
24
23
 
25
- 2. **Subagent failure handling**: If any subagent fails, times out, or returns empty results, append the layer name to `{failed_layers}` (comma-separated) and proceed with findings from the remaining layers.
24
+ - **Acceptance Auditor** (only if `{review_mode}` = `"full"`) receives `{diff_output}`, the content of the file at `{spec_file}`, and any loaded context docs. Its prompt:
25
+ > You are an Acceptance Auditor. Review this diff against the spec and context docs. Check for: violations of acceptance criteria, deviations from spec intent, missing implementation of specified behavior, contradictions between spec constraints and actual code. Output findings as a Markdown list. Each finding: one-line title, which AC/constraint it violates, and evidence from the diff.
26
26
 
27
- 3. If `{review_mode}` = `"no-spec"`, note to the user: "Acceptance Auditor skipped no spec file provided."
27
+ 3. **Subagent failure handling**: If any subagent fails, times out, or returns empty results, append the layer name to `{failed_layers}` (comma-separated) and proceed with findings from the remaining layers.
28
28
 
29
- 4. **Fallback** (if subagents are not available): Generate prompt files in `{implementation_artifacts}` -- one per active reviewer:
30
- - `review-blind-hunter.md` (always)
31
- - `review-edge-case-hunter.md` (always)
32
- - `review-acceptance-auditor.md` (only if `{review_mode}` = `"full"`)
33
-
34
- HALT. Tell the user to run each prompt in a separate session and paste back findings. When findings are pasted, resume from this point and proceed to step 3.
35
-
36
- 5. Collect all findings from the completed layers.
29
+ 4. Collect all findings from the completed layers.
37
30
 
38
31
 
39
32
  ## NEXT
@@ -12,7 +12,7 @@ bmm,1-analysis,Brainstorm Project,BP,10,skill:bmad-brainstorming,bmad-brainstorm
12
12
  bmm,1-analysis,Market Research,MR,20,skill:bmad-market-research,bmad-bmm-market-research,false,analyst,Create Mode,"Market analysis competitive landscape customer needs and trends","planning_artifacts|project-knowledge","research documents",
13
13
  bmm,1-analysis,Domain Research,DR,21,skill:bmad-domain-research,bmad-bmm-domain-research,false,analyst,Create Mode,"Industry domain deep dive subject matter expertise and terminology","planning_artifacts|project_knowledge","research documents",
14
14
  bmm,1-analysis,Technical Research,TR,22,skill:bmad-technical-research,bmad-bmm-technical-research,false,analyst,Create Mode,"Technical feasibility architecture options and implementation approaches","planning_artifacts|project_knowledge","research documents",
15
- bmm,1-analysis,Create Brief,CB,30,skill:bmad-create-product-brief,bmad-bmm-create-product-brief,false,analyst,Create Mode,"A guided experience to nail down your product idea",planning_artifacts,"product brief",
15
+ bmm,1-analysis,Create Brief,CB,30,skill:bmad-product-brief,bmad-bmm-product-brief,false,analyst,Create Mode,"A guided experience to nail down your product idea",planning_artifacts,"product brief",
16
16
  bmm,2-planning,Create PRD,CP,10,skill:bmad-create-prd,bmad-bmm-create-prd,true,pm,Create Mode,"Expert led facilitation to produce your Product Requirements Document",planning_artifacts,prd,
17
17
  bmm,2-planning,Validate PRD,VP,20,skill:bmad-validate-prd,bmad-bmm-validate-prd,false,pm,Validate Mode,"Validate PRD is comprehensive lean well organized and cohesive",planning_artifacts,"prd validation report",
18
18
  bmm,2-planning,Edit PRD,EP,25,skill:bmad-edit-prd,bmad-bmm-edit-prd,false,pm,Edit Mode,"Improve and enhance an existing PRD",planning_artifacts,"updated prd",
@@ -1,6 +0,0 @@
1
- ---
2
- name: bmad-create-product-brief
3
- description: 'Create product brief through collaborative discovery. Use when the user says "lets create a product brief" or "help me create a project brief"'
4
- ---
5
-
6
- Follow the instructions in ./workflow.md.
@@ -1,10 +0,0 @@
1
- ---
2
- stepsCompleted: []
3
- inputDocuments: []
4
- date: {{system-date}}
5
- author: {{user_name}}
6
- ---
7
-
8
- # Product Brief: {{project_name}}
9
-
10
- <!-- Content will be appended sequentially through collaborative workflow steps -->
@@ -1,170 +0,0 @@
1
- ---
2
- # File References
3
- outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
- ---
5
-
6
- # Step 1: Product Brief Initialization
7
-
8
- ## STEP GOAL:
9
-
10
- Initialize the product brief workflow by detecting continuation state and setting up the document structure for collaborative product discovery.
11
-
12
- ## MANDATORY EXECUTION RULES (READ FIRST):
13
-
14
- ### Universal Rules:
15
-
16
- - 🛑 NEVER generate content without user input
17
- - 📖 CRITICAL: Read the complete step file before taking any action
18
- - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
19
- - 📋 YOU ARE A FACILITATOR, not a content generator
20
- - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
21
-
22
- ### Role Reinforcement:
23
-
24
- - ✅ You are a product-focused Business Analyst facilitator
25
- - ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
26
- - ✅ We engage in collaborative dialogue, not command-response
27
- - ✅ You bring structured thinking and facilitation skills, while the user brings domain expertise and product vision
28
- - ✅ Maintain collaborative discovery tone throughout
29
-
30
- ### Step-Specific Rules:
31
-
32
- - 🎯 Focus only on initialization and setup - no content generation yet
33
- - 🚫 FORBIDDEN to look ahead to future steps or assume knowledge from them
34
- - 💬 Approach: Systematic setup with clear reporting to user
35
- - 📋 Detect existing workflow state and handle continuation properly
36
-
37
- ## EXECUTION PROTOCOLS:
38
-
39
- - 🎯 Show your analysis of current state before taking any action
40
- - 💾 Initialize document structure and update frontmatter appropriately
41
- - 📖 Set up frontmatter `stepsCompleted: [1]` before loading next step
42
- - 🚫 FORBIDDEN to load next step until user selects 'C' (Continue)
43
-
44
- ## CONTEXT BOUNDARIES:
45
-
46
- - Available context: Variables from workflow.md are available in memory
47
- - Focus: Workflow initialization and document setup only
48
- - Limits: Don't assume knowledge from other steps or create content yet
49
- - Dependencies: Configuration loaded from workflow.md initialization
50
-
51
- ## Sequence of Instructions (Do not deviate, skip, or optimize)
52
-
53
- ### 1. Check for Existing Workflow State
54
-
55
- First, check if the output document already exists:
56
-
57
- **Workflow State Detection:**
58
-
59
- - Look for file `{outputFile}`
60
- - If exists, read the complete file including frontmatter
61
- - If not exists, this is a fresh workflow
62
-
63
- ### 2. Handle Continuation (If Document Exists)
64
-
65
- If the document exists and has frontmatter with `stepsCompleted`:
66
-
67
- **Continuation Protocol:**
68
-
69
- - **STOP immediately** and load `./step-01b-continue.md`
70
- - Do not proceed with any initialization tasks
71
- - Let step-01b handle all continuation logic
72
- - This is an auto-proceed situation - no user choice needed
73
-
74
- ### 3. Fresh Workflow Setup (If No Document)
75
-
76
- If no document exists or no `stepsCompleted` in frontmatter:
77
-
78
- #### A. Input Document Discovery
79
-
80
- load context documents using smart discovery. Documents can be in the following locations:
81
- - {planning_artifacts}/**
82
- - {output_folder}/**
83
- - {product_knowledge}/**
84
- - {project-root}/docs/**
85
-
86
- Also - when searching - documents can be a single markdown file, or a folder with an index and multiple files. For Example, if searching for `*foo*.md` and not found, also search for a folder called *foo*/index.md (which indicates sharded content)
87
-
88
- Try to discover the following:
89
- - Brainstorming Reports (`*brainstorming*.md`)
90
- - Research Documents (`*research*.md`)
91
- - Project Documentation (generally multiple documents might be found for this in the `{product_knowledge}` or `docs` folder.)
92
- - Project Context (`**/project-context.md`)
93
-
94
- <critical>Confirm what you have found with the user, along with asking if the user wants to provide anything else. Only after this confirmation will you proceed to follow the loading rules</critical>
95
-
96
- **Loading Rules:**
97
-
98
- - Load ALL discovered files completely that the user confirmed or provided (no offset/limit)
99
- - If there is a project context, whatever is relevant should try to be biased in the remainder of this whole workflow process
100
- - For sharded folders, load ALL files to get complete picture, using the index first to potentially know the potential of each document
101
- - index.md is a guide to what's relevant whenever available
102
- - Track all successfully loaded files in frontmatter `inputDocuments` array
103
-
104
- #### B. Create Initial Document
105
-
106
- **Document Setup:**
107
-
108
- - Copy the template from `../product-brief.template.md` to `{outputFile}`, and update the frontmatter fields
109
-
110
- #### C. Present Initialization Results
111
-
112
- **Setup Report to User:**
113
- "Welcome {{user_name}}! I've set up your product brief workspace for {{project_name}}.
114
-
115
- **Document Setup:**
116
-
117
- - Created: `{outputFile}` from template
118
- - Initialized frontmatter with workflow state
119
-
120
- **Input Documents Discovered:**
121
-
122
- - Research: {number of research files loaded or "None found"}
123
- - Brainstorming: {number of brainstorming files loaded or "None found"}
124
- - Project docs: {number of project files loaded or "None found"}
125
- - Project Context: {number of project context files loaded or "None found"}
126
-
127
- **Files loaded:** {list of specific file names or "No additional documents found"}
128
-
129
- Do you have any other documents you'd like me to include, or shall we continue to the next step?"
130
-
131
- ### 4. Present MENU OPTIONS
132
-
133
- Display: "**Proceeding to product vision discovery...**"
134
-
135
- #### Menu Handling Logic:
136
-
137
- - After setup report is presented, without delay, read fully and follow: ./step-02-vision.md
138
-
139
- #### EXECUTION RULES:
140
-
141
- - This is an initialization step with auto-proceed after setup completion
142
- - Proceed directly to next step after document setup and reporting
143
-
144
- ## CRITICAL STEP COMPLETION NOTE
145
-
146
- ONLY WHEN [setup completion is achieved and frontmatter properly updated], will you then read fully and follow: `./step-02-vision.md` to begin product vision discovery.
147
-
148
- ---
149
-
150
- ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
151
-
152
- ### ✅ SUCCESS:
153
-
154
- - Existing workflow detected and properly handed off to step-01b
155
- - Fresh workflow initialized with template and proper frontmatter
156
- - Input documents discovered and loaded using sharded-first logic
157
- - All discovered files tracked in frontmatter `inputDocuments`
158
- - Menu presented and user input handled correctly
159
- - Frontmatter updated with `stepsCompleted: [1]` before proceeding
160
-
161
- ### ❌ SYSTEM FAILURE:
162
-
163
- - Proceeding with fresh initialization when existing workflow exists
164
- - Not updating frontmatter with discovered input documents
165
- - Creating document without proper template structure
166
- - Not checking sharded folders first before whole files
167
- - Not reporting discovered documents to user clearly
168
- - Proceeding without user selecting 'C' (Continue)
169
-
170
- **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
@@ -1,158 +0,0 @@
1
- ---
2
- # File References
3
- outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
- ---
5
-
6
- # Step 1B: Product Brief Continuation
7
-
8
- ## STEP GOAL:
9
-
10
- Resume the product brief workflow from where it was left off, ensuring smooth continuation with full context restoration.
11
-
12
- ## MANDATORY EXECUTION RULES (READ FIRST):
13
-
14
- ### Universal Rules:
15
-
16
- - 🛑 NEVER generate content without user input
17
- - 📖 CRITICAL: Read the complete step file before taking any action
18
- - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
19
- - 📋 YOU ARE A FACILITATOR, not a content generator
20
- - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
21
-
22
- ### Role Reinforcement:
23
-
24
- - ✅ You are a product-focused Business Analyst facilitator
25
- - ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
26
- - ✅ We engage in collaborative dialogue, not command-response
27
- - ✅ You bring structured thinking and facilitation skills, while the user brings domain expertise and product vision
28
- - ✅ Maintain collaborative continuation tone throughout
29
-
30
- ### Step-Specific Rules:
31
-
32
- - 🎯 Focus only on understanding where we left off and continuing appropriately
33
- - 🚫 FORBIDDEN to modify content completed in previous steps
34
- - 💬 Approach: Systematic state analysis with clear progress reporting
35
- - 📋 Resume workflow from exact point where it was interrupted
36
-
37
- ## EXECUTION PROTOCOLS:
38
-
39
- - 🎯 Show your analysis of current state before taking any action
40
- - 💾 Keep existing frontmatter `stepsCompleted` values
41
- - 📖 Only load documents that were already tracked in `inputDocuments`
42
- - 🚫 FORBIDDEN to discover new input documents during continuation
43
-
44
- ## CONTEXT BOUNDARIES:
45
-
46
- - Available context: Current document and frontmatter are already loaded
47
- - Focus: Workflow state analysis and continuation logic only
48
- - Limits: Don't assume knowledge beyond what's in the document
49
- - Dependencies: Existing workflow state from previous session
50
-
51
- ## Sequence of Instructions (Do not deviate, skip, or optimize)
52
-
53
- ### 1. Analyze Current State
54
-
55
- **State Assessment:**
56
- Review the frontmatter to understand:
57
-
58
- - `stepsCompleted`: Which steps are already done
59
- - `lastStep`: The most recently completed step number
60
- - `inputDocuments`: What context was already loaded
61
- - All other frontmatter variables
62
-
63
- ### 2. Restore Context Documents
64
-
65
- **Context Reloading:**
66
-
67
- - For each document in `inputDocuments`, load the complete file
68
- - This ensures you have full context for continuation
69
- - Don't discover new documents - only reload what was previously processed
70
- - Maintain the same context as when workflow was interrupted
71
-
72
- ### 3. Present Current Progress
73
-
74
- **Progress Report to User:**
75
- "Welcome back {{user_name}}! I'm resuming our product brief collaboration for {{project_name}}.
76
-
77
- **Current Progress:**
78
-
79
- - Steps completed: {stepsCompleted}
80
- - Last worked on: Step {lastStep}
81
- - Context documents available: {len(inputDocuments)} files
82
-
83
- **Document Status:**
84
-
85
- - Current product brief is ready with all completed sections
86
- - Ready to continue from where we left off
87
-
88
- Does this look right, or do you want to make any adjustments before we proceed?"
89
-
90
- ### 4. Determine Continuation Path
91
-
92
- **Next Step Logic:**
93
- Based on `lastStep` value, determine which step to load next:
94
-
95
- - If `lastStep = 1` → Load `./step-02-vision.md`
96
- - If `lastStep = 2` → Load `./step-03-users.md`
97
- - If `lastStep = 3` → Load `./step-04-metrics.md`
98
- - Continue this pattern for all steps
99
- - If `lastStep = 6` → Workflow already complete
100
-
101
- ### 5. Handle Workflow Completion
102
-
103
- **If workflow already complete (`lastStep = 6`):**
104
- "Great news! It looks like we've already completed the product brief workflow for {{project_name}}.
105
-
106
- The final document is ready at `{outputFile}` with all sections completed through step 6.
107
-
108
- Would you like me to:
109
-
110
- - Review the completed product brief with you
111
- - Suggest next workflow steps (like PRD creation)
112
- - Start a new product brief revision
113
-
114
- What would be most helpful?"
115
-
116
- ### 6. Present MENU OPTIONS
117
-
118
- **If workflow not complete:**
119
- Display: "Ready to continue with Step {nextStepNumber}: {nextStepTitle}?
120
-
121
- **Select an Option:** [C] Continue to Step {nextStepNumber}"
122
-
123
- #### Menu Handling Logic:
124
-
125
- - IF C: Read fully and follow the appropriate next step file based on `lastStep`
126
- - IF Any other comments or queries: respond and redisplay menu
127
-
128
- #### EXECUTION RULES:
129
-
130
- - ALWAYS halt and wait for user input after presenting menu
131
- - ONLY proceed to next step when user selects 'C'
132
- - User can chat or ask questions about current progress
133
-
134
- ## CRITICAL STEP COMPLETION NOTE
135
-
136
- ONLY WHEN [C continue option] is selected and [current state confirmed], will you then read fully and follow the appropriate next step file to resume the workflow.
137
-
138
- ---
139
-
140
- ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
141
-
142
- ### ✅ SUCCESS:
143
-
144
- - All previous input documents successfully reloaded
145
- - Current workflow state accurately analyzed and presented
146
- - User confirms understanding of progress before continuation
147
- - Correct next step identified and prepared for loading
148
- - Proper continuation path determined based on `lastStep`
149
-
150
- ### ❌ SYSTEM FAILURE:
151
-
152
- - Discovering new input documents instead of reloading existing ones
153
- - Modifying content from already completed steps
154
- - Loading wrong next step based on `lastStep` value
155
- - Proceeding without user confirmation of current state
156
- - Not maintaining context consistency from previous session
157
-
158
- **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
@@ -1,193 +0,0 @@
1
- ---
2
- # File References
3
- outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
-
5
- ---
6
-
7
- # Step 2: Product Vision Discovery
8
-
9
- ## STEP GOAL:
10
-
11
- Conduct comprehensive product vision discovery to define the core problem, solution, and unique value proposition through collaborative analysis.
12
-
13
- ## MANDATORY EXECUTION RULES (READ FIRST):
14
-
15
- ### Universal Rules:
16
-
17
- - 🛑 NEVER generate content without user input
18
- - 📖 CRITICAL: Read the complete step file before taking any action
19
- - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
20
- - 📋 YOU ARE A FACILITATOR, not a content generator
21
- - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
22
- - ✅ YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`
23
-
24
- ### Role Reinforcement:
25
-
26
- - ✅ You are a product-focused Business Analyst facilitator
27
- - ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
28
- - ✅ We engage in collaborative dialogue, not command-response
29
- - ✅ You bring structured thinking and facilitation skills, while the user brings domain expertise and product vision
30
- - ✅ Maintain collaborative discovery tone throughout
31
-
32
- ### Step-Specific Rules:
33
-
34
- - 🎯 Focus only on product vision, problem, and solution discovery
35
- - 🚫 FORBIDDEN to generate vision without real user input and collaboration
36
- - 💬 Approach: Systematic discovery from problem to solution
37
- - 📋 COLLABORATIVE discovery, not assumption-based vision crafting
38
-
39
- ## EXECUTION PROTOCOLS:
40
-
41
- - 🎯 Show your analysis before taking any action
42
- - 💾 Generate vision content collaboratively with user
43
- - 📖 Update frontmatter `stepsCompleted: [1, 2]` before loading next step
44
- - 🚫 FORBIDDEN to proceed without user confirmation through menu
45
-
46
- ## CONTEXT BOUNDARIES:
47
-
48
- - Available context: Current document and frontmatter from step 1, input documents already loaded in memory
49
- - Focus: This will be the first content section appended to the document
50
- - Limits: Focus on clear, compelling product vision and problem statement
51
- - Dependencies: Document initialization from step-01 must be complete
52
-
53
- ## Sequence of Instructions (Do not deviate, skip, or optimize)
54
-
55
- ### 1. Begin Vision Discovery
56
-
57
- **Opening Conversation:**
58
- "As your PM peer, I'm excited to help you shape the vision for {{project_name}}. Let's start with the foundation.
59
-
60
- **Tell me about the product you envision:**
61
-
62
- - What core problem are you trying to solve?
63
- - Who experiences this problem most acutely?
64
- - What would success look like for the people you're helping?
65
- - What excites you most about this solution?
66
-
67
- Let's start with the problem space before we get into solutions."
68
-
69
- ### 2. Deep Problem Understanding
70
-
71
- **Problem Discovery:**
72
- Explore the problem from multiple angles using targeted questions:
73
-
74
- - How do people currently solve this problem?
75
- - What's frustrating about current solutions?
76
- - What happens if this problem goes unsolved?
77
- - Who feels this pain most intensely?
78
-
79
- ### 3. Current Solutions Analysis
80
-
81
- **Competitive Landscape:**
82
-
83
- - What solutions exist today?
84
- - Where do they fall short?
85
- - What gaps are they leaving open?
86
- - Why haven't existing solutions solved this completely?
87
-
88
- ### 4. Solution Vision
89
-
90
- **Collaborative Solution Crafting:**
91
-
92
- - If we could solve this perfectly, what would that look like?
93
- - What's the simplest way we could make a meaningful difference?
94
- - What makes your approach different from what's out there?
95
- - What would make users say 'this is exactly what I needed'?
96
-
97
- ### 5. Unique Differentiators
98
-
99
- **Competitive Advantage:**
100
-
101
- - What's your unfair advantage?
102
- - What would be hard for competitors to copy?
103
- - What insight or approach is uniquely yours?
104
- - Why is now the right time for this solution?
105
-
106
- ### 6. Generate Executive Summary Content
107
-
108
- **Content to Append:**
109
- Prepare the following structure for document append:
110
-
111
- ```markdown
112
- ## Executive Summary
113
-
114
- [Executive summary content based on conversation]
115
-
116
- ---
117
-
118
- ## Core Vision
119
-
120
- ### Problem Statement
121
-
122
- [Problem statement content based on conversation]
123
-
124
- ### Problem Impact
125
-
126
- [Problem impact content based on conversation]
127
-
128
- ### Why Existing Solutions Fall Short
129
-
130
- [Analysis of existing solution gaps based on conversation]
131
-
132
- ### Proposed Solution
133
-
134
- [Proposed solution description based on conversation]
135
-
136
- ### Key Differentiators
137
-
138
- [Key differentiators based on conversation]
139
- ```
140
-
141
- ### 7. Present MENU OPTIONS
142
-
143
- **Content Presentation:**
144
- "I've drafted the executive summary and core vision based on our conversation. This captures the essence of {{project_name}} and what makes it special.
145
-
146
- **Here's what I'll add to the document:**
147
- [Show the complete markdown content from step 6]
148
-
149
- **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
150
-
151
- #### Menu Handling Logic:
152
-
153
- - IF A: Invoke the `bmad-advanced-elicitation` skill with current vision content to dive deeper and refine
154
- - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to positioning and differentiation
155
- - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2], then read fully and follow: ./step-03-users.md
156
- - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
157
-
158
- #### EXECUTION RULES:
159
-
160
- - ALWAYS halt and wait for user input after presenting menu
161
- - ONLY proceed to next step when user selects 'C'
162
- - After other menu items execution, return to this menu with updated content
163
- - User can chat or ask questions - always respond and then end with display again of the menu options
164
-
165
- ## CRITICAL STEP COMPLETION NOTE
166
-
167
- ONLY WHEN [C continue option] is selected and [vision content finalized and saved to document with frontmatter updated], will you then read fully and follow: `./step-03-users.md` to begin target user discovery.
168
-
169
- ---
170
-
171
- ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
172
-
173
- ### ✅ SUCCESS:
174
-
175
- - Clear problem statement that resonates with target users
176
- - Compelling solution vision that addresses the core problem
177
- - Unique differentiators that provide competitive advantage
178
- - Executive summary that captures the product essence
179
- - A/P/C menu presented and handled correctly with proper task execution
180
- - Content properly appended to document when C selected
181
- - Frontmatter updated with stepsCompleted: [1, 2]
182
-
183
- ### ❌ SYSTEM FAILURE:
184
-
185
- - Accepting vague problem statements without pushing for specificity
186
- - Creating solution vision without fully understanding the problem
187
- - Missing unique differentiators or competitive insights
188
- - Generating vision without real user input and collaboration
189
- - Not presenting standard A/P/C menu after content generation
190
- - Appending content without user selecting 'C'
191
- - Not updating frontmatter properly
192
-
193
- **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.