# 01 Brainstorm

> Clarify a vague product or technical intent through natural discovery. Use when the user has a half-formed idea, ambiguous request, or asks to brainstorm, discover, refine, or clarify. Not for artifact gap scans, planning, or code.

- Skill: `ai-driven-dev/01-brainstorm` (Agent Skill, multi-file: 13 files)
- Install (CLI): `npx skillmds@latest add ai-driven-dev/01-brainstorm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ai-driven-dev/01-brainstorm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: ai-driven-dev (https://skillmd.com/u/ai-driven-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ai-driven-dev/01-brainstorm

---

# Brainstorm

```mermaid
flowchart LR
  capture --> probe --> integrate
  integrate -->|"open fork"| probe
  integrate -->|"clear enough"| finalize
  finalize -->|"user wants more"| probe
```

## Actions

Run the flow above. Read only the next action's file before running it.

| Action | Does |
| ------ | ---- |
| capture | restate the idea and pick what matters next |
| probe | ask the next useful questions |
| integrate | fold answers and decide whether to continue |
| finalize | produce the approved refined idea |

## Transversal rules

- Clarify intent, never plan, build, or code.
- Ask only questions that can change what gets built.
- Flag assumptions as assumptions.
- State a leaning and its tradeoff when facts already point one way.
- Hide process words: no density, coverage, nodes, completeness, matrix, or frame unless the user asks for an audit.
- Wait after questions, approval, and persistence choices.