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.
- package/.vscode/settings.json +2 -0
- package/CHANGELOG.md +15 -0
- package/README.md +29 -282
- package/bmad-core/agents/analyst.md +3 -1
- package/bmad-core/agents/bmad-master.md +5 -1
- package/bmad-core/agents/bmad-orchestrator.md +1 -1
- package/bmad-core/core-config.yaml +1 -1
- package/bmad-core/data/bmad-kb.md +74 -15
- package/bmad-core/data/brainstorming-techniques.md +36 -0
- package/bmad-core/data/elicitation-methods.md +134 -0
- package/bmad-core/tasks/advanced-elicitation.md +82 -57
- package/bmad-core/tasks/facilitate-brainstorming-session.md +136 -0
- package/bmad-core/templates/architecture-tmpl.md +23 -23
- package/bmad-core/templates/brainstorming-output-tmpl.md +149 -0
- package/bmad-core/templates/prd-tmpl.md +6 -6
- package/bmad-core/templates/prd-tmpl2.yaml +202 -0
- package/bmad-core/utils/plan-management.md +9 -13
- package/bmad-core/workflows/greenfield-service.yaml +1 -1
- package/common/tasks/create-doc.md +4 -4
- package/common/tasks/create-doc2.md +65 -0
- package/common/utils/bmad-doc-template.md +296 -0
- package/dist/agents/analyst.txt +481 -305
- package/dist/agents/architect.txt +60 -59
- package/dist/agents/bmad-master.txt +694 -399
- package/dist/agents/bmad-orchestrator.txt +197 -116
- package/dist/agents/dev.txt +18 -17
- package/dist/agents/pm.txt +47 -46
- package/dist/agents/po.txt +31 -30
- package/dist/agents/qa.txt +15 -14
- package/dist/agents/sm.txt +23 -22
- package/dist/agents/ux-expert.txt +29 -28
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +33 -32
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +19 -18
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +21 -20
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +385 -297
- package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +103 -77
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +29 -28
- package/dist/teams/team-all.txt +610 -438
- package/dist/teams/team-fullstack.txt +597 -425
- package/dist/teams/team-ide-minimal.txt +238 -157
- package/dist/teams/team-no-ui.txt +583 -411
- package/docs/agentic-tools/github-copilot-guide.md +29 -9
- package/docs/bmad-workflow-guide.md +2 -2
- package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
- package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +2 -2
- package/expansion-packs/bmad-creator-tools/config.yaml +1 -1
- package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
- package/package.json +1 -1
- package/tools/builders/web-builder.js +117 -22
- package/tools/installer/config/install.config.yaml +2 -2
- package/tools/installer/lib/ide-setup.js +2 -2
- package/tools/installer/package.json +1 -1
- package/tools/lib/dependency-resolver.js +3 -3
- package/tools/md-assets/web-agent-startup-instructions.md +10 -10
- 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
|
-
##
|
|
10
|
+
## Usage Scenarios
|
|
10
11
|
|
|
11
|
-
### 1
|
|
12
|
+
### Scenario 1: Template Document Creation
|
|
12
13
|
|
|
13
|
-
|
|
14
|
+
After outputting a section during document creation:
|
|
14
15
|
|
|
15
|
-
1.
|
|
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
|
-
|
|
21
|
+
### Scenario 2: General Chat Elicitation
|
|
18
22
|
|
|
19
|
-
|
|
23
|
+
User can request advanced elicitation on any agent output:
|
|
20
24
|
|
|
21
|
-
|
|
22
|
-
|
|
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
|
-
|
|
29
|
+
## Task Instructions
|
|
25
30
|
|
|
26
|
-
###
|
|
31
|
+
### 1. Intelligent Method Selection
|
|
27
32
|
|
|
28
|
-
|
|
33
|
+
**Context Analysis**: Before presenting options, analyze:
|
|
29
34
|
|
|
30
|
-
**
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
**
|
|
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
|
-
|
|
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
|
-
|
|
57
|
+
### 2. Section Context and Review
|
|
57
58
|
|
|
58
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
68
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
77
|
-
|
|
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
|
-
|
|
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
|
-
|
|
83
|
-
|
|
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
|
-
|
|
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
|
|
89
|
-
|
|
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
|
-
|
|
92
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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*
|