brainstorming

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

2|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/MoofonLi/dev-ready --skill brainstorming-moofonli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/MoofonLi/dev-ready/tree/main/src/dev_ready/templates/claude/skills/brainstorming
Command: npx skills add https://github.com/MoofonLi/dev-ready --skill brainstorming-moofonli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It prevents wasted implementation effort by forcing requirements, design, and user approval to happen before any code is written, catching wrong assumptions early. ## Core Features & Use Cases - Three-Path Classification: Routes each request as a spike, bounded change, or architectural task, scaling the design process to the work. - Hard Approval Gate: Blocks all implementation until the human partner explicitly approves the presented design or spec. - Spec Authoring and Review: Writes validated design documents to dated spec files, self-reviews for placeholders and contradictions, then hands off to a writing-plans skill. - Visual Companion: Optionally serves browser-based mockups and diagrams via a local WebSocket server for layout and visual questions. - Use Case: When asked to add a new subsystem, the agent classifies the work as architectural, asks clarifying questions one at a time, proposes 2-3 approaches, writes a spec, and only proceeds to planning after user sign-off. ## Quick Start Ask the agent to brainstorm the design for a new feature before writing any code, and answer its clarifying questions until it presents a design for your approval.

Frequently Asked Questions about brainstorming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI agent design before writing code?

Invoke the brainstorming skill before any creative work. It classifies the request as spike, bounded, or architectural, asks clarifying questions, presents a design, and blocks all implementation until you explicitly approve it.

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

A spike answers a feasibility question with throwaway work. Bounded is a well-scoped change to existing code needing only a short in-chat design. Architectural covers new projects or subsystem restructuring and requires a full written spec.

Where are brainstorming design specs 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.

How does the visual companion browser mockup work?

A local Node.js server started with scripts/start-server.sh serves HTML screens you write to a content directory. The user views mockups in a browser, clicks options, and selections are recorded as JSON events the agent reads next turn.

When should brainstorming not be used?

It is not needed for pure implementation execution after a spec already exists. Once a design is approved, architectural work transitions to the writing-plans skill and bounded work proceeds through the normal development workflow.