brainstorming

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

3|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill brainstorming-burningportra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/brainstorming
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill brainstorming-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? AI coding agents often jump straight into implementation without understanding requirements, leading to wasted work on unexamined assumptions. This Skill enforces a structured design dialogue that explores intent, constraints, and approaches before any code is written. ## Core Features & Use Cases - Structured Design Dialogue: 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 user approval. - Spec Document Generation: Writes the approved design to a dated spec file in docs/superpowers/specs/, runs a self-review for placeholders and contradictions, and gates implementation behind explicit user approval. - Visual Companion: Optionally serves browser-based mockups, wireframes, and side-by-side comparisons via a local WebSocket server, recording user click selections for feedback. - Use Case: Before building a new feature, use this Skill to interview yourself about requirements, compare architectural approaches, and produce a committed design document that feeds directly into implementation planning. ## 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 clarifying questions one at a time, proposes 2-3 approaches with trade-offs, and presents the design in sections for your approval before writing a spec document.

What happens after the design is approved in brainstorming?

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

Can I see visual mockups during the brainstorming process?

Yes, the skill offers an optional visual companion that serves HTML mockups and diagrams in your browser via a local server. You click options in the browser, and your selections are recorded as events the agent reads on its next turn.

Does brainstorming apply to small or simple projects?

Yes, the skill enforces a hard gate requiring a presented and approved design for every project regardless of perceived simplicity. The design can be only a few sentences for trivial work, but approval is mandatory before implementation.

Why does the brainstorming server stop responding?

The companion server auto-exits after 30 minutes of inactivity or when its owner process dies. Check for the server-stopped file in the session state directory and restart it with start-server.sh before pushing new screens.