brainstorming

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

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/kxnzee/multi-repo-specs --skill brainstorming-kxnzee
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/kxnzee/multi-repo-specs/tree/main/extensions/superpowers/skills/brainstorming
Command: npx skills add https://github.com/kxnzee/multi-repo-specs --skill brainstorming-kxnzee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Teams often jump into coding before clarifying requirements, leading to rework and misaligned implementations. This Skill enforces a structured design-first workflow that explores user intent, constraints, and alternatives before any code is written. ## Core Features & Use Cases - Structured Discovery Dialogue: Explores project context, asks clarifying questions one at a time, and proposes 2-3 approaches with trade-offs before settling on a design. - Design Spec Generation: Writes validated design documents to dated spec files, runs a self-review for placeholders and contradictions, and gates implementation behind explicit user approval. - Visual Companion Server: Includes a browser-based companion (Node.js server with WebSocket) for presenting mockups, diagrams, and layout options when questions are better shown than described. - Use Case: Before building a new feature, invoke this Skill to interview stakeholders, compare architectural approaches, produce an approved spec document, and then hand off to an implementation-planning skill. ## 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 a dated file.

What is the visual companion in the brainstorming skill?▼

The visual companion is a browser-based tool that shows mockups, diagrams, and layout options during brainstorming. A local Node.js server serves HTML screens you write, and user clicks are recorded as JSON events for the agent to read.

Does the brainstorming skill work with OpenSpec workflows?▼

Yes. When invoked for an OpenSpec artifact, the caller's instructions govern output location and lifecycle. The skill finishes only the requested artifact and returns to the OpenSpec caller instead of auto-invoking implementation planning.

Can I skip the design step for very simple projects?▼

No. The skill enforces a hard gate requiring a presented design and user approval for every project regardless of perceived simplicity. The design can be short for simple projects, but approval is mandatory before implementation.

Why does the brainstorming server URL require a session key?▼

The server generates a per-session secret key embedded in the URL as ?key= to authenticate browser access. This prevents other local tabs or network hosts from reading screens or injecting events, and the key persists across server restarts.