brainstorming

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

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/bill80362/laravel-thread-admin --skill brainstorming-bill80362
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/bill80362/laravel-thread-admin/tree/main/.github/superpowers/brainstorming
Command: npx skills add https://github.com/bill80362/laravel-thread-admin --skill brainstorming-bill80362

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, misunderstood requirements, and wasted effort. This Skill enforces a structured brainstorming workflow that turns vague ideas into reviewed, approved design specifications before any implementation begins. ## Core Features & Use Cases - Structured Design Dialogue: Explores project context, asks one clarifying question at a time, presents 2-3 approaches with trade-offs, and walks through the design section by section for user approval. - Specification Document Generation: Writes the validated design to a dated spec file under docs/superpowers/specs/, runs a self-check for placeholders, contradictions, ambiguity, and scope, then commits it to git. - Visual Companion Server: Ships a local Node.js WebSocket server that serves HTML prototypes, wireframes, and A/B layout comparisons in the browser, capturing user click events for feedback. - Use Case: Before building a new feature like a scheduled-posting module, use this Skill to clarify requirements, compare architectural options, and produce an approved spec that a planning 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 with an AI coding agent?

Invoke the brainstorming skill before any implementation work. It explores your project context, asks one clarifying question at a time, presents 2-3 approaches with trade-offs, and produces a written design document you approve before planning begins.

What is a design specification document in an AI coding workflow?

It is a Markdown file capturing the validated architecture, components, data flow, error handling, and testing approach for a feature. This skill writes it to docs/superpowers/specs/ with a dated filename and commits it to git after your review.

Does the brainstorming skill write code or start implementation?

No. A hard gate prevents any implementation action until the design is presented and approved. The only skill it invokes afterward is writing-plans, which creates the implementation plan from the approved spec.

How does the visual companion browser preview work?

A local Node.js server started via scripts/start-server.sh serves HTML snippets you write to a session directory. The browser shows prototypes and option cards, and user clicks are recorded as JSON events the agent reads on the next turn.

When should I skip the brainstorming and design phase?

According to the skill, never. Even small changes like a config tweak or single-function tool go through the process, though the design can be just a few sentences for genuinely simple work.