bmad-brainstorm

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: bmad-brainstorm
description: |
  Facilitates 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 three intents: Create (new session), Update
  (add techniques or deepen coverage), Validate (confirm insights align with project goals).

  Use when the user says: "brainstorm", "ideate", "generate ideas", "explore options",
  "SCAMPER", "SWOT analysis", "mind map", "Six Thinking Hats", "5 Whys", "creative
  session", "what if we", "let's explore", "think through possibilities", "find
  alternatives", or "problem-solve".

  This skill PLANS only — it never writes application code or runs tests.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite
---

# BMAD Brainstorm

Structured ideation harness for the BMAD planning lifecycle. Produces a
`brainstorming-report.md` of organized ideas and insights ready to feed downstream
planning skills (product-brief, PRD, architecture).

## Three Intents

Ask the user which intent applies — or infer from context:

| Intent | When to use |
|--------|-------------|
| **Create** | New brainstorming session on a topic or problem |
| **Update** | Add techniques, deepen coverage, or incorporate new constraints |
| **Validate** | Confirm generated insights align with project goals or decision-log |

## Technique Menu

| Technique | Best For | Approx Time |
|-----------|----------|-------------|
| **5 Whys** | Root cause analysis | 10-15 min |
| **SCAMPER** | Feature ideation & creative variations | 20-30 min |
| **Mind Mapping** | Idea organization & hierarchy | 15-20 min |
| **Reverse Brainstorming** | Risk and failure-mode identification | 15-20 min |
| **Six Thinking Hats** | Multi-perspective evaluation | 30-45 min |
| **Starbursting** | Question exploration (Who/What/When/Where/Why/How) | 20-30 min |
| **SWOT Analysis** | Strategic positioning | 30-45 min |
| **Brainwriting** | Silent parallel idea generation | 15-20 min |

### Technique Selection Guide

- **Exploring a problem?** → 5 Whys, then Starbursting
- **Generating features or solutions?** → SCAMPER, Mind Mapping
- **Assessing risk or failure modes?** → Reverse Brainstorming, Six Thinking Hats (Black Hat)
- **Strategic planning or positioning?** → SWOT, Six Thinking Hats (full cycle)
- **Need parallel idea volume?** → Brainwriting

## Session Workflow

Use TodoWrite to track each step.

1. **Gather context** — Ask: topic/problem, relevant constraints, which BMAD track is active
2. **Read project context** — Load `bmad-output/project-context.md` and `bmad-output/decision-log.md` if present
3. **Select techniques** — Choose 2-4 complementary techniques; confirm with user
4. **Execute sessions** — Apply each technique systematically (diverge first, do not filter)
5. **Organize ideas** — Categorize all generated ideas; label Impact (H/M/L) and Feasibility (H/M/L)
6. **Extract insights** — Identify top 3-5 actionable insights across all techniques
7. **Identify risks** — Capture risks surfaced during ideation
8. **Produce report** — Fill `templates/brainstorm-session.template.md`; save to output folder
9. **Update decision-log** — Record key decisions or directions confirmed during the session
10. **Recommend next steps** — Which BMAD skill to engage next

## Script Utilities

Generate SCAMPER prompts for a specific topic:

```bash
bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-brainstorm/scripts/scamper-prompts.sh" "your topic"
```

Generate a SWOT analysis scaffold:

```bash
bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-brainstorm/scripts/swot-template.sh" "your subject" > bmad-output/swot-draft.md
```

## Output Artifacts

All artifacts go under the user-configured output folder (default `bmad-output/`).

| File | Description |
|------|-------------|
| `bmad-output/brainstorming-report.md` | Primar