brainstorming

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

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/ravenslight2010/Production-run-calculator --skill brainstorming-ravenslight2010
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/ravenslight2010/Production-run-calculator/tree/main/.agents/skills/brainstorming
Command: npx skills add https://github.com/ravenslight2010/Production-run-calculator --skill brainstorming-ravenslight2010

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, approved design specs before any implementation begins. ## Core Features & Use Cases - Guided Requirements Discovery: Explores project context, then asks clarifying questions one at a time to pin down purpose, constraints, and success criteria. - Design Proposal and Approval Gate: Proposes 2-3 approaches with trade-offs, presents the design in sections, and blocks all implementation until the user approves a written spec saved to docs/superpowers/specs/. - Browser-Based Visual Companion: Optionally serves live HTML mockups, diagrams, and side-by-side layout comparisons via a local WebSocket server, recording user clicks as structured events. - Use Case: Before adding a new scheduling feature to a web app, use this Skill to interview yourself on requirements, compare architecture options visually, and commit a reviewed design document that an implementation plan can follow. ## Quick Start Ask the agent to brainstorm the design for your next feature before writing any code.

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 before any code is written.

What is the visual companion in the brainstorming skill?▼

The visual companion is a browser-based tool that serves HTML mockups, diagrams, and layout comparisons from a local server. It is offered only when a question is genuinely visual, and user clicks are recorded as JSON events for the agent to read.

Does the brainstorming skill work for small changes?▼

Yes, every project goes through the process regardless of size. For simple changes the design can be just a few sentences, but it must still be presented and approved before implementation begins.

Where does the brainstorming skill save design documents?▼

Approved designs are written to docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md and committed to git. User preferences for spec location override this default path.

Why won't the brainstorming skill let me start coding immediately?▼

It enforces a hard gate that blocks implementation until a design is presented and approved. This prevents wasted work from unexamined assumptions, which the skill identifies as the most common failure mode in seemingly simple projects.