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.