Does this skill generate code immediately?

No, it focuses on refining the design and creating a plan first, ensuring the implementation follows a validated strategy and reducing technical debt.

When should I use the Brainstorming skill?

Use it at the very beginning of a project or feature development, before writing any code, to clarify requirements and explore architectural choices.

What tools does this skill integrate with?

It integrates with the AskUserQuestion tool for structured choices, git worktrees for environment setup, and specific documentation skills for recording plans.

How does the Socratic questioning phase work?

The skill asks targeted, one-at-a-time questions to help you define the purpose, constraints, and success criteria of your idea without being overwhelmed.

Can I go back to an earlier phase if my requirements change?

Yes, the process is designed to be flexible. You can revisit the understanding or exploration phases whenever a new constraint or requirement is revealed.

Brainstorming & Design Refinement

Name: Brainstorming & Design Refinement
Author: Krosebrook

byKrosebrook

•

Productivity & Workflow

Refines rough concepts into production-ready designs using structured Socratic questioning and incremental validation.

This skill transforms vague ideas into structured technical designs by guiding Claude through a systematic refinement process. It employs a multi-phase approach—starting with Socratic questioning to uncover hidden requirements, exploring multiple architectural alternatives with clear trade-offs, and culminating in formal documentation and implementation plans. By forcing explicit choices and incremental validation, it ensures that technical decisions are intentional and aligned with project constraints before development begins.

Key Features

011 GitHub stars

02Structured Socratic questioning to extract purpose, constraints, and success criteria

03Comparative architectural exploration presenting multiple approaches with trade-offs

04Incremental design validation to ensure alignment at every stage

05Automated design documentation saved directly to your repository

06Seamless transition to implementation via git worktree and planning handoffs

Use Cases

01Transforming a vague feature request into a concrete, documented technical architecture

02Evaluating multiple technical strategies for complex problems before writing code

03Facilitating structured design reviews and requirements gathering within a repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add krosebrook/source-of-truth-monorepo brainstorming

For use in Claude.ai and ChatGPT

Download Skill