brainstorming

Guides collaborative design exploration and spec writing before any implementation work begins.

1|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/akashjpal/question-generator --skill brainstorming-akashjpal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/akashjpal/question-generator/tree/main/.agents/skills/brainstorming
Command: npx skills add https://github.com/akashjpal/question-generator --skill brainstorming-akashjpal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Jumping straight into code without a validated design leads to wasted work, unexamined assumptions, and rework. This Skill enforces a structured discovery process that turns rough ideas into reviewed, approved design specs before any implementation starts. ## Core Features & Use Cases - Structured Discovery Checklist: 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 Writing and Review Loop: Writes the approved design to a dated spec file, runs a self-review for placeholders, contradictions, ambiguity, and scope, then gates implementation on explicit user approval. - Visual Companion Server: Includes a Node.js WebSocket server that serves browser-based mockups, diagrams, and clickable option screens when a question is better shown than described. - Use Case: Before building a new feature, invoke this Skill to interview yourself about requirements, compare architectural approaches, and produce a committed design document that an implementation-planning skill can consume. ## 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 agent before coding?

Invoke the brainstorming skill and describe your idea. The agent explores your project context, asks one clarifying question at a time, proposes 2-3 approaches with trade-offs, and presents a design section by section for your approval.

What happens after the design is approved in the brainstorming workflow?

The approved design is written to a dated spec file under docs/superpowers/specs/ and committed to git. After a self-review and your explicit approval of the spec, the skill invokes the writing-plans skill to create an implementation plan.

Can I skip the design step for very small changes?

No. The skill enforces a hard gate: no implementation skill, code, or scaffolding may be invoked until a design is presented and approved. For truly simple projects the design can be just a few sentences, but approval is still required.

How does the visual companion browser mockup feature work?

A Node.js server serves HTML screens you write to a session directory and pushes them to the user's browser over WebSocket. Users click options in the browser, and their selections are recorded as JSON events the agent reads on the next turn.

Why does the brainstorming server URL include a key parameter?

The per-session key authenticates HTTP and WebSocket access so stray browser tabs or other machines cannot read screens or inject events. It is mirrored into a cookie after first load and persisted so restarts reuse the same URL.

When should a large project be decomposed instead of designed directly?

When a request describes multiple independent subsystems, the skill flags it immediately and helps decompose the work into sub-projects. Each sub-project then gets its own brainstorm, spec, plan, and implementation cycle.