brainstorming

Guides collaborative design exploration and spec writing before any implementation begins.

1|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/stefaniuk/loadout --skill brainstorming-stefaniuk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/stefaniuk/loadout/tree/main/.github/skills/brainstorming
Command: npx skills add https://github.com/stefaniuk/loadout --skill brainstorming-stefaniuk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Teams often jump straight into coding features without clarifying intent, requirements, or design, which leads to rework and misaligned implementations. This Skill enforces a structured dialogue that classifies each request, explores the problem space, and requires explicit human approval before any code is written. ## Core Features & Use Cases - Three-Path Classification: Routes every request into spike, bounded, or architectural tracks so the process depth matches the task's actual complexity. - Approval Gates: Blocks implementation until the human partner explicitly approves the presented design, with a hard gate that applies to every task size. - Spec Authoring and Review: Writes validated design documents to dated spec files, runs a self-review for placeholders and contradictions, and hands off to implementation planning. - Visual Companion Server: Ships a local browser companion (Node.js server, WebSocket updates, session-key authentication) for showing mockups, diagrams, and layout options during design discussions. - Use Case: When asked to add a new subsystem, the Skill explores project context, asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, writes a committed design spec, and only then invokes the writing-plans skill. ## Quick Start Ask the agent to brainstorm the design for a new feature before writing any code, and it will classify the request and walk you through questions and a design proposal.

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 creative work. It classifies your request as spike, bounded, or architectural, asks clarifying questions one at a time, proposes approaches with trade-offs, and requires your explicit approval before implementation starts.

What is the difference between spike, bounded, and architectural tasks?▼

A spike answers a feasibility question and produces a recommendation, not kept code. Bounded covers well-scoped changes to existing flows with a short in-chat design. Architectural covers new projects or subsystem restructuring and requires a full written spec.

Can I skip the design approval step for simple changes?▼

No. The skill enforces a hard approval gate on every path. Simple tasks get a short two-sentence design in chat, but you must still present it and wait for an explicit yes before implementing.

How do I start the visual brainstorming companion server?▼

Run scripts/start-server.sh with --project-dir pointing at your project root and --open to auto-open the browser. It returns a JSON object with the session URL, screen directory, and state directory for pushing HTML mockups.

Does the brainstorming skill work with the speckit workflow mode?▼

No. The skill only runs when the active workflow mode is superpowers. If the mode is speckit, it stops and tells you to switch with make workflow-use mode=superpowers or continue with the Spec Kit lifecycle instead.

Where are design spec documents saved?▼

Approved architectural 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.