Where are the final design documents stored?

Once a design is validated, the skill writes a concise document to the 'docs/plans/' directory and commits it to git for version tracking.

When should I use the Brainstorming skill?

Use it during the initial phase of a project when requirements are still fuzzy, or when you need to choose between multiple technical approaches before writing code.

How does this skill help prevent over-engineering?

The skill ruthlessly applies the YAGNI (You Ain't Gonna Need It) principle, focusing the design only on what is necessary to solve the immediate problem.

Does this skill automatically generate code?

No, it is specifically designed for the pre-coding phase. It focuses on refining ideas and creating a validated design document to guide later implementation.

Design Brainstorming

Name: Design Brainstorming
Author: Krosebrook

byKrosebrook

•

Productivity & Workflow

Transforms vague project ideas into structured architectural designs through iterative questioning and collaborative validation.

The Design Brainstorming skill helps developers bridge the gap between initial concepts and concrete implementation plans by facilitating a guided, conversational design process. It utilizes a structured approach to explore project context, propose multiple architectural alternatives with clear tradeoffs, and validate design sections incrementally to prevent misalignment. By adhering to YAGNI principles and requiring one-at-a-time questioning, this skill ensures that requirements are fully understood and documented in standardized markdown plans before any code is written, significantly reducing technical debt and over-engineering.

Key Features

01Iterative questioning to clarify fuzzy or incomplete requirements

02Automatic generation of structured design documents in Markdown

03YAGNI-focused planning to eliminate unnecessary feature creep

041 GitHub stars

05Comparative analysis of architectural alternatives with clear pros and cons

06Incremental design validation to catch misunderstandings early

Use Cases

01Refining vague product requirements into actionable technical specifications

02Evaluating tradeoffs between different third-party integrations or service patterns

03Developing high-level architectures for new features with multiple implementation paths

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add krosebrook/source-of-truth-monorepo brainstorming

For use in Claude.ai and ChatGPT

Download Skill