Why does this skill prevent me from writing code immediately?

The Brainstorming skill enforces a 'Hard-Gate' policy to ensure that requirements, constraints, and designs are fully understood and approved first, which prevents wasted effort and architectural errors during the implementation phase.

Can I use this for very small projects or bug fixes?

Yes. The skill is designed to prevent the 'this is too simple to need a design' anti-pattern. Even for small projects, a brief design phase helps surface unexamined assumptions that often lead to bugs.

What happens after the brainstorming session is finished?

Once the design is approved and the spec is written, the skill automatically transitions to the 'writing-plans' skill to create a detailed, step-by-step implementation roadmap.

What is the Visual Companion feature?

The Visual Companion is a browser-based tool that Claude uses to show you mockups, diagrams, and layout comparisons during the brainstorming process, making it easier to discuss UI and architectural concepts.

How does the Spec Review Loop work?

After a design document is drafted, the skill dispatches a specialized subagent to review the spec for clarity and completeness. It iterates on the document until it passes review or reaches a five-iteration limit.

Brainstorming Claude Code Skill | Design & Spec Discovery

The Brainstorming skill acts as a vital architectural gatekeeper for Claude Code, ensuring that every project—regardless of perceived simplicity—is grounded in a validated design before implementation begins. It guides users through a structured discovery process that includes context exploration, iterative clarifying questions, and the evaluation of multiple technical approaches. By integrating a visual companion for mockups and a multi-stage spec review loop, this skill helps teams decompose complex requirements, align on technical trade-offs, and generate rigorous documentation that serves as the foundation for successful code generation.

主な機能

013 GitHub stars

02Automated spec review loop with subagent verification to ensure technical documentation quality

03Intelligent plan location discovery for seamless integration into existing documentation structures

04Interactive visual companion for rendering mockups and architectural diagrams in a browser

05Multi-approach proposal system that presents trade-offs and recommendations for every feature

06Strict hard-gate validation requiring user approval of designs before any code is written

ユースケース

01Aligning team members on UI/UX layouts and data flow logic through visual wireframing

02Refining complex system architectures for existing codebases to prevent technical debt and unexamined assumptions

03Decomposing monolithic feature requests into manageable, phased sub-projects and technical specs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add moonsong-labs/knowledge-work-plugins brainstorming

For use in Claude.ai and ChatGPT

主な機能

013 GitHub stars

02Automated spec review loop with subagent verification to ensure technical documentation quality

03Intelligent plan location discovery for seamless integration into existing documentation structures

04Interactive visual companion for rendering mockups and architectural diagrams in a browser

05Multi-approach proposal system that presents trade-offs and recommendations for every feature

06Strict hard-gate validation requiring user approval of designs before any code is written

ユースケース

01Aligning team members on UI/UX layouts and data flow logic through visual wireframing

02Refining complex system architectures for existing codebases to prevent technical debt and unexamined assumptions

03Decomposing monolithic feature requests into manageable, phased sub-projects and technical specs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add moonsong-labs/knowledge-work-plugins brainstorming

For use in Claude.ai and ChatGPT

AI Design Brainstorming

AI Design Brainstorming

主な機能

ユースケース

主な機能

ユースケース