What format does the skill use for design documentation?

Once a design is validated through the dialogue, the skill automatically writes a concise summary of the decisions and rationale to a Markdown file in the docs/plans/ directory and commits it to your git repository.

When should I avoid using the Brainstorming skill?

You should skip this skill for clear mechanical tasks with obvious solutions, well-defined requirements with standard implementations, or simple bug fixes where a design phase would be overkill.

Why does the skill present multiple approaches instead of just one?

Presenting alternatives with explicit tradeoffs (such as complexity vs. flexibility) allows the developer to consider the design space fully and ensures the final recommendation aligns with project priorities.

How does the Brainstorming skill help with vague requirements?

It uses a structured questioning technique, asking one clarifying question at a time and offering multiple-choice options to narrow down the project's purpose, constraints, and success criteria without overwhelming the user.

Brainstorming & Architectural Design

Name: Brainstorming & Architectural Design
Author: Light-Brands

byLight-Brands

0•

Productivity & Workflow

Facilitates structured design sessions to transform rough ideas into validated architectural plans before any code is written.

The Brainstorming skill helps developers navigate fuzzy requirements and complex implementation choices through a natural, iterative dialogue. By focusing on one question at a time and presenting multiple architectural approaches with clear tradeoffs, it ensures that project designs are thoroughly vetted and documented before execution begins. This skill prevents premature implementation by ruthlessly applying YAGNI principles and requiring incremental validation of every design section, ultimately committing finalized plans directly to your repository.

Key Features

01Incremental design validation to catch logic errors or misunderstandings early

020 GitHub stars

03Seamless transition from validated plans to isolated development workspaces

04Guided architectural discovery via structured, one-at-a-time probing questions

05Automatic generation and versioning of design documentation in Markdown format

06Multi-option alternative exploration with detailed pros, cons, and tradeoff analysis

Use Cases

01Validating complex design decisions and technical rationale before starting a major feature

02Clarifying vague or incomplete project requirements through collaborative dialogue

03Defining a robust system architecture when multiple implementation paths are available

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add light-brands/lawless-ai-v1 brainstorming

For use in Claude.ai and ChatGPT

Download Skill