# brainstorming

brainstorming transforms loose concepts into structured technical specs through dialogue. Halts premature code changes until every requirement is confirmed.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 164 installs · ★ 4 repo stars
- Author: davidkiss
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davidkiss/smart-ai-skills/tree/HEAD/skills/brainstorming/SKILL.md
- Updated: 2026-05-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/davidkiss-brainstorming

## What it does

The skill stops the agent from touching code when starting a complex task. It forces the assistant to examine repository history and documentation first with the `@investigator` skill. Then it starts a focused interview. Only one question arrives per message. To speed up decisions, the model proposes two or three approaches with trade-offs, discarding unneeded details under YAGNI principles.

Once requirements are clear, the assistant outlines the spec in sections of 200–300 words. You review each section before the next one appears. The discussion covers architecture and error handling. The final document lands in `docs/YYYY-MM-DD-<topic>-specs.md`. Until the user explicitly approves the plan, the agent cannot edit any project files.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davidkiss/smart-ai-skills skills/brainstorming
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davidkiss/smart-ai-skills --path skills/brainstorming
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add davidkiss/smart-ai-skills --skill brainstorming -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/davidkiss/smart-ai-skills/tree/HEAD/skills/brainstorming/SKILL.md

## When to use it
- turn loose feature ideas into structured technical specs
- prevent AI assistants from editing code prematurely
- compare two or three design approaches with clear trade-offs
- document project requirements in versioned Markdown files

## Example prompts
- Let's brainstorm the architecture for our payment gateway integration
- Help me design the specs for user session management
- Brainstorm a background worker system before writing any code

## Similar
- [brainstorm](https://affpapa.org/en/nevibecode/skills/buiducnhat-brainstorm.md) — skill · 628 installs
- [bmad-brainstorming](https://affpapa.org/en/nevibecode/skills/bmad-brainstorming.md) — skill · 17900 installs
- [brainstorming-research-ideas](https://affpapa.org/en/nevibecode/skills/brainstorming-research-ideas.md) — skill · 1400 installs
- [scientific-brainstorming](https://affpapa.org/en/nevibecode/skills/scientific-brainstorming.md) — skill · 345 installs
- [om-brainstorm](https://affpapa.org/en/nevibecode/skills/om-brainstorm.md) — skill · 3500 installs
- [product-brainstorming](https://affpapa.org/en/nevibecode/skills/product-brainstorming.md) — skill · 6100 installs

## Other versions with the same name
- [brainstorming · obra](https://affpapa.org/en/nevibecode/skills/brainstorming.md) — 404045 installs
- [brainstorming · sickn33](https://affpapa.org/en/nevibecode/skills/sickn33-brainstorming.md) — 2400 installs
- [brainstorming · fradser](https://affpapa.org/en/nevibecode/skills/fradser-brainstorming.md) — 124 installs
- [brainstorming · jwynia](https://affpapa.org/en/nevibecode/skills/jwynia-brainstorming.md) — 563 installs
- [brainstorming · ganyuanran](https://affpapa.org/en/nevibecode/skills/ganyuanran-brainstorming.md) — ★ 1450 repo stars

From the same set: [davidkiss/smart-ai-skills](https://affpapa.org/en/nevibecode/by/davidkiss/smart-ai-skills.md) — 6 cards

---
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
