skills.rest
mcinnisd
mcinnisdCOMMUNITY
Explore all skills by this author →
GitHub

brainstorming

Guides collaborative dialogue to turn ideas into approved design specs.

Updated Jan 2, 2025
Search Tags:#planning#brainstorming#collaboration#requirements#websocket#mockups#design spec
One-click install
npx skills add https://github.com/mcinnisd/gymbro --skill brainstorming-mcinnisd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/mcinnisd/gymbro/tree/main/.agents/skills/brainstorming
Command: npx skills add https://github.com/mcinnisd/gymbro --skill brainstorming-mcinnisd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Teams and developers often jump straight into coding without a validated design, leading to wasted work on unexamined assumptions. This Skill enforces a structured brainstorming workflow that turns rough ideas into reviewed, approved design specifications 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 user approval. - Spec Documentation & Review Gates: Writes the approved design to a dated spec file, runs a self-review for placeholders, contradictions, and ambiguity, then requires explicit user review before transitioning to implementation planning. - Browser-Based Visual Companion: Optionally serves live HTML mockups, wireframes, and side-by-side layout comparisons in the user's browser via a local WebSocket server, capturing click selections as structured events. - Use Case: A developer wants to add a new feature. Invoke this Skill to explore the codebase, clarify requirements, compare architectural approaches, and produce a committed design doc that feeds directly into an implementation plan. ## Quick Start Ask the agent to brainstorm your feature idea into a design spec 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 idea into a design spec with an AI agent?▼

Invoke the brainstorming skill and describe your idea. The agent explores your project context, asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, and presents the design section by section until you approve it.

What happens after the design is approved in a brainstorming session?▼

The approved design is written to a dated spec file under docs/superpowers/specs/ and committed to git. After a self-review and your explicit approval of the written spec, the skill transitions to the writing-plans skill to create an implementation plan.

Can I see visual mockups during a brainstorming session?▼

Yes. When a question is genuinely visual, the agent offers a browser-based companion that serves HTML mockups, wireframes, and side-by-side comparisons through a local server. Your clicks are recorded as events the agent reads on the next turn.

Does the brainstorming skill write code or scaffold projects?▼

No. A hard gate prohibits any implementation, code writing, or scaffolding until a design has been presented and explicitly approved. The only skill invoked afterward is writing-plans for implementation planning.

How does the visual companion server handle security and sessions?▼

The local server requires a per-session key passed as a URL query parameter and mirrored into an HttpOnly cookie. It binds to 127.0.0.1 by default, rejects unauthorized requests, and shuts down automatically after a configurable idle timeout.

Related Skills

Explore More Software Engineering Skills→
deerawandeerawan
1

gsd-pause-work

Write a timestamped .continue-here.md handoff and commit WIP when pausing mid-phase.

Community
Intermediate
elsa-workflowselsa-workflows
7.9k

speckit-tasks

Convert project design and specification documents into dependency-ordered task lists.

Official
Intermediate
rahulscrahulsc

subagent-driven-development

Dispatch independent subagents to execute implementation plan tasks with tiered reviews.

Community
Advanced
anionDevelopmentanionDevelopment

openspec-explore

Explores ideas, investigates codebases, and captures decisions as OpenSpec change artifacts.

Official
Advanced