Why does this skill require a collab session?

It uses a persistent .collab/ directory to maintain design state, store Mermaid diagrams, and track your progress through the mandatory brainstorming phases.

What is the primary purpose of the Brainstorming skill?

It is designed to help you explore user intent, gather specific requirements, and finalize technical designs before any code is actually written or modified.

What happens after the Brainstorming phase is complete?

Once the design passes the final validation gate, the skill facilitates a transition to the rough-draft phase to begin the implementation process.

How does this skill use Mermaid diagrams?

It automatically identifies opportunities to visualize complexity, creating architecture, sequence, or state diagrams to help you see how components interact.

Can I skip the clarification phase and go straight to design?

No, the skill follows a strict state machine to ensure no requirements are missed, requiring explicit confirmation of items before moving to the designing phase.

Brainstorming Designer

Name: Brainstorming Designer
Author: ben-mad-jlp

byben-mad-jlp

0•

협업 도구

Guides the transition from initial ideas to structured technical designs through a collaborative, phase-based dialogue and real-time diagramming.

The Brainstorming skill is a sophisticated workflow engine for Claude Code that ensures software features are fully explored and documented before implementation begins. It follows a strict five-phase state machine—Exploring, Clarifying, Designing, and Validating—to prevent premature coding and scope creep. By integrating real-time Mermaid diagrams and a collaborative session environment, it helps developers refine requirements, explore architectural trade-offs, and produce comprehensive design documents that serve as the foundation for the next development stages.

주요 기능

01Structured one-item-at-a-time clarification to prevent information overload

020 GitHub stars

03Automated design document creation with incremental validation sections

04Deep integration with collab sessions for persistent project context

05Strict five-phase design state machine to ensure requirement completeness

06Real-time Mermaid diagram generation for architectural and data-flow visualization

사용 사례

01Investigating and documenting the root cause and fix approach for a tricky bug

02Breaking down broad project goals into concrete, validated task specifications

03Defining the architecture and data flow for a complex new software feature

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ben-mad-jlp/claude-mermaid-collab brainstorming

For use in Claude.ai and ChatGPT

Download Skill