How does the skill help with decision-making?

It proposes 2-3 different technical approaches for every design, explaining the trade-offs of each and providing a recommended path based on your project context.

What is the 'incremental validation' process?

Instead of overwhelming you with a large document, the skill presents the design in 200-300 word sections and asks for your confirmation after each part.

Why should I use the brainstorming skill before coding?

Using it ensures you have a validated design and clear requirements, which prevents technical debt and wasted effort during the implementation phase.

Where does the skill store the finalized design?

The skill automatically writes the validated design to a timestamped file in the docs/plans/ directory and commits it to your git repository.

Brainstorming & Design Planning

Name: Brainstorming & Design Planning
Author: guaderrama

byguaderrama

0•

Collaboration Tools

Facilitates structured collaborative dialogue to transform raw ideas into validated technical designs and documentation.

This skill establishes a rigorous pre-implementation workflow that ensures user intent and requirements are fully understood before any code is written. By guiding users through a series of focused, one-at-a-time questions and presenting multiple architectural approaches with trade-offs, it minimizes wasted effort and aligns implementation with project goals. The process concludes with incremental validation of the design and the automated creation of timestamped documentation in the project repository, making it an essential tool for maintaining architectural integrity and preventing feature creep.

Key Features

01Incremental design validation using small, digestible 200-300 word sections

02Comparative analysis of 2-3 architectural approaches with reasoned recommendations

03Automated documentation generation and git commitment for design plans

04Step-by-step Socratic questioning to refine user intent and project constraints

050 GitHub stars

06Ruthless application of YAGNI principles to eliminate unnecessary features

Use Cases

01Defining the technical specification for a new feature before starting development

02Evaluating different architectural trade-offs for complex component refactors

03Standardizing the project design phase with automated documentation and versioning

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add guaderrama/cabo-health-ai brainstorming

For use in Claude.ai and ChatGPT

Download Skill