brainstorming

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

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/prateekgupta3991/skills --skill brainstorming-prateekgupta3991
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/prateekgupta3991/skills/tree/main/public/brainstorming
Command: npx skills add https://github.com/prateekgupta3991/skills --skill brainstorming-prateekgupta3991

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It prevents wasted implementation work by forcing intent exploration, requirement clarification, and explicit human approval before any code is written. ## Core Features & Use Cases - Three-Path Classification: Routes every request into spike, bounded, or architectural tracks with appropriately scaled process and approval gates. - Structured Design Dialogue: Asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, and presents sectioned designs for approval. - Spec Writing and Review: Writes validated designs to dated spec files, runs a self-review for placeholders and contradictions, and hands off to implementation planning. - Visual Companion Server: Serves browser-based mockups, diagrams, and clickable option screens via a local Node.js server with WebSocket event capture. - Use Case: Before building a new feature, classify the request, refine requirements through dialogue, present a design, and only implement after explicit approval. ## Quick Start Ask the agent to brainstorm and design the feature you have in mind 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?

Classify the request as spike, bounded, or architectural, then explore project context and ask clarifying questions one at a time. Present a short design or full spec and wait for explicit approval before implementing anything.

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

A spike answers a feasibility question with throwaway work. Bounded covers well-scoped changes to existing code with an in-chat design. Architectural covers new projects or subsystem changes requiring a written spec and implementation plan.

How do I show UI mockups in a browser during brainstorming?

Start the companion server with scripts/start-server.sh --project-dir <path> --open after the user approves it. Write HTML fragments to the screen directory and the server serves the newest file to the browser automatically.

Does the visual companion server work on Windows or remote environments?

Yes, the start script auto-detects Windows shells and Codex environments and switches to foreground mode. For remote setups, bind with --host 0.0.0.0 and use --url-host to control the displayed hostname.

Why does the brainstorming server reject my browser URL?

The server requires the full URL including the ?key= session token, which authenticates both HTTP and WebSocket access. Copy the complete URL from the server-started JSON output rather than a bare host and port.

When should I not use the visual companion?

Skip it for conceptual questions, tradeoff lists, and requirement discussions where the answer is words rather than a visual preference. Only use the browser when content is genuinely visual, such as layouts, mockups, or diagrams.