Where are the design specifications stored?

Design docs are automatically saved to your repository, typically in the docs/superpowers/specs/ directory, ensuring your technical decisions are version-controlled.

What is the Visual Companion feature?

It is a browser-based tool that Claude can invoke to show you visual mockups, diagrams, and layout comparisons when text alone isn't sufficient to explain a design.

How does it handle large, multi-part projects?

It identifies high-scope requests and helps you decompose them into independent subsystems, brainstorming each one through its own spec-to-implementation cycle.

Why does this skill prevent me from coding immediately?

The skill uses a 'Hard Gate' to ensure that unexamined assumptions don't lead to wasted work. By forcing a design phase, it ensures the final implementation is robust and meets all requirements.

Brainstorming & Design Architect

Name: Brainstorming & Design Architect
Author: SwervoJake

bySwervoJake

0•

生産性とワークフロー

Transforms raw project ideas into structured technical designs and specifications through collaborative dialogue before implementation begins.

This skill acts as a mandatory pre-implementation phase for Claude, enforcing a 'design-first' workflow to prevent wasted effort and technical debt. It guides users through context exploration, iterative requirement gathering, and the evaluation of multiple architectural approaches. By requiring formal approval of a design document before any code is written, it ensures that projects—regardless of size—are built with clear boundaries, robust error handling, and logical data flows. It even includes a Visual Companion for rendering diagrams and mockups directly in your browser.

主な機能

01Comparative analysis of 2-3 architectural approaches with detailed trade-offs.

02Iterative requirement gathering via one-at-a-time clarifying questions to avoid overwhelm.

03Automated generation and versioning of Markdown design specifications in your repository.

04Hard-gate enforcement prevents any code implementation until a design is approved.

05Visual Companion integration for browser-based mockups, wireframes, and architecture diagrams.

060 GitHub stars

ユースケース

01Refining user intent and edge cases for new components before writing a single line of code.

02Standardizing documentation by automatically generating and committing design specs to the codebase.

03Decomposing large, complex feature requests into smaller, manageable sub-projects.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add swervojake/claaaude-studio brainstorming

For use in Claude.ai and ChatGPT

主な機能

01Comparative analysis of 2-3 architectural approaches with detailed trade-offs.

02Iterative requirement gathering via one-at-a-time clarifying questions to avoid overwhelm.

03Automated generation and versioning of Markdown design specifications in your repository.

04Hard-gate enforcement prevents any code implementation until a design is approved.

05Visual Companion integration for browser-based mockups, wireframes, and architecture diagrams.

060 GitHub stars

ユースケース

01Refining user intent and edge cases for new components before writing a single line of code.

02Standardizing documentation by automatically generating and committing design specs to the codebase.

03Decomposing large, complex feature requests into smaller, manageable sub-projects.