brainstormlisted
Install: claude install-skill drafael/coding-harness
# Brainstorm
Turn ideas into designs through collaborative dialogue before implementation.
## Process
### Phase 1: Understand the Idea
Check project context first, then ask questions one at a time:
1. **Gather context** - check files, docs, recent commits relevant to the idea
2. **Ask questions one at a time** - prefer multiple choice when possible
3. **Focus on**: purpose, constraints, success criteria, integration points
Do not overwhelm with multiple questions. One question per message. If a topic needs more exploration, break it into multiple questions.
### Phase 2: Explore Approaches
Once the problem is understood:
1. **Compare 2-3 approaches when several are credible** and explain their trade-offs
2. **When one approach is clearly supported**, explain why alternatives do not fit instead of inventing options
3. **Lead with the recommendation** and present it conversationally, not as a formal document
Example format:
```
I see three approaches:
**Option A: [name]** (recommended)
- how it works: ...
- pros: ...
- cons: ...
**Option B: [name]**
- how it works: ...
- pros: ...
- cons: ...
Which direction appeals to you?
```
### Phase 3: Present Design
After approach is selected:
1. **Break design into sections** of 200-300 words each
2. **Ask after each section** whether it looks right
3. **Cover relevant concerns** - for example, architecture, components, data flow, failure handling, and validation
4. **Be ready to backtrack** if something doesn't make sense