$npx -y skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstormFacilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting). Produces a brainstorming-report.md of organized ideas and actionable insights. Operates in t
| 1 | # BMAD Brainstorm |
| 2 | |
| 3 | Structured ideation harness for the BMAD planning lifecycle. Produces a |
| 4 | `brainstorming-report.md` of organized ideas and insights ready to feed downstream |
| 5 | planning skills (product-brief, PRD, architecture). |
| 6 | |
| 7 | ## Three Intents |
| 8 | |
| 9 | Ask the user which intent applies — or infer from context: |
| 10 | |
| 11 | | Intent | When to use | |
| 12 | |--------|-------------| |
| 13 | | **Create** | New brainstorming session on a topic or problem | |
| 14 | | **Update** | Add techniques, deepen coverage, or incorporate new constraints | |
| 15 | | **Validate** | Confirm generated insights align with project goals or decision-log | |
| 16 | |
| 17 | ## Technique Menu |
| 18 | |
| 19 | | Technique | Best For | Approx Time | |
| 20 | |-----------|----------|-------------| |
| 21 | | **5 Whys** | Root cause analysis | 10-15 min | |
| 22 | | **SCAMPER** | Feature ideation & creative variations | 20-30 min | |
| 23 | | **Mind Mapping** | Idea organization & hierarchy | 15-20 min | |
| 24 | | **Reverse Brainstorming** | Risk and failure-mode identification | 15-20 min | |
| 25 | | **Six Thinking Hats** | Multi-perspective evaluation | 30-45 min | |
| 26 | | **Starbursting** | Question exploration (Who/What/When/Where/Why/How) | 20-30 min | |
| 27 | | **SWOT Analysis** | Strategic positioning | 30-45 min | |
| 28 | | **Brainwriting** | Silent parallel idea generation | 15-20 min | |
| 29 | |
| 30 | ### Technique Selection Guide |
| 31 | |
| 32 | - **Exploring a problem?** → 5 Whys, then Starbursting |
| 33 | - **Generating features or solutions?** → SCAMPER, Mind Mapping |
| 34 | - **Assessing risk or failure modes?** → Reverse Brainstorming, Six Thinking Hats (Black Hat) |
| 35 | - **Strategic planning or positioning?** → SWOT, Six Thinking Hats (full cycle) |
| 36 | - **Need parallel idea volume?** → Brainwriting |
| 37 | |
| 38 | ## Session Workflow |
| 39 | |
| 40 | Use TodoWrite to track each step. |
| 41 | |
| 42 | 1. **Gather context** — Ask: topic/problem, relevant constraints, which BMAD track is active |
| 43 | 2. **Read project context** — Load `bmad-output/project-context.md` and `bmad-output/decision-log.md` if present |
| 44 | 3. **Select techniques** — Choose 2-4 complementary techniques; confirm with user |
| 45 | 4. **Execute sessions** — Apply each technique systematically (diverge first, do not filter) |
| 46 | 5. **Organize ideas** — Categorize all generated ideas; label Impact (H/M/L) and Feasibility (H/M/L) |
| 47 | 6. **Extract insights** — Identify top 3-5 actionable insights across all techniques |
| 48 | 7. **Identify risks** — Capture risks surfaced during ideation |
| 49 | 8. **Produce report** — Fill `templates/brainstorm-session.template.md`; save to output folder |
| 50 | 9. **Update decision-log** — Record key decisions or directions confirmed during the session |
| 51 | 10. **Recommend next steps** — Which BMAD skill to engage next |
| 52 | |
| 53 | ## Script Utilities |
| 54 | |
| 55 | Generate SCAMPER prompts for a specific topic: |
| 56 | |
| 57 | ```bash |
| 58 | bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-brainstorm/scripts/scamper-prompts.sh" "your topic" |
| 59 | ``` |
| 60 | |
| 61 | Generate a SWOT analysis scaffold: |
| 62 | |
| 63 | ```bash |
| 64 | bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-brainstorm/scripts/swot-template.sh" "your subject" > bmad-output/swot-draft.md |
| 65 | ``` |
| 66 | |
| 67 | ## Output Artifacts |
| 68 | |
| 69 | All artifacts go under the user-configured output folder (default `bmad-output/`). |
| 70 | |
| 71 | | File | Description | |
| 72 | |------|-------------| |
| 73 | | `bmad-output/brainstorming-report.md` | Primary output — organized ideas + insights | |
| 74 | | `bmad-output/decision-log.md` | Append key decisions made during session | |
| 75 | | `bmad-output/swot-draft.md` | Optional SWOT scaffold (from script) | |
| 76 | |
| 77 | Use `templates/brainstorm-session.template.md` for the report structure. |
| 78 | |
| 79 | ## Subagent Strategy |
| 80 | |
| 81 | For sessions covering multiple techniques in parallel, fan out one agent per technique. |
| 82 | |
| 83 | **Pattern:** Fan-Out Ideation |
| 84 | **Agents:** 2-6 parallel (one per selected technique) |
| 85 | |
| 86 | | Agent | Task | Output | |
| 87 | |-------|------|--------| |
| 88 | | Agent 1 | Apply SCAMPER to generate feature variations | `bmad-output/brainstorm-scamper.md` | |
| 89 | | Agent 2 | Build Mind Map to organize ideas hierarchically | `bmad-output/brainstorm-mindmap.md` | |
| 90 | | Agent 3 | Reverse Brainstorming — identify failure modes | `bmad-output/brainstorm-risks.md` | |
| 91 | | Agent 4 | Six Thinking Hats — multi-perspective analysis | `bmad-output/brainstorm-hats.md` | |
| 92 | | Agent 5 | Starbursting — Who/What/When/Where/Why/How | `bmad-output/brainstorm-questions.md` | |