How does the Socratic questioning phase work?

The skill asks targeted, one-at-a-time questions to clarify the problem, user needs, and success metrics before proposing any technical solutions.

Can I revisit earlier design phases?

Absolutely. The workflow is non-linear; if a new constraint is discovered during the design phase, the skill encourages going back to the understanding or exploration phases.

Does this skill generate the final source code?

This skill focuses on the architectural design and planning stage. Once the design is approved, it hands off to a plan-writing skill to begin implementation.

Does this skill help prevent over-engineering?

Yes, it adheres to YAGNI (You Ain't Gonna Need It) principles and requires exploring multiple alternatives to ensure the simplest effective solution is chosen.

Brainstorming & Design

Name: Brainstorming & Design
Author: a-ariff

bya-ariff

0•

Productivity & Workflow

Transforms vague feature ideas into concrete technical designs through structured Socratic questioning and iterative feedback.

The Brainstorming skill helps developers bridge the gap between a rough concept and a production-ready implementation plan. By employing a Socratic questioning method, it guides users through a four-phase workflow: understanding core requirements, exploring architectural alternatives, refining design components in manageable chunks, and handing off the final blueprint for implementation. It ensures technical decisions are documented and validated incrementally, preventing over-engineering and aligning solutions with actual user needs before a single line of code is written.

Key Features

01Incremental design documentation delivered in manageable segments

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

03Seamless handoff to implementation planning workflows

04Structured Socratic questioning to uncover hidden technical constraints

050 GitHub stars

06Non-linear workflow allowing for backtracking as new information emerges

Use Cases

01Refining a vague feature request into a technical specification

02Documenting the rationale behind technical decisions for team alignment

03Evaluating multiple architectural approaches for a new system component

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add a-ariff/ariff-code-config brainstorming

For use in Claude.ai and ChatGPT

Download Skill