brainstorming

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

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/gyc-12/Archipelago --skill brainstorming-gyc-12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/gyc-12/Archipelago/tree/main/modules/collaboration-runtime/src-tauri/experts/skills/brainstorming
Command: npx skills add https://github.com/gyc-12/Archipelago --skill brainstorming-gyc-12

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Teams and AI agents often jump straight into coding without clarifying requirements, leading to wasted work on misunderstood features. This Skill enforces a structured design-first workflow that explores intent, constraints, and alternatives before any implementation begins. ## 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 approval. - Spec Generation and Review: Writes the approved design to a dated spec file under docs/superpowers/specs/, runs a self-review for placeholders and contradictions, and gates implementation behind explicit user approval. - Visual Companion Server: Ships a Node.js WebSocket server that serves browser-based mockups, wireframes, and A/B option screens, recording user click selections for the agent to read. - Use Case: Before building a new feature, activate this Skill to interview the user about purpose and success criteria, 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 agent before coding?

Invoke the brainstorming skill and describe your idea. The agent explores your project context, asks one clarifying question at a time, proposes 2-3 approaches with trade-offs, and presents a design for your approval before any implementation begins.

What is the visual companion in the brainstorming skill?

The visual companion is a local Node.js server that serves HTML mockups, wireframes, and option screens to your browser. You click to select options, and the agent reads your selections from a state file on its next turn.

Does the brainstorming skill work for small or simple projects?

Yes, every project goes through the design flow regardless of perceived simplicity. The design can be just a few sentences for trivial work, but it must still be presented and approved before implementation starts.

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 does the brainstorming server stop responding?

The server auto-exits after 30 minutes of inactivity or when its owner process dies. Restart it with scripts/start-server.sh and check the server-info file in the session state directory for the new URL and port.