What is the primary purpose of the Brainstorming skill?

It ensures that no implementation occurs before a design is presented and approved, preventing wasted work caused by unexamined assumptions.

Where does it save the design documents?

Designs are saved as version-controlled Markdown files in the `docs/plans/` directory with a standardized date-based naming convention.

Why does it only ask one question at a time?

This approach reduces cognitive load and ensures high-quality communication, allowing the user to focus on refining one specific constraint or requirement at a time.

Does this skill write any code?

No. The Brainstorming skill is strictly for exploration and design. It intentionally transitions to the 'writing-plans' skill for implementation planning once a design is approved.

Brainstorming & Design Architect

Name: Brainstorming & Design Architect
Author: AhmedElhadarey

byAhmedElhadarey

•

Productivity & Workflow

Guides developers through a structured discovery and design process to validate requirements before any code is written.

The Brainstorming skill is a mandatory architectural safeguard designed to prevent wasted effort by ensuring a shared understanding of project goals before implementation. It forces a collaborative dialogue where Claude explores project context, asks clarifying questions one at a time, and proposes multiple technical approaches with distinct trade-offs. By enforcing a 'design-first' hard-gate, it ensures that every feature—regardless of perceived simplicity—is backed by a version-controlled design document and explicit user approval, leading to more maintainable and purpose-driven codebases.

Key Features

01Section-by-section design approval workflow

02Automated design document generation and Git commit integration

032 GitHub stars

04Enforced 'Hard-Gate' design validation before implementation

05Comparative analysis of 2-3 architectural approaches

06Iterative clarification using one-question-at-a-time dialogue

Use Cases

01Aligning on implementation strategy for simple utilities to avoid scope creep

02Defining technical requirements for complex new features

03Documenting architectural decisions and trade-offs for future maintainers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ahmedelhadarey/gilfoyle brainstorming

For use in Claude.ai and ChatGPT

Download Skill