From Dev Process
Guides structured dialogue to transform rough ideas into validated designs with documentation. Use when starting new features or planning implementations.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dev-process:brainstormingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Transform rough concepts into fully-formed specifications through structured dialogue.
Transform rough concepts into fully-formed specifications through structured dialogue.
Core principle: Understand before building. One question at a time.
Don't use during: Clear "mechanical" processes where implementation is obvious.
Review existing project state, then incrementally clarify:
## Discovery Questions Template
1. What problem does this solve?
2. Who is the primary user?
3. What's the MVP scope?
4. What are the hard constraints?
5. How will we measure success?
Once concept understood, present design in sections:
Validate each section before proceeding.
docs/plans/YYYY-MM-DD-<topic>-design.md| Letter | Question |
|---|---|
| Substitute | What can be replaced? |
| Combine | What can be merged? |
| Adapt | What similar thing exists? |
| Modify | What can be changed/amplified? |
| Put to other uses | Different context? |
| Eliminate | What can be removed? |
| Reverse | What if done opposite? |
| Hat | Focus |
|---|---|
| White | Facts - What do we know? |
| Red | Emotions - What feels right? |
| Black | Caution - What could go wrong? |
| Yellow | Optimism - What's the upside? |
| Green | Creativity - What alternatives? |
| Blue | Process - What's next? |
Transform problems into opportunities:
❌ Problem: "Users don't complete onboarding"
✅ HMW Questions:
- How might we make onboarding feel like a game?
- How might we reduce onboarding to 30 seconds?
- How might we show immediate value before onboarding?
HIGH IMPACT
│
Quick │ Big Bets
Wins │ (plan carefully)
──────────┼──────────────
Fill-ins │ Time Sinks
(if time) │ (avoid)
│
LOW IMPACT
LOW EFFORT ──────── HIGH EFFORT
Score = (Reach × Impact × Confidence) / Effort
Reach: Users affected per quarter
Impact: 0.25 (minimal) to 3 (massive)
Confidence: 0-100%
Effort: Person-months
# Idea: [Name]
## One-liner
[Describe in one sentence]
## Problem it solves
[What pain point?]
## Target user
[Who benefits?]
## Key features
1. [Feature 1]
2. [Feature 2]
3. [Feature 3]
## Trade-offs
| Approach | Pros | Cons |
|----------|------|------|
| Option A | ... | ... |
| Option B | ... | ... |
## Risks
- [Risk 1]
- [Risk 2]
## Next steps
1. [Validate assumption X]
2. [Prototype Y]
# Design: [Feature Name]
Date: YYYY-MM-DD
## Context
[Why are we doing this?]
## Requirements
- [ ] Must have: ...
- [ ] Should have: ...
- [ ] Nice to have: ...
## Architecture
[High-level design]
## Components
[Key modules and responsibilities]
## Data Flow
[How data moves through system]
## Error Handling
[Failure modes and recovery]
## Testing Strategy
[How we verify correctness]
## Alternatives Considered
| Option | Trade-off |
|--------|-----------|
| ... | ... |
## Decision
[What we chose and why]
After design is approved:
using-git-worktrees skill to create isolated workspacefinishing-a-development-branch for completion## Brainstorm Session (60 min)
1. **Setup** (5 min) - State problem, review rules
2. **Warm-up** (5 min) - Quick creative exercise
3. **Ideation** (15 min) - Free generation, no discussion
4. **Sharing** (10 min) - Each shares top 3
5. **Building** (10 min) - Combine concepts
6. **Voting** (5 min) - Dot voting
7. **Action** (10 min) - Define next steps
Builds a throwaway prototype to answer a design question about UI appearance or state/logic behavior. Guides you through two branches: interactive terminal app for logic validation, or multiple UI variations for visual exploration.
npx claudepluginhub jhamidun/claude-code-config-pack --plugin dev-process