bmad-method 4.26.0 → 4.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/.vscode/settings.json +2 -0
  2. package/CHANGELOG.md +15 -0
  3. package/README.md +29 -282
  4. package/bmad-core/agents/analyst.md +3 -1
  5. package/bmad-core/agents/bmad-master.md +5 -1
  6. package/bmad-core/agents/bmad-orchestrator.md +1 -1
  7. package/bmad-core/core-config.yaml +1 -1
  8. package/bmad-core/data/bmad-kb.md +74 -15
  9. package/bmad-core/data/brainstorming-techniques.md +36 -0
  10. package/bmad-core/data/elicitation-methods.md +134 -0
  11. package/bmad-core/tasks/advanced-elicitation.md +82 -57
  12. package/bmad-core/tasks/facilitate-brainstorming-session.md +136 -0
  13. package/bmad-core/templates/architecture-tmpl.md +23 -23
  14. package/bmad-core/templates/brainstorming-output-tmpl.md +149 -0
  15. package/bmad-core/templates/prd-tmpl.md +6 -6
  16. package/bmad-core/templates/prd-tmpl2.yaml +202 -0
  17. package/bmad-core/utils/plan-management.md +9 -13
  18. package/bmad-core/workflows/greenfield-service.yaml +1 -1
  19. package/common/tasks/create-doc.md +4 -4
  20. package/common/tasks/create-doc2.md +65 -0
  21. package/common/utils/bmad-doc-template.md +296 -0
  22. package/dist/agents/analyst.txt +481 -305
  23. package/dist/agents/architect.txt +60 -59
  24. package/dist/agents/bmad-master.txt +694 -399
  25. package/dist/agents/bmad-orchestrator.txt +197 -116
  26. package/dist/agents/dev.txt +18 -17
  27. package/dist/agents/pm.txt +47 -46
  28. package/dist/agents/po.txt +31 -30
  29. package/dist/agents/qa.txt +15 -14
  30. package/dist/agents/sm.txt +23 -22
  31. package/dist/agents/ux-expert.txt +29 -28
  32. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +33 -32
  33. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +19 -18
  34. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +21 -20
  35. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +385 -297
  36. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +103 -77
  37. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +29 -28
  38. package/dist/teams/team-all.txt +610 -438
  39. package/dist/teams/team-fullstack.txt +597 -425
  40. package/dist/teams/team-ide-minimal.txt +238 -157
  41. package/dist/teams/team-no-ui.txt +583 -411
  42. package/docs/agentic-tools/github-copilot-guide.md +29 -9
  43. package/docs/bmad-workflow-guide.md +2 -2
  44. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  45. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +2 -2
  46. package/expansion-packs/bmad-creator-tools/config.yaml +1 -1
  47. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  48. package/package.json +1 -1
  49. package/tools/builders/web-builder.js +117 -22
  50. package/tools/installer/config/install.config.yaml +2 -2
  51. package/tools/installer/lib/ide-setup.js +2 -2
  52. package/tools/installer/package.json +1 -1
  53. package/tools/lib/dependency-resolver.js +3 -3
  54. package/tools/md-assets/web-agent-startup-instructions.md +10 -10
  55. package/bmad-core/tasks/brainstorming-techniques.md +0 -238
@@ -5,88 +5,113 @@
5
5
  - Provide optional reflective and brainstorming actions to enhance content quality
6
6
  - Enable deeper exploration of ideas through structured elicitation techniques
7
7
  - Support iterative refinement through multiple analytical perspectives
8
+ - Usable during template-driven document creation or any chat conversation
8
9
 
9
- ## Task Instructions
10
+ ## Usage Scenarios
10
11
 
11
- ### 1. Section Context and Review
12
+ ### Scenario 1: Template Document Creation
12
13
 
13
- [[LLM: When invoked after outputting a section:
14
+ After outputting a section during document creation:
14
15
 
15
- 1. First, provide a brief 1-2 sentence summary of what the user should look for in the section just presented (e.g., "Please review the technology choices for completeness and alignment with your project needs. Pay special attention to version numbers and any missing categories.")
16
+ 1. **Section Review**: Ask user to review the drafted section
17
+ 2. **Offer Elicitation**: Present 9 carefully selected elicitation methods
18
+ 3. **Simple Selection**: User types a number (0-8) to engage method, or 9 to proceed
19
+ 4. **Execute & Loop**: Apply selected method, then re-offer choices until user proceeds
16
20
 
17
- 2. If the section contains Mermaid diagrams, explain each diagram briefly before offering elicitation options (e.g., "The component diagram shows the main system modules and their interactions. Notice how the API Gateway routes requests to different services.")
21
+ ### Scenario 2: General Chat Elicitation
18
22
 
19
- 3. If the section contains multiple distinct items (like multiple components, multiple patterns, etc.), inform the user they can apply elicitation actions to:
23
+ User can request advanced elicitation on any agent output:
20
24
 
21
- - The entire section as a whole
22
- - Individual items within the section (specify which item when selecting an action)
25
+ - User says "do advanced elicitation" or similar
26
+ - Agent selects 9 relevant methods for the context
27
+ - Same simple 0-9 selection process
23
28
 
24
- 4. Then present the action list as specified below.]]
29
+ ## Task Instructions
25
30
 
26
- ### 2. Ask for Review and Present Action List
31
+ ### 1. Intelligent Method Selection
27
32
 
28
- [[LLM: Ask the user to review the drafted section. In the SAME message, inform them that they can suggest additions, removals, or modifications, OR they can select an action by number from the 'Advanced Reflective, Elicitation & Brainstorming Actions'. If there are multiple items in the section, mention they can specify which item(s) to apply the action to. Then, present ONLY the numbered list (0-9) of these actions. Conclude by stating that selecting 9 will proceed to the next section. Await user selection. If an elicitation action (0-8) is chosen, execute it and then re-offer this combined review/elicitation choice. If option 9 is chosen, or if the user provides direct feedback, proceed accordingly.]]
33
+ **Context Analysis**: Before presenting options, analyze:
29
34
 
30
- **Present the numbered list (0-9) with this exact format:**
35
+ - **Content Type**: Technical specs, user stories, architecture, requirements, etc.
36
+ - **Complexity Level**: Simple, moderate, or complex content
37
+ - **Stakeholder Needs**: Who will use this information
38
+ - **Risk Level**: High-impact decisions vs routine items
39
+ - **Creative Potential**: Opportunities for innovation or alternatives
31
40
 
32
- ```text
33
- **Advanced Reflective, Elicitation & Brainstorming Actions**
34
- Choose an action (0-9 - 9 to bypass - HELP for explanation of these options):
35
-
36
- 0. Expand or Contract for Audience
37
- 1. Explain Reasoning (CoT Step-by-Step)
38
- 2. Critique and Refine
39
- 3. Analyze Logical Flow and Dependencies
40
- 4. Assess Alignment with Overall Goals
41
- 5. Identify Potential Risks and Unforeseen Issues
42
- 6. Challenge from Critical Perspective (Self or Other Persona)
43
- 7. Explore Diverse Alternatives (ToT-Inspired)
44
- 8. Hindsight is 20/20: The 'If Only...' Reflection
45
- 9. Proceed / No Further Actions
46
- ```
41
+ **Method Selection Strategy**:
47
42
 
48
- ### 2. Processing Guidelines
43
+ 1. **Always Include Core Methods** (choose 3-4):
44
+ - Expand or Contract for Audience
45
+ - Critique and Refine
46
+ - Identify Potential Risks
47
+ - Assess Alignment with Goals
49
48
 
50
- **Do NOT show:**
49
+ 2. **Context-Specific Methods** (choose 4-5):
50
+ - **Technical Content**: Tree of Thoughts, ReWOO, Meta-Prompting
51
+ - **User-Facing Content**: Agile Team Perspective, Stakeholder Roundtable
52
+ - **Creative Content**: Innovation Tournament, Escape Room Challenge
53
+ - **Strategic Content**: Red Team vs Blue Team, Hindsight Reflection
51
54
 
52
- - The full protocol text with `[[LLM: ...]]` instructions
53
- - Detailed explanations of each option unless executing or the user asks, when giving the definition you can modify to tie its relevance
54
- - Any internal template markup
55
+ 3. **Always Include**: "Proceed / No Further Actions" as option 9
55
56
 
56
- **After user selection from the list:**
57
+ ### 2. Section Context and Review
57
58
 
58
- - Execute the chosen action according to the protocol instructions below
59
- - Ask if they want to select another action or proceed with option 9 once complete
60
- - Continue until user selects option 9 or indicates completion
59
+ When invoked after outputting a section:
61
60
 
62
- ## Action Definitions
61
+ 1. **Provide Context Summary**: Give a brief 1-2 sentence summary of what the user should look for in the section just presented
63
62
 
64
- 0. Expand or Contract for Audience
65
- [[LLM: Ask the user whether they want to 'expand' on the content (add more detail, elaborate) or 'contract' it (simplify, clarify, make more concise). Also, ask if there's a specific target audience they have in mind. Once clarified, perform the expansion or contraction from your current role's perspective, tailored to the specified audience if provided.]]
63
+ 2. **Explain Visual Elements**: If the section contains diagrams, explain them briefly before offering elicitation options
66
64
 
67
- 1. Explain Reasoning (CoT Step-by-Step)
68
- [[LLM: Explain the step-by-step thinking process, characteristic of your role, that you used to arrive at the current proposal for this content.]]
65
+ 3. **Clarify Scope Options**: If the section contains multiple distinct items, inform the user they can apply elicitation actions to:
66
+ - The entire section as a whole
67
+ - Individual items within the section (specify which item when selecting an action)
69
68
 
70
- 2. Critique and Refine
71
- [[LLM: From your current role's perspective, review your last output or the current section for flaws, inconsistencies, or areas for improvement, and then suggest a refined version reflecting your expertise.]]
69
+ ### 3. Present Elicitation Options
72
70
 
73
- 3. Analyze Logical Flow and Dependencies
74
- [[LLM: From your role's standpoint, examine the content's structure for logical progression, internal consistency, and any relevant dependencies. Confirm if elements are presented in an effective order.]]
71
+ **Review Request Process:**
75
72
 
76
- 4. Assess Alignment with Overall Goals
77
- [[LLM: Evaluate how well the current content contributes to the stated overall goals of the document, interpreting this from your specific role's perspective and identifying any misalignments you perceive.]]
73
+ - Ask the user to review the drafted section
74
+ - In the SAME message, inform them they can suggest direct changes OR select an elicitation method
75
+ - Present 9 intelligently selected methods (0-8) plus "Proceed" (9)
76
+ - Keep descriptions short - just the method name
77
+ - Await simple numeric selection
78
78
 
79
- 5. Identify Potential Risks and Unforeseen Issues
80
- [[LLM: Based on your role's expertise, brainstorm potential risks, overlooked edge cases, or unintended consequences related to the current content or proposal.]]
79
+ **Action List Presentation Format:**
81
80
 
82
- 6. Challenge from Critical Perspective (Self or Other Persona)
83
- [[LLM: Adopt a critical perspective on the current content. If the user specifies another role or persona (e.g., 'as a customer', 'as [Another Persona Name]'), critique the content or play devil's advocate from that specified viewpoint. If no other role is specified, play devil's advocate from your own current persona's viewpoint, arguing against the proposal or current content and highlighting weaknesses or counterarguments specific to your concerns. This can also randomly include YAGNI when appropriate, such as when trimming the scope of an MVP, the perspective might challenge the need for something to cut MVP scope.]]
81
+ ```text
82
+ **Advanced Elicitation Options**
83
+ Choose a number (0-8) or 9 to proceed:
84
+
85
+ 0. [Method Name]
86
+ 1. [Method Name]
87
+ 2. [Method Name]
88
+ 3. [Method Name]
89
+ 4. [Method Name]
90
+ 5. [Method Name]
91
+ 6. [Method Name]
92
+ 7. [Method Name]
93
+ 8. [Method Name]
94
+ 9. Proceed / No Further Actions
95
+ ```
84
96
 
85
- 7. Explore Diverse Alternatives (ToT-Inspired)
86
- [[LLM: From your role's perspective, first broadly brainstorm a range of diverse approaches or solutions to the current topic. Then, from this wider exploration, select and present 2 distinct alternatives, detailing the pros, cons, and potential implications you foresee for each.]]
97
+ **Response Handling:**
87
98
 
88
- 8. Hindsight is 20/20: The 'If Only...' Reflection
89
- [[LLM: In your current persona, imagine it's a retrospective for a project based on the current content. What's the one 'if only we had known/done X...' that your role would humorously or dramatically highlight, along with the imagined consequences?]]
99
+ - **Numbers 0-8**: Execute the selected method, then re-offer the choice
100
+ - **Number 9**: Proceed to next section or continue conversation
101
+ - **Direct Feedback**: Apply user's suggested changes and continue
90
102
 
91
- 9. Proceed / No Further Actions
92
- [[LLM: Acknowledge the user's choice to finalize the current work, accept the AI's last output as is, or move on to the next step without selecting another action from this list. Prepare to proceed accordingly.]]
103
+ ### 4. Method Execution Framework
104
+
105
+ **Execution Process:**
106
+
107
+ 1. **Retrieve Method**: Access the specific elicitation method from the elicitation-methods data file
108
+ 2. **Apply Context**: Execute the method from your current role's perspective
109
+ 3. **Provide Results**: Deliver insights, critiques, or alternatives relevant to the content
110
+ 4. **Re-offer Choice**: Present the same 9 options again until user selects 9 or gives direct feedback
111
+
112
+ **Execution Guidelines:**
113
+
114
+ - **Be Concise**: Focus on actionable insights, not lengthy explanations
115
+ - **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
116
+ - **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
117
+ - **Maintain Flow**: Keep the process moving efficiently
@@ -0,0 +1,136 @@
1
+ ---
2
+ docOutputLocation: docs/brainstorming-session-results.md
3
+ template: brainstorming-output-tmpl
4
+ ---
5
+
6
+ # Facilitate Brainstorming Session Task
7
+
8
+ Facilitate interactive brainstorming sessions with users. Be creative and adaptive in applying techniques.
9
+
10
+ ## Process
11
+
12
+ ### Step 1: Session Setup
13
+
14
+ Ask 4 context questions (don't preview what happens next):
15
+
16
+ 1. What are we brainstorming about?
17
+ 2. Any constraints or parameters?
18
+ 3. Goal: broad exploration or focused ideation?
19
+ 4. Do you want a structured document output to reference later? (Y/N)
20
+
21
+ ### Step 2: Present Approach Options
22
+
23
+ After getting answers to Step 1, present 4 approach options (numbered):
24
+
25
+ 1. User selects specific techniques
26
+ 2. Analyst recommends techniques based on context
27
+ 3. Random technique selection for creative variety
28
+ 4. Progressive technique flow (start broad, narrow down)
29
+
30
+ ### Step 3: Execute Techniques Interactively
31
+
32
+ **KEY PRINCIPLES:**
33
+
34
+ - **FACILITATOR ROLE**: Guide user to generate their own ideas through questions, prompts, and examples
35
+ - **CONTINUOUS ENGAGEMENT**: Keep user engaged with chosen technique until they want to switch or are satisfied
36
+ - **CAPTURE OUTPUT**: If document output requested, capture all ideas generated in each technique section
37
+
38
+ **Technique Selection:**
39
+ If user selects Option 1, present numbered list of techniques from the brainstorming-techniques data file. User can select by number (e.g., "7" for Mind Mapping).
40
+
41
+ **Technique Execution:**
42
+
43
+ 1. Apply selected technique according to data file description
44
+ 2. Keep engaging with technique until user indicates they want to:
45
+ - Choose a different technique
46
+ - Apply current ideas to a new technique
47
+ - Move to convergent phase
48
+ - End session
49
+
50
+ **Output Capture (if requested):**
51
+ For each technique used, capture:
52
+
53
+ - Technique name and duration
54
+ - Key ideas generated by user
55
+ - Insights and patterns identified
56
+ - User's reflections on the process
57
+
58
+ ### Step 4: Session Flow
59
+
60
+ 1. **Warm-up** (5-10 min) - Build creative confidence
61
+ 2. **Divergent** (20-30 min) - Generate quantity over quality
62
+ 3. **Convergent** (15-20 min) - Group and categorize ideas
63
+ 4. **Synthesis** (10-15 min) - Refine and develop concepts
64
+
65
+ ### Step 5: Document Output (if requested)
66
+
67
+ Generate structured document with these sections:
68
+
69
+ **Executive Summary**
70
+
71
+ - Session topic and goals
72
+ - Techniques used and duration
73
+ - Total ideas generated
74
+ - Key themes and patterns identified
75
+
76
+ **Technique Sections** (for each technique used)
77
+
78
+ - Technique name and description
79
+ - Ideas generated (user's own words)
80
+ - Insights discovered
81
+ - Notable connections or patterns
82
+
83
+ **Idea Categorization**
84
+
85
+ - **Immediate Opportunities** - Ready to implement now
86
+ - **Future Innovations** - Requires development/research
87
+ - **Moonshots** - Ambitious, transformative concepts
88
+ - **Insights & Learnings** - Key realizations from session
89
+
90
+ **Action Planning**
91
+
92
+ - Top 3 priority ideas with rationale
93
+ - Next steps for each priority
94
+ - Resources/research needed
95
+ - Timeline considerations
96
+
97
+ **Reflection & Follow-up**
98
+
99
+ - What worked well in this session
100
+ - Areas for further exploration
101
+ - Recommended follow-up techniques
102
+ - Questions that emerged for future sessions
103
+
104
+ ## Key Principles
105
+
106
+ - **YOU ARE A FACILITATOR**: Guide the user to brainstorm, don't brainstorm for them
107
+ - **INTERACTIVE DIALOGUE**: Ask questions, wait for responses, build on their ideas
108
+ - **ONE TECHNIQUE AT A TIME**: Don't mix multiple techniques in one response
109
+ - **CONTINUOUS ENGAGEMENT**: Stay with one technique until user wants to switch
110
+ - **DRAW IDEAS OUT**: Use prompts and examples to help them generate their own ideas
111
+ - **REAL-TIME ADAPTATION**: Monitor engagement and adjust approach as needed
112
+ - Maintain energy and momentum
113
+ - Defer judgment during generation
114
+ - Quantity leads to quality (aim for 100 ideas in 60 minutes)
115
+ - Build on ideas collaboratively
116
+ - Document everything if output requested
117
+
118
+ ## Advanced Engagement Strategies
119
+
120
+ **Energy Management**
121
+
122
+ - Check engagement levels: "How are you feeling about this direction?"
123
+ - Offer breaks or technique switches if energy flags
124
+ - Use encouraging language and celebrate idea generation
125
+
126
+ **Depth vs. Breadth**
127
+
128
+ - Ask follow-up questions to deepen ideas: "Tell me more about that..."
129
+ - Use "Yes, and..." to build on their ideas
130
+ - Help them make connections: "How does this relate to your earlier idea about...?"
131
+
132
+ **Transition Management**
133
+
134
+ - Always ask before switching techniques: "Ready to try a different approach?"
135
+ - Offer options: "Should we explore this idea deeper or generate more alternatives?"
136
+ - Respect their process and timing
@@ -8,7 +8,7 @@
8
8
 
9
9
  [[LLM: This section establishes the document's purpose and scope. Keep the content below but ensure project name is properly substituted.
10
10
 
11
- After presenting this section, apply `tasks#advanced-elicitation` protocol]]
11
+ After presenting this section, apply `{root}/tasks/advanced-elicitation.md` protocol]]
12
12
 
13
13
  This document outlines the overall project architecture for {{Project Name}}, including backend systems, shared services, and non-UI specific concerns. Its primary goal is to serve as the guiding architectural blueprint for AI-driven development, ensuring consistency and adherence to chosen patterns and technologies.
14
14
 
@@ -53,7 +53,7 @@ If the project includes a significant user interface, a separate Frontend Archit
53
53
 
54
54
  Document the decision here before proceeding with the architecture design. In none, just say N/A
55
55
 
56
- After presenting this starter template section, apply `tasks#advanced-elicitation` protocol]]
56
+ After presenting this starter template section, apply `{root}/tasks/advanced-elicitation.md` protocol]]
57
57
 
58
58
  ### Change Log
59
59
 
@@ -64,7 +64,7 @@ After presenting this starter template section, apply `tasks#advanced-elicitatio
64
64
 
65
65
  ## High Level Architecture
66
66
 
67
- [[LLM: This section contains multiple subsections that establish the foundation of the architecture. Present all subsections together (Introduction, Technical Summary, High Level Overview, Project Diagram, and Architectural Patterns), then apply `tasks#advanced-elicitation` protocol to the complete High Level Architecture section. The user can choose to refine the entire section or specific subsections.]]
67
+ [[LLM: This section contains multiple subsections that establish the foundation of the architecture. Present all subsections together (Introduction, Technical Summary, High Level Overview, Project Diagram, and Architectural Patterns), then apply `{root}/tasks/advanced-elicitation.md` protocol to the complete High Level Architecture section. The user can choose to refine the entire section or specific subsections.]]
68
68
 
69
69
  ### Technical Summary
70
70
 
@@ -86,7 +86,7 @@ After presenting this starter template section, apply `tasks#advanced-elicitatio
86
86
  4. Primary user interaction flow or data flow at a conceptual level
87
87
  5. Key architectural decisions and their rationale
88
88
 
89
- After presenting this section, apply `tasks#advanced-elicitation` protocol]]
89
+ After presenting this section, apply `{root}/tasks/advanced-elicitation.md` protocol]]
90
90
 
91
91
  ### High Level Project Diagram
92
92
 
@@ -100,7 +100,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
100
100
 
101
101
  Use appropriate Mermaid diagram type (graph TD, C4, sequence) based on what best represents the architecture
102
102
 
103
- After presenting the diagram, apply `tasks#advanced-elicitation` protocol]]
103
+ After presenting the diagram, apply `{root}/tasks/advanced-elicitation.md` protocol]]
104
104
 
105
105
  ### Architectural and Design Patterns
106
106
 
@@ -132,13 +132,13 @@ Common patterns to consider:
132
132
 
133
133
  @{/example}
134
134
 
135
- [[LLM: After presenting the patterns, apply `tasks#advanced-elicitation` protocol]]
135
+ [[LLM: After presenting the patterns, apply `{root}/tasks/advanced-elicitation.md` protocol]]
136
136
 
137
137
  ## Tech Stack
138
138
 
139
139
  [[LLM: This is the DEFINITIVE technology selection section. Work with the user to make specific choices:
140
140
 
141
- 1. Review PRD technical assumptions and any preferences from `data#technical-preferences` or an attached `technical-preferences`
141
+ 1. Review PRD technical assumptions and any preferences from `{root}/data/technical-preferences.yaml` or an attached `technical-preferences`
142
142
  2. For each category, present 2-3 viable options with pros/cons
143
143
  3. Make a clear recommendation based on project needs
144
144
  4. Get explicit user approval for each selection
@@ -154,7 +154,7 @@ Key decisions to finalize - before displaying the table, ensure you are aware of
154
154
  - Database and storage solutions - if unclear suggest sql or nosql or other types depending on the project and depending on cloud provider offer a suggestion
155
155
  - Development tools
156
156
 
157
- Upon render of the table, ensure the user is aware of the importance of this sections choices, should also look for gaps or disagreements with anything, ask for any clarifications if something is unclear why its in the list, and also right away apply `tasks#advanced-elicitation` display - this statement and the options should be rendered and then prompt right all before allowing user input.]]
157
+ Upon render of the table, ensure the user is aware of the importance of this sections choices, should also look for gaps or disagreements with anything, ask for any clarifications if something is unclear why its in the list, and also right away apply `{root}/tasks/advanced-elicitation.md` display - this statement and the options should be rendered and then prompt right all before allowing user input.]]
158
158
 
159
159
  ### Cloud Infrastructure
160
160
 
@@ -198,7 +198,7 @@ Upon render of the table, ensure the user is aware of the importance of this sec
198
198
 
199
199
  Create a clear conceptual model before moving to database schema.
200
200
 
201
- After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
201
+ After presenting all data models, apply `{root}/tasks/advanced-elicitation.md` protocol]]
202
202
 
203
203
  <<REPEAT: data_model>>
204
204
 
@@ -232,7 +232,7 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
232
232
  - Technology specifics based on tech stack choices
233
233
 
234
234
  5. Create component diagrams where helpful
235
- 6. After presenting all components, apply `tasks#advanced-elicitation` protocol]]
235
+ 6. After presenting all components, apply `{root}/tasks/advanced-elicitation.md` protocol]]
236
236
 
237
237
  <<REPEAT: component>>
238
238
 
@@ -259,7 +259,7 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
259
259
  - Sequence diagrams for complex interactions
260
260
  Choose the most appropriate for clarity
261
261
 
262
- After presenting the diagrams, apply `tasks#advanced-elicitation` protocol]]
262
+ After presenting the diagrams, apply `{root}/tasks/advanced-elicitation.md` protocol]]
263
263
 
264
264
  ## External APIs
265
265
 
@@ -313,7 +313,7 @@ If no external APIs are needed, state this explicitly and skip to next section.]
313
313
 
314
314
  ^^/CONDITION: has_external_apis^^
315
315
 
316
- [[LLM: After presenting external APIs (or noting their absence), apply `tasks#advanced-elicitation` protocol]]
316
+ [[LLM: After presenting external APIs (or noting their absence), apply `{root}/tasks/advanced-elicitation.md` protocol]]
317
317
 
318
318
  ## Core Workflows
319
319
 
@@ -327,7 +327,7 @@ If no external APIs are needed, state this explicitly and skip to next section.]
327
327
 
328
328
  Focus on workflows that clarify architecture decisions or complex interactions.
329
329
 
330
- After presenting the workflow diagrams, apply `tasks#advanced-elicitation` protocol]]
330
+ After presenting the workflow diagrams, apply `{root}/tasks/advanced-elicitation.md` protocol]]
331
331
 
332
332
  ## REST API Spec
333
333
 
@@ -361,7 +361,7 @@ servers:
361
361
 
362
362
  ^^/CONDITION: has_rest_api^^
363
363
 
364
- [[LLM: After presenting the REST API spec (or noting its absence if not applicable), apply `tasks#advanced-elicitation` protocol]]
364
+ [[LLM: After presenting the REST API spec (or noting its absence if not applicable), apply `{root}/tasks/advanced-elicitation.md` protocol]]
365
365
 
366
366
  ## Database Schema
367
367
 
@@ -375,7 +375,7 @@ servers:
375
375
 
376
376
  Present schema in format appropriate to database type (SQL DDL, JSON schema, etc.)
377
377
 
378
- After presenting the database schema, apply `tasks#advanced-elicitation` protocol]]
378
+ After presenting the database schema, apply `{root}/tasks/advanced-elicitation.md` protocol]]
379
379
 
380
380
  ## Source Tree
381
381
 
@@ -390,7 +390,7 @@ After presenting the database schema, apply `tasks#advanced-elicitation` protoco
390
390
 
391
391
  Adapt the structure based on project needs. For monorepos, show service separation. For serverless, show function organization. Include language-specific conventions.
392
392
 
393
- After presenting the structure, apply `tasks#advanced-elicitation` protocol to refine based on user feedback.]]
393
+ After presenting the structure, apply `{root}/tasks/advanced-elicitation.md` protocol to refine based on user feedback.]]
394
394
 
395
395
  ```plaintext
396
396
  {{project-root}}/
@@ -433,7 +433,7 @@ project-root/
433
433
  @{/example}
434
434
  ```
435
435
 
436
- [[LLM: After presenting the source tree structure, apply `tasks#advanced-elicitation` protocol]]
436
+ [[LLM: After presenting the source tree structure, apply `{root}/tasks/advanced-elicitation.md` protocol]]
437
437
 
438
438
  ## Infrastructure and Deployment
439
439
 
@@ -478,7 +478,7 @@ Get user input on deployment preferences and CI/CD tool choices.]]
478
478
  - **Trigger Conditions:** {{rollback_triggers}}
479
479
  - **Recovery Time Objective:** {{rto}}
480
480
 
481
- [[LLM: After presenting the infrastructure and deployment section, apply `tasks#advanced-elicitation` protocol]]
481
+ [[LLM: After presenting the infrastructure and deployment section, apply `{root}/tasks/advanced-elicitation.md` protocol]]
482
482
 
483
483
  ## Error Handling Strategy
484
484
 
@@ -529,7 +529,7 @@ This section guides both AI and human developers in consistent error handling.]]
529
529
  - **Compensation Logic:** {{compensation_patterns}}
530
530
  - **Idempotency:** {{idempotency_approach}}
531
531
 
532
- [[LLM: After presenting the error handling strategy, apply `tasks#advanced-elicitation` protocol]]
532
+ [[LLM: After presenting the error handling strategy, apply `{root}/tasks/advanced-elicitation.md` protocol]]
533
533
 
534
534
  ## Coding Standards
535
535
 
@@ -590,7 +590,7 @@ Avoid obvious rules like "use SOLID principles" or "write clean code"]]
590
590
 
591
591
  ^^/CONDITION: has_language_specifics^^
592
592
 
593
- [[LLM: After presenting the coding standards, apply `tasks#advanced-elicitation` protocol]]
593
+ [[LLM: After presenting the coding standards, apply `{root}/tasks/advanced-elicitation.md` protocol]]
594
594
 
595
595
  ## Test Strategy and Standards
596
596
 
@@ -603,7 +603,7 @@ Avoid obvious rules like "use SOLID principles" or "write clean code"]]
603
603
  5. Determine integration test infrastructure
604
604
  6. Plan for test data and external dependencies
605
605
 
606
- Note: Basic info goes in Coding Standards for dev agent. This detailed section is for QA agent and team reference. Apply `tasks#advanced-elicitation` after initial draft.]]
606
+ Note: Basic info goes in Coding Standards for dev agent. This detailed section is for QA agent and team reference. Apply `{root}/tasks/advanced-elicitation.md` after initial draft.]]
607
607
 
608
608
  ### Testing Philosophy
609
609
 
@@ -664,7 +664,7 @@ Note: Basic info goes in Coding Standards for dev agent. This detailed section i
664
664
  - **Performance Tests:** {{perf_test_approach}}
665
665
  - **Security Tests:** {{security_test_approach}}
666
666
 
667
- [[LLM: After presenting the test strategy section, apply `tasks#advanced-elicitation` protocol]]
667
+ [[LLM: After presenting the test strategy section, apply `{root}/tasks/advanced-elicitation.md` protocol]]
668
668
 
669
669
  ## Security
670
670
 
@@ -728,7 +728,7 @@ Note: Basic info goes in Coding Standards for dev agent. This detailed section i
728
728
  - **DAST Tool:** {{dynamic_analysis}}
729
729
  - **Penetration Testing:** {{pentest_schedule}}
730
730
 
731
- [[LLM: After presenting the security section, apply `tasks#advanced-elicitation` protocol]]
731
+ [[LLM: After presenting the security section, apply `{root}/tasks/advanced-elicitation.md` protocol]]
732
732
 
733
733
  ## Checklist Results Report
734
734
 
@@ -0,0 +1,149 @@
1
+ ---
2
+ defaultOutput: docs/brainstorming-session-results.md
3
+ ---
4
+
5
+ # Brainstorming Session Results
6
+
7
+ **Session Date:** [DATE]
8
+ **Facilitator:** [Agent Role] [Agent Name]
9
+ **Participant:** [USER NAME]
10
+
11
+ ## Executive Summary
12
+
13
+ **Topic:** [SESSION TOPIC]
14
+
15
+ **Session Goals:** [STATED GOALS]
16
+
17
+ **Techniques Used:** [LIST OF TECHNIQUES AND DURATION]
18
+
19
+ **Total Ideas Generated:** [NUMBER]
20
+
21
+ **Key Themes Identified:**
22
+
23
+ - [THEME 1]
24
+ - [THEME 2]
25
+ - [THEME 3]
26
+
27
+ ---
28
+
29
+ ## Technique Sessions
30
+
31
+ ### [TECHNIQUE NAME 1] - [DURATION]
32
+
33
+ **Description:** [BRIEF DESCRIPTION OF TECHNIQUE]
34
+
35
+ **Ideas Generated:**
36
+
37
+ 1. [USER IDEA 1]
38
+ 2. [USER IDEA 2]
39
+ 3. [USER IDEA 3]
40
+ [etc.]
41
+
42
+ **Insights Discovered:**
43
+
44
+ - [INSIGHT 1]
45
+ - [INSIGHT 2]
46
+
47
+ **Notable Connections:**
48
+
49
+ - [CONNECTION OR PATTERN IDENTIFIED]
50
+
51
+ ---
52
+
53
+ ### [TECHNIQUE NAME 2] - [DURATION]
54
+
55
+ [Repeat format for each technique used]
56
+
57
+ ---
58
+
59
+ ## Idea Categorization
60
+
61
+ ### Immediate Opportunities
62
+
63
+ *Ideas ready to implement now*
64
+
65
+ 1. **[IDEA NAME]**
66
+ - Description: [BRIEF DESCRIPTION]
67
+ - Why immediate: [RATIONALE]
68
+ - Resources needed: [BASIC REQUIREMENTS]
69
+
70
+ ### Future Innovations
71
+
72
+ *Ideas requiring development/research*
73
+
74
+ 1. **[IDEA NAME]**
75
+ - Description: [BRIEF DESCRIPTION]
76
+ - Development needed: [WHAT'S REQUIRED]
77
+ - Timeline estimate: [ROUGH TIMEFRAME]
78
+
79
+ ### Moonshots
80
+
81
+ *Ambitious, transformative concepts*
82
+
83
+ 1. **[IDEA NAME]**
84
+ - Description: [BRIEF DESCRIPTION]
85
+ - Transformative potential: [WHY IT'S A MOONSHOT]
86
+ - Challenges to overcome: [MAJOR OBSTACLES]
87
+
88
+ ### Insights & Learnings
89
+
90
+ *Key realizations from the session*
91
+
92
+ - [INSIGHT 1]: [DESCRIPTION AND IMPLICATIONS]
93
+ - [INSIGHT 2]: [DESCRIPTION AND IMPLICATIONS]
94
+
95
+ ---
96
+
97
+ ## Action Planning
98
+
99
+ ### Top 3 Priority Ideas
100
+
101
+ **#1 Priority: [IDEA NAME]**
102
+
103
+ - Rationale: [WHY THIS IS TOP PRIORITY]
104
+ - Next steps: [SPECIFIC ACTIONS TO TAKE]
105
+ - Resources needed: [WHAT'S REQUIRED]
106
+ - Timeline: [WHEN TO START/COMPLETE]
107
+
108
+ **#2 Priority: [IDEA NAME]**
109
+
110
+ - [Same format]
111
+
112
+ **#3 Priority: [IDEA NAME]**
113
+
114
+ - [Same format]
115
+
116
+ ---
117
+
118
+ ## Reflection & Follow-up
119
+
120
+ ### What Worked Well
121
+
122
+ - [SUCCESSFUL ASPECT 1]
123
+ - [SUCCESSFUL ASPECT 2]
124
+
125
+ ### Areas for Further Exploration
126
+
127
+ - [AREA 1]: [WHY IT NEEDS MORE EXPLORATION]
128
+ - [AREA 2]: [WHY IT NEEDS MORE EXPLORATION]
129
+
130
+ ### Recommended Follow-up Techniques
131
+
132
+ - [TECHNIQUE 1]: [WHY IT WOULD BE HELPFUL]
133
+ - [TECHNIQUE 2]: [WHY IT WOULD BE HELPFUL]
134
+
135
+ ### Questions That Emerged
136
+
137
+ - [QUESTION 1]
138
+ - [QUESTION 2]
139
+ - [QUESTION 3]
140
+
141
+ ### Next Session Planning
142
+
143
+ - **Suggested topics:** [FOLLOW-UP TOPICS]
144
+ - **Recommended timeframe:** [WHEN TO RECONVENE]
145
+ - **Preparation needed:** [WHAT TO RESEARCH/PREPARE]
146
+
147
+ ---
148
+
149
+ *Session facilitated using the BMAD-METHOD brainstorming framework*