brainstorming

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

Updated Sep 16, 2022
One-click install
npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill brainstorming-ryuya-matsunawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/ryuya-matsunawa/dotfiles/tree/main/agents/.agents/skills/brainstorming
Command: npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill brainstorming-ryuya-matsunawa

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 the design in sections for incremental approval. - Spec Authoring and Review: Writes the validated design to a dated spec file, runs a self-review for placeholders, contradictions, and scope issues, then gates implementation on explicit user approval. - Browser-Based Visual Companion: Serves mockups, wireframes, and architecture diagrams in a local browser tab via a Node.js WebSocket server, capturing user clicks as structured events. - Use Case: Before building a new feature, use this Skill to interview yourself about requirements, compare architectural approaches, and produce a committed design document that feeds directly into implementation planning. ## Quick Start Ask the agent to brainstorm the design for your next feature before writing any code, and answer its clarifying questions one at a time.

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 the visual companion for brainstorming mockups?▼

The visual companion is a browser-based tool that displays mockups, wireframes, and architecture diagrams during brainstorming. A local Node.js server serves HTML screens you write, and user clicks are recorded as JSON events for the agent to read.

Does the brainstorming skill work for small simple projects?▼

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

How do I start the brainstorming visual companion server?▼

Run scripts/start-server.sh with --project-dir pointing at your project root and --open to auto-open the browser. It returns a JSON object with the session URL, screen directory, and state directory.

What happens after the design spec is approved?▼

After the spec is written, self-reviewed, and approved by the user, the skill invokes the writing-plans skill to create a detailed implementation plan. It never invokes implementation skills directly.