How does the Brainstorming skill prevent over-engineering?

The skill follows the YAGNI (You Ain't Gonna Need It) principle, ensuring that designs focus strictly on solving the identified problem without adding unnecessary complexity.

Does this skill actually write the implementation code?

No, this skill focuses on the design phase. Once the design is approved, it facilitates a handoff to the writing-plans skill to create the actual implementation roadmap.

Can I use this skill on an existing codebase?

Yes. Before asking questions, the skill checks your working directory to ensure that any new designs or features integrate seamlessly with your current technical stack.

What happens if I change my mind during the design process?

The workflow is intentionally non-linear. You can revisit earlier phases at any time if new constraints are discovered or if a proposed design doesn't feel right.

System Design Brainstorming

Name: System Design Brainstorming
Author: a-ariff

bya-ariff

•

Productivity & Workflow

Transforms abstract feature ideas into structured technical designs through Socratic questioning and multi-phase architectural planning.

The Brainstorming skill acts as a bridge between high-level concepts and technical implementation by guiding users through a structured four-phase workflow: Understand, Explore, Design, and Handoff. It employs Socratic questioning to uncover hidden requirements and constraints while presenting multiple architectural approaches to ensure the best solution is chosen. By validating designs incrementally and documenting decisions, this skill prevents costly rework and ensures that every feature is built on a solid, well-vetted foundation before a single line of implementation code is written.

Key Features

01Guided Socratic questioning to identify user needs and technical constraints

02Comparative architecture analysis with pros, cons, and complexity ratings

031 GitHub stars

04Incremental design validation in digestible 200-300 word chunks

05Automatic context awareness by scanning the existing working directory

06Seamless integration with implementation planning tools for immediate execution

Use Cases

01Evaluating multiple architectural patterns for a new service or module

02Documenting design decisions and tradeoffs before beginning a sprint

03Refining a vague feature request into a detailed technical specification

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add a-ariff/ariff-claude-plugins brainstorming

For use in Claude.ai and ChatGPT

Download Skill