brainstorming

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

Updated May 8, 2026
One-click install
npx skills add https://github.com/tomw200082-collab/gt-factory-os-production-brain --skill brainstorming-tomw200082-collab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/tomw200082-collab/gt-factory-os-production-brain/tree/main/.claude/skills/brainstorming
Command: npx skills add https://github.com/tomw200082-collab/gt-factory-os-production-brain --skill brainstorming-tomw200082-collab

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, unexamined assumptions, and misaligned features. This Skill enforces a structured brainstorming workflow that explores user intent, requirements, and design trade-offs 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 in docs/superpowers/specs/, runs a self-review for placeholders and contradictions, and gates implementation behind explicit user approval. - Visual Companion Server: Includes a Node.js WebSocket server that serves browser-based mockups, wireframes, and side-by-side layout comparisons, recording user click selections as JSON events. - Use Case: Before building a new feature, use this Skill to refine the idea through dialogue, compare architecture options, produce a committed design document, and only then hand off to an implementation-planning skill. ## Quick Start Ask the agent to brainstorm the design for your new feature before writing any code.

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 the design in sections for your approval before writing a spec document.

What is the visual companion in the brainstorming skill?▼

The visual companion is a browser-based tool served by a local Node.js server that displays mockups, wireframes, and side-by-side layout comparisons during brainstorming. It is offered only when a question is genuinely visual, and your clicks are recorded as JSON events for the agent to read.

Does the brainstorming skill work for small or simple projects?▼

Yes, every project goes through the design process regardless of perceived simplicity. For truly simple projects the design can be just a few sentences, but it must still be presented and approved before implementation begins.

How does the brainstorming skill handle very large projects?▼

When a request spans multiple independent subsystems, the skill flags the scope immediately and helps decompose it into sub-projects. Each sub-project then gets its own spec, plan, and implementation cycle rather than one oversized design.

What happens after the design spec is approved?▼

After you approve the written spec, the skill invokes the writing-plans skill to create a detailed implementation plan. It does not invoke any implementation skill directly, keeping design and coding as separate gated phases.