Where are the design documents saved?

By default, the skill saves your validated technical specifications to the `docs/superpowers/specs/` directory and commits them to your repository for version control.

Why does this skill prevent me from writing code immediately?

It implements a 'Hard-Gate' to ensure that all requirements and design decisions are approved by the user first, which significantly reduces technical debt and wasted development time caused by misunderstood goals.

What is the 'Visual Companion' mentioned in the process?

The Visual Companion is a browser-based tool that Claude can use to show you wireframes, diagrams, and UI comparisons during the brainstorming phase to provide a clearer understanding of the proposed design.

Does this skill work for small, simple projects?

Yes. Even for simple utilities, the skill ensures that assumptions are checked. For minor tasks, the design process is scaled down to be brief but remains mandatory to maintain quality.

Design-First Brainstorming

Name: Design-First Brainstorming
Author: ironbob

byironbob

0•

生产力与工作流

Facilitates a structured collaborative dialogue to transform raw ideas into validated technical designs before implementation begins.

The Brainstorming skill enforces a rigorous design-first workflow for Claude Code, ensuring that user intent, project constraints, and architectural trade-offs are fully explored before a single line of code is written. By utilizing a mandatory 'Hard-Gate' approval process, it prevents wasted effort on unexamined assumptions and helps developers decompose complex systems into manageable sub-projects. The skill guides you through project context exploration, interactive clarifying questions, and the generation of comprehensive design documents committed directly to your repository.

主要功能

010 GitHub stars

02Optional Visual Companion for browser-based mockups and diagrams

03Automated technical design document generation and Git commitment

04Mandatory design approval gate to prevent premature implementation

05Structured 'one-at-a-time' questioning to refine project requirements

06Comparative analysis of 2-3 architectural approaches with trade-off assessments

使用场景

01Defining technical specifications for new features or complex components

02Aligning UI/UX expectations through visual mockups before frontend development

03Decomposing large-scale platform requests into iterative sub-projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ironbob/superpower_light brainstorming

For use in Claude.ai and ChatGPT

主要功能

010 GitHub stars

02Optional Visual Companion for browser-based mockups and diagrams

03Automated technical design document generation and Git commitment

04Mandatory design approval gate to prevent premature implementation

05Structured 'one-at-a-time' questioning to refine project requirements

06Comparative analysis of 2-3 architectural approaches with trade-off assessments

使用场景

01Defining technical specifications for new features or complex components

02Aligning UI/UX expectations through visual mockups before frontend development

03Decomposing large-scale platform requests into iterative sub-projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ironbob/superpower_light brainstorming

For use in Claude.ai and ChatGPT