How does it handle architectural decisions?

It proposes 2-3 different approaches with detailed trade-offs and uses the AskUserQuestion tool to help you make an informed selection.

When should I use the Brainstorming skill?

Use it at the very start of a project or feature development, before writing any code or creating implementation plans, to ensure the design is sound.

Does this skill help with the actual coding?

While its primary focus is design, it includes phases for worktree setup and implementation planning to ensure a smooth transition to the coding phase.

Can I go back a step if requirements change?

Absolutely; the skill is designed to be flexible and encourages returning to earlier phases if new constraints or gaps in logic are discovered.

Does it automatically write documentation?

Yes, once a design is validated, it generates a formal design document in your project's docs/plans/ directory and commits it to Git.

Brainstorming & Design Refinement

Name: Brainstorming & Design Refinement
Author: kivilaid

bykivilaid

•

Productivity & Workflow

Refines rough ideas into fully-formed software designs through structured Socratic questioning and incremental validation.

This skill transforms ambiguous concepts into robust implementation blueprints by guiding the AI and user through a systematic six-phase process. It utilizes Socratic questioning to surface constraints, presents multiple architectural alternatives with clear trade-offs, and ensures design documentation is finalized before code is ever written. Ideal for complex features or new projects, it bridges the gap between a high-level idea and a detailed, validated development plan while integrating with Git worktrees for a seamless transition to coding.

Key Features

01Incremental design validation in digestible sections

02Seamless handoff to worktree setup and implementation planning

036 GitHub stars

04Structured Socratic questioning for requirement gathering

05Multi-approach architectural exploration with trade-off analysis

06Automatic design documentation and Git integration

Use Cases

01Architecting a new feature with multiple possible implementation paths

02Exploring trade-offs between different database or API strategies before coding

03Refining a vague product idea into a concrete technical specification

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kivilaid/plugin-marketplace brainstorming

For use in Claude.ai and ChatGPT

Download Skill