# /brainstorming: Design-first brainstorming before any build

Source: https://trendhub.net/skills/obra-superpowers/brainstorming
Skill folder: https://github.com/obra/superpowers/tree/main/skills/brainstorming
Pack: Superpowers (https://trendhub.net/skills/obra-superpowers)
Works with: Claude Code, Claude Code (Superpowers marketplace), Codex CLI, Cursor, Gemini CLI, GitHub Copilot CLI, Devin CLI, Qwen Code, Pi, Antigravity

Brainstorming makes the agent find out what you actually want, and why, before it builds anything. It reads the existing project, asks one focused question at a time, lays out two or three approaches for you to pick from, and writes a short or full design document that must be approved before implementation starts.

## When to use it

- You ask for a new feature, component or behavior change that leaves important details open
- You are planning something non-software, such as a talk or a renovation, and want to think it through
- You hand over a spec or plan and want the agent to confirm its understanding first

## How it works

1. **Read the context**: The agent studies the code and any files you pointed at so it does not ask questions the project already answers.
2. **Ask about intent**: It echoes your request back and asks the single open question that would most change what gets built.
3. **Compare approaches**: It presents two or three ways to build it, with trade-offs and a recommendation, and you choose one.
4. **Write the design**: It sizes the work and writes a short or full design document, optionally checked by a fresh subagent acting as the builder.
5. **Hand off to planning**: Once you approve the document, it moves on to the writing-plans skill.

## What it steers the agent away from

- Writing code, scaffolding projects or installing dependencies before you have agreed on a design
- Silent defaults you never had a chance to reject
- Treating a quick throwaway spike as the final build

## What it can touch

Reads project files; writes a design document (in a software repo, under docs/superpowers/specs/ and committed). May dispatch a reviewer subagent, and if you accept the optional visual companion it starts a local server and opens a browser tab for mockups, whose logo loads from the Prime Radiant website unless telemetry is disabled.

## Pairs well with

- `/writing-plans`
- `/using-git-worktrees`
- `/subagent-driven-development`

## Questions

### Can I skip the questions and just have it build?

Yes. When you did not ask for brainstorming, the agent offers to dive straight in, and if you accept it states its main choices in one line and proceeds.

### Does every small change need a full design document?

No. Small changes get a short design that records what you already agreed in conversation; the full written design is for larger projects.
