brainstorming

Guides collaborative design exploration and produces approved spec documents before implementation.

1|Updated Oct 11, 2025
One-click install
npx skills add https://github.com/ibytechaos/claude --skill brainstorming-ibytechaos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/ibytechaos/claude/tree/main/plugins/superpowers/skills/brainstorming
Command: npx skills add https://github.com/ibytechaos/claude --skill brainstorming-ibytechaos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Jumping straight into code without a validated design leads to rework, unexamined assumptions, and misaligned features. This Skill enforces a structured dialogue that turns rough ideas into reviewed, committed design specs before any implementation begins. ## Core Features & Use Cases - Structured Design Dialogue: Explores project context, asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, and presents the design in sections for incremental approval. - Spec Document Workflow: Writes the approved design to docs/superpowers/specs/, runs a self-review for placeholders and contradictions, and gates implementation behind explicit user review. - Visual Companion Server: Includes a Node.js WebSocket server that serves HTML mockups, wireframes, and option cards to a browser so users can click to select visual choices during brainstorming. - Use Case: Before building a new feature, use this Skill to decompose scope, compare architectural approaches, and produce a committed design document that the writing-plans skill can turn into an implementation plan. ## 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 document saved to docs/superpowers/specs/.

What is the visual companion in the brainstorming skill?

The visual companion is a browser-based tool that displays mockups, wireframes, and option cards during brainstorming. A local Node.js server serves HTML screens you write, and user clicks are recorded as JSON events you read on the next turn.

Does the brainstorming skill work for small or simple projects?

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

How do I start the brainstorming visual companion server?

Run scripts/start-server.sh with --project-dir pointing at your project root. It returns a JSON object with the URL, screen_dir, and state_dir; on Windows or Codex environments it auto-switches to foreground mode.

What happens after the design spec is approved?

After the user approves the written spec, the skill invokes the writing-plans skill to create a detailed implementation plan. It explicitly does not invoke any other implementation skill such as frontend-design or mcp-builder.