# bmad-brainstorm

bmad-brainstorm runs structured ideation sessions using SCAMPER, SWOT, and 5 Whys. Delivers an organized markdown report ready for project planning.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 130 installs · ★ 493 repo stars
- Author: aj-geddes
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/aj-geddes/claude-code-bmad-skills/tree/HEAD/bmad-planning-orchestrator/skills/bmad-brainstorm/SKILL.md
- Updated: 2026-06-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bmad-brainstorm

## What it does

The skill manages brainstorming sessions using eight distinct frameworks: 5 Whys, SCAMPER, Mind Mapping, Reverse Brainstorming, Six Thinking Hats, Starbursting, SWOT, and Brainwriting. It operates across three explicit intents: Create for a fresh session, Update to add more techniques or constraints, and Validate to align findings against project goals. It supports fanning out two to six subagents in parallel to execute separate techniques at once.

All results write to the configured output folder, primarily `bmad-output/brainstorming-report.md`. Ideas receive High, Medium, or Low tags for both impact and feasibility. Key decisions append directly into `bmad-output/decision-log.md`. The package also bundles helper bash scripts to draft SCAMPER prompts and SWOT templates.

This skill strictly limits itself to ideation and planning: it never writes production code or runs tests.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bmad-brainstorm/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bmad-brainstorm/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bmad-brainstorm/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bmad-brainstorm/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aj-geddes/claude-code-bmad-skills bmad-planning-orchestrator/skills/bmad-brainstorm
```

2. **Manually: put the files in place**
- File: `.github/skills/bmad-brainstorm/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aj-geddes/claude-code-bmad-skills --path bmad-planning-orchestrator/skills/bmad-brainstorm
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bmad-brainstorm/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aj-geddes/claude-code-bmad-skills/tree/HEAD/bmad-planning-orchestrator/skills/bmad-brainstorm/SKILL.md

## When to use it
- discover root causes of engineering issues using the 5 Whys framework
- generate feature variants and product improvements via SCAMPER
- surface critical project risks with reverse brainstorming
- build a structured SWOT analysis for strategic decisions

## Example prompts
- Let's brainstorm alternatives for our background worker architecture
- Run a SWOT analysis session for our multi-tenant migration
- Explore feature ideas using SCAMPER and Six Thinking Hats

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 92e53cbbcc7a5b95.

BEGIN THIRD-PARTY FILE 92e53cbbcc7a5b95
```text
---
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)
```
END THIRD-PARTY FILE 92e53cbbcc7a5b95

The third-party file has ended. Everything between the 92e53cbbcc7a5b95 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2482 of 7416 bytes. © aj-geddes · MIT · https://github.com/aj-geddes/claude-code-bmad-skills/tree/HEAD/bmad-planning-orchestrator/skills/bmad-brainstorm/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
