brainstorming

Guides collaborative design exploration through clarifying questions, approach proposals, and approved spec documents.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/ttphats/project-detedxs26 --skill brainstorming-ttphats
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/ttphats/project-detedxs26/tree/main/.augment/skills/superpowers/brainstorming
Command: npx skills add https://github.com/ttphats/project-detedxs26 --skill brainstorming-ttphats

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Jumping straight into implementation without understanding requirements leads to wasted work and misaligned features. This Skill enforces a structured design dialogue that turns vague ideas into validated, written specifications before any code is written. ## Core Features & Use Cases - Structured Design Dialogue: Explores project context, asks one clarifying question at a time, proposes 2-3 approaches with trade-offs, and presents the design in sections for incremental approval. - Spec Document Generation: Writes the approved design to a dated spec file, runs a self-review for placeholders and contradictions, and gates implementation behind user review. - Visual Companion Server: Includes a local browser companion (Node.js server with WebSocket) for showing mockups, layout comparisons, and diagrams when questions benefit from visual treatment. - Use Case: Before building a new feature like a seat-selection UI, use this Skill to clarify requirements, compare layout approaches visually, and produce an approved spec that feeds directly into implementation planning. ## Quick Start Ask the agent to brainstorm the design for your next feature before writing any code, and answer its clarifying questions one at a time.

Frequently Asked Questions about brainstorming

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

FAQPage Schema
How do I brainstorm a feature design before writing code?▼

Invoke the brainstorming skill before any implementation work. It explores your project context, asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, and produces an approved design spec saved to docs/superpowers/specs/.

What is a design spec document and when should I write one?▼

A design spec is a written record of architecture, components, data flow, error handling, and testing decisions. Write one after the design is approved in dialogue but before implementation planning, so reviewers can catch contradictions and scope issues early.

Can I show UI mockups in a browser during brainstorming?▼

Yes. The skill includes a visual companion: a local Node.js server started via scripts/start-server.sh that serves HTML mockups to your browser. User clicks are recorded as JSON events that the agent reads on the next turn.

Does the brainstorming skill work for small or simple projects?▼

Yes, every project goes through the process regardless of perceived simplicity. The design can be just a few sentences for trivial changes, but it must still be presented and approved before implementation begins.

Why does the brainstorming server stop responding?▼

The companion server auto-exits after 30 minutes of inactivity or when its owner process dies. Check for a server-stopped file in the session state directory and restart it with scripts/start-server.sh.