brainstorming

Create a design blueprint with clarifying questions and approval gates before coding.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/rhuangabrielsantos/skills --skill brainstorming-rhuangabrielsantos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/rhuangabrielsantos/skills/tree/main/skills/brainstorming
Command: npx skills add https://github.com/rhuangabrielsantos/skills --skill brainstorming-rhuangabrielsantos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Many development efforts begin without a clear design, leading to wasted time, mis‑aligned expectations, and costly rework. This Skill forces a structured brainstorming phase that uncovers intent, requirements, and architectural decisions before any code is written.

Core Features & Use Cases

  • Context exploration: Reviews project files, recent commits, and documentation to build a shared understanding.
  • Visual companion offering: Optionally presents mockups or diagrams when visual clarification is beneficial.
  • Clarifying questions: Asks one question at a time to refine purpose, constraints, and success criteria.
  • Approach proposals: Generates 2‑3 viable solutions with trade‑offs and a recommendation.
  • Design specification: Produces a structured design doc, performs self‑review, and stores it in docs/superpowers/specs/.
  • User approval gate: Requires explicit user sign‑off before any implementation steps.
  • Transition to planning: Hands off to the writing-plans skill to create an implementation plan.

Quick Start

Start by saying, “I want to design a new feature for the project; please guide me through the brainstorming process.”

Frequently Asked Questions about brainstorming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a software design specification before writing any code?

To create a software design specification, this skill explores project context, asks clarifying questions, and proposes viable approaches with trade-offs. It outputs a structured design doc stored in the specs directory and requires explicit user approval before any implementation begins.

What is the best way to brainstorm software architecture and requirements for a new feature?

Brainstorming software architecture involves reviewing project files and commits, then asking targeted questions to define constraints and success criteria. This skill generates two to three solution proposals with a recommendation, producing a detailed design blueprint prior to coding.

Can I generate visual mockups and diagrams during the software planning phase?

Yes, visual mockups and diagrams can be generated during planning. This skill integrates an optional visual companion that presents diagrams when visual clarification is beneficial for aligning on the architectural design and feature requirements.

Does this design specification process prevent code generation until approval?

Yes, the design specification process enforces hard gates to prevent code generation. It requires explicit user sign-off on the proposed design doc before allowing any transition to implementation planning and writing code.

How do I transition from a design spec to an implementation plan for software development?

To transition from a design spec to an implementation plan, this skill hands off to the writing-plans skill after user approval. It completes the architectural brainstorming phase and passes the structured specification directly to the planning workflow.