brainstorming-ideas

from alexei-led/claude-code-config

Configuration files and hooks for Claude Code development environment

10 stars1 forksUpdated Jan 25, 2026
npx skills add https://github.com/alexei-led/claude-code-config --skill brainstorming-ideas

SKILL.md

Brainstorming Ideas Into Designs

Transform vague ideas into fully-formed designs through structured collaborative dialogue.

Use TodoWrite to track these 7 phases:

  1. Understand the idea (dialogue first, no agents)
  2. Explore requirements (Starbursting questions)
  3. Checkpoint - offer exploration/research options
  4. Research similar solutions (if requested)
  5. Present approaches with recommendation
  6. Validate design incrementally
  7. Document and next steps

Core Principles

  • Dialogue first - Ask the user before spawning any agents
  • One question at a time - Never batch multiple questions
  • Multiple choice preferred - Easier to answer than open-ended
  • "Other" always available - Free text input for custom responses
  • YAGNI ruthlessly - Challenge every feature's necessity
  • Incremental validation - Present design in 200-300 word sections
  • Agents on request - Only explore/research when user chooses it

Phase 1: Understand the Idea

Start with dialogue, not agents. Ask the user directly.

1a. Initial Question

Use AskUserQuestion:

HeaderQuestionOptions
Idea typeWhat would you like to brainstorm?1. New feature - Add new functionality 2. Modification - Change existing behavior 3. Integration - Connect with external system 4. Exploration - Not sure yet, let's discover

1b. Follow-up (based on response)

Ask clarifying questions using AskUserQuestion. Keep it conversational:

  • "Can you describe this in a sentence or two?" (free text via "Other")
  • "What triggered this idea?" with context-appropriate options
  • "Is there an existing feature this builds on?"

Phase 2: Explore Requirements (Starbursting)

Ask questions one at a time using AskUserQuestion. Adapt based on idea type.

Question Framework (5WH)

Question TypeWhen to AskExample AskUserQuestion
WHOAlways first"Who will use this?" → Options: Existing users, New segment, Internal, API consumers
WHYAfter WHO"What problem does this solve?" → Options based on detected pain points
WHATAfter WHY is clear"What's the core capability?" → Open or options based on research
WHEREFor integrations/modifications"Where should this live?" → Options based on codebase exploration
HOWAfter approach research"How should we implement?" → Present 2-3 technical approaches

Adaptive Questioning

  • Skip questions when answers are obvious from context
  • If user seems certain, move faster to approaches
  • If user seems uncertain, explore deeper with sub-questions
  • Use "Other" option to allow custom responses

Phase 3: Checkpoint - Gather More Context?

After understanding requirements, ask before spawning any agents:

HeaderQuestionOptions
Next stepHow should we proceed?1. Explore codebase - Check existing patterns and tech stack 2. Research solutions - Look up how others solve this 3. Both - Explore then research 4. Skip to approaches - I know what I want

If user chooses "Explore codebase":

Task(
  subagent_type="Explore",
  prompt="Quick scan: project structure, tech stack, patterns relevant to [user's idea]",
  run_in_background=false
)

Then summarize findings and ask: "Based on this, should we also research external solutions?"

If user chooses "Research solutions":

Proceed to Phase 4.

If user chooses "Skip to approaches":

Jump directly to Phase 5 (Present Approaches).


Phase 4: Research Similar Solutions (If Requested)

Only run when user explicitly chose research in Phase 3.

4a. Perplexity Query

mcp__perplexity-ask__perplexity_

...
Read full content

Repository Stats

Stars10
Forks1
LicenseMIT License