brainstorming

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

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill brainstorming-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/superpowers/skills/brainstorming
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill brainstorming-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Jumping straight into code without a validated design leads to wasted work, unexamined assumptions, and misaligned implementations. This Skill enforces a structured brainstorming workflow that explores user intent, requirements, and design trade-offs before any code is written. ## 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 designs in sections for incremental approval. - Spec Documentation & Review Loop: Writes validated designs to dated spec files, dispatches a spec-document-reviewer subagent for completeness and consistency checks, and gates implementation behind user approval. - Visual Companion Server: Includes a local browser-based companion (Node.js server with WebSocket) for showing mockups, wireframes, and side-by-side layout comparisons during visual design questions. - Use Case: Before building a new feature, use this Skill to refine the idea through dialogue, produce a committed design spec, and only then transition to implementation planning via the writing-plans skill. ## Quick Start Ask the AI to brainstorm and design your new feature idea 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 a design for your approval before any code is written.

What is a design spec review loop in AI-assisted development?

After the design is written to a spec file, a spec-document-reviewer subagent checks it for completeness, consistency, clarity, scope, and YAGNI violations. Issues are fixed and the spec re-reviewed until approved, with a maximum of 3 iterations before escalating to a human.

Does the brainstorming skill work for small or simple projects?

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

How do I show UI mockups during AI brainstorming sessions?

The skill includes a visual companion: a local Node.js server started with scripts/start-server.sh that serves HTML mockups to your browser. You click options in the browser, and selections are recorded to an events file the AI reads on its next turn.

What happens after the design spec is approved?

After the spec passes review and you approve it, the skill invokes the writing-plans skill to create a detailed implementation plan. It explicitly does not invoke any other implementation skill such as frontend-design or mcp-builder.