brainstorminglisted
Install: claude install-skill viettdann/arclight-kit
# Brainstorming Ideas Into Designs
## Overview
Help turn ideas into fully formed designs and specs through natural collaborative dialogue.
Start from a high-level description of what the user wants to build and the current project context, then ask questions to refine the idea until Understanding is done, then present the design.
## The Process
### Understanding the Idea
- **Grasp the idea first.** Ask the user for a high-level description of what they want to build (1-2 sentences is enough to proceed)
- **Targeted codebase discovery:** informed by the user's stated intent:
- If the project is empty or the user explicitly states it's a greenfield/new project, skip codebase discovery entirely and note this assumption
- Otherwise, search and read the local codebase
- When the change touches one member of a family (one endpoint, one worker, one handler), list its siblings and which of them share the gap
- Grep `docs/plans/` for designs that overlap the topic; when one does, name it and ask whether to build on it or start fresh
- Summarize findings before proceeding: enough for the user to check your reading of the codebase, and no more
- **Self-verify before asking.** Before formulating any question for the user, apply this gate:
- **Answerable from the codebase?** (installed deps, patterns in use, available APIs) → Resolve it yourself and state it as a resolved constraint, not a question
- **Answerable from an external dependency?** (see Research) → Resolve