SKILL·02B7C8

Brainstorming Ideas Into Designs

obra
Updated Yesterday
36 views
751
169
751
View on GitHub
Designaidesign

About

This skill transforms rough feature ideas into detailed designs using Socratic questioning and alternative exploration. It's for developers to use before coding, guiding them through understanding constraints and evaluating architectural trade-offs. The process incrementally builds and validates a design through structured dialogue.

Quick Install

Claude Code

Recommended
Primary
npx skills add obra/superpowers-skills -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/obra/superpowers-skills
Git CloneAlternative
git clone https://github.com/obra/superpowers-skills.git ~/.claude/skills/Brainstorming Ideas Into Designs

Copy and paste this command in Claude Code to install this skill

Documentation

Brainstorming Ideas Into Designs

Overview

Transform rough ideas into fully-formed designs through structured questioning and alternative exploration.

Core principle: Ask questions to understand, explore alternatives, present design incrementally for validation.

Announce at start: "I'm using the Brainstorming skill to refine your idea into a design."

The Process

Phase 1: Understanding

  • Check current project state in working directory
  • Ask ONE question at a time to refine the idea
  • Prefer multiple choice when possible
  • Gather: Purpose, constraints, success criteria

Phase 2: Exploration

  • Propose 2-3 different approaches
  • For each: Core architecture, trade-offs, complexity assessment
  • Ask your human partner which approach resonates

Phase 3: Design Presentation

  • Present in 200-300 word sections
  • Cover: Architecture, components, data flow, error handling, testing
  • Ask after each section: "Does this look right so far?"

Phase 4: Worktree Setup (for implementation)

When design is approved and implementation will follow:

  • Announce: "I'm using the Using Git Worktrees skill to set up an isolated workspace."
  • Switch to skills/collaboration/using-git-worktrees
  • Follow that skill's process for directory selection, safety verification, and setup
  • Return here when worktree ready

Phase 5: Planning Handoff

Ask: "Ready to create the implementation plan?"

When your human partner confirms (any affirmative response):

  • Announce: "I'm using the Writing Plans skill to create the implementation plan."
  • Switch to skills/collaboration/writing-plans skill
  • Create detailed plan in the worktree

When to Revisit Earlier Phases

You can and should go backward when:

  • Partner reveals new constraint during Phase 2 or 3 → Return to Phase 1 to understand it
  • Validation shows fundamental gap in requirements → Return to Phase 1
  • Partner questions approach during Phase 3 → Return to Phase 2 to explore alternatives
  • Something doesn't make sense → Go back and clarify

Don't force forward linearly when going backward would give better results.

Related Skills

During exploration:

  • When approaches have genuine trade-offs: skills/architecture/preserving-productive-tensions

Before proposing changes to existing code:

  • Understand why it exists: skills/research/tracing-knowledge-lineages

Remember

  • One question per message during Phase 1
  • Apply YAGNI ruthlessly
  • Explore 2-3 alternatives before settling
  • Present incrementally, validate as you go
  • Go backward when needed - flexibility > rigid progression
  • Announce skill usage at start

GitHub Repository

obra/superpowers-skills
Path: skills/collaboration/brainstorming
0
FAQ

Frequently asked questions

What is the Brainstorming Ideas Into Designs skill?

Brainstorming Ideas Into Designs is a Claude Skill by obra. Skills package instructions and resources that Claude loads on demand, so Claude can perform Brainstorming Ideas Into Designs-related tasks without extra prompting.

How do I install Brainstorming Ideas Into Designs?

Use the install commands on this page: add Brainstorming Ideas Into Designs to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does Brainstorming Ideas Into Designs belong to?

Brainstorming Ideas Into Designs is in the Design category, tagged ai and design.

Is Brainstorming Ideas Into Designs free to use?

Yes. Brainstorming Ideas Into Designs is listed on AIMCP and free to install.

Related Skills

executing-plans
Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill
requesting-code-review
Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill
connect-mcp-server
Design

This skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.

View skill
web-cli-teleport
Design

This skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.

View skill