brainstorming

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

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/Aadi-110i/PEP-PROJECT --skill brainstorming-aadi-110i
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/Aadi-110i/PEP-PROJECT/tree/main/skills/brainstorming
Command: npx skills add https://github.com/Aadi-110i/PEP-PROJECT --skill brainstorming-aadi-110i

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 misaligned features. This Skill enforces a structured discovery process that turns rough ideas into reviewed, approved design specs before any implementation begins. ## Core Features & Use Cases - Structured Discovery Workflow: 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 Document Generation: Writes the validated design to a dated spec file, runs a self-review for placeholders, contradictions, and scope issues, then gates implementation behind explicit user approval. - Visual Companion Server: Includes a Node.js WebSocket server and shell scripts that serve browser-based mockups, diagrams, and clickable option screens, recording user selections for visual design questions. - Use Case: Before building a new dashboard feature, use this Skill to interview yourself on requirements, compare architecture options, review wireframes in the browser, and commit an approved spec document that a planning skill can turn into an implementation plan. ## Quick Start Ask the AI to brainstorm and design the feature you have in mind before writing any code, answering 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 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 presents a design for your approval before any code is written.

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

A design spec is a Markdown document capturing the approved 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 before planning begins.

Does the brainstorming skill work for small or simple projects?

Yes, the skill explicitly requires a design for every project regardless of perceived simplicity, though the design can be just a few sentences for trivial work. The hard gate prevents skipping straight to implementation.

How do I show UI mockups during AI brainstorming sessions?

The skill includes a visual companion: run scripts/start-server.sh with your project directory to launch a local Node.js server, then the agent writes HTML mockups that appear in your browser. Your clicks are recorded as events the agent reads on the next turn.

Why does the brainstorming server stop responding?

The server automatically shuts down after 30 minutes of inactivity or when its owner process exits. Check the state directory for a server-stopped file and restart it with start-server.sh before pushing new screens.

When should I not use a visual mockup companion?

Skip the browser for conceptual questions, requirements discussions, tradeoff lists, and text-based A/B choices, since those are better answered in the terminal. Use the browser only when the content itself is visual, such as layouts, wireframes, or diagrams.