brainstorming

Guides collaborative design dialogue to turn ideas into approved specs before implementation.

3|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/firstsun-dev/skills --skill brainstorming-firstsun-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/firstsun-dev/skills/tree/main/plugins/agent-toolkit/skills/brainstorming
Command: npx skills add https://github.com/firstsun-dev/skills --skill brainstorming-firstsun-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Teams and agents often jump straight into code before requirements are understood, producing rework from unexamined assumptions. This Skill enforces a structured design dialogue that explores intent, constraints, and approaches, then produces a reviewed spec document before any implementation begins. ## 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 authoring and review gates: Writes the approved design to a dated spec file, runs a self-review for placeholders, contradictions, ambiguity, and scope, then requires user sign-off before invoking the writing-plans skill. - Browser-based visual companion: Serves mockups, wireframes, and side-by-side layout comparisons through a local WebSocket server so visual questions can be answered by seeing options rather than reading descriptions. - Use Case: Before adding a new feature to an existing codebase, run this Skill to explore the current structure, compare architectural approaches, and commit an approved design document that an implementation plan can be built from. ## Quick Start Ask the agent to brainstorm the feature you want to build and answer its clarifying questions until it presents a design for your approval.

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 with an AI coding agent?▼

Invoke the brainstorming flow before any implementation work. The agent explores your project context, asks one clarifying question at a time, proposes 2-3 approaches with trade-offs, and presents the design in sections for your approval.

What happens after the design is approved in brainstorming?▼

The approved design is written to a dated spec file under docs/superpowers/specs/ and committed to git. After a self-review for placeholders, contradictions, and scope, plus your review of the spec, the writing-plans skill is invoked to create the implementation plan.

Can I see visual mockups during the brainstorming process?▼

Yes, a browser-based visual companion can show mockups, wireframes, and side-by-side layout comparisons. It is offered only when a question is genuinely visual, and it runs as a local server that opens in your browser after you approve it.

Does brainstorming apply to small or simple changes?▼

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

Why won't the agent write code right after I describe my idea?▼

The skill enforces a hard gate that blocks implementation until a design is presented and approved. This prevents wasted work from unexamined assumptions, which is most common in projects that seem too simple to need a design.