brainstorming

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

Updated Sep 3, 2024
One-click install
npx skills add https://github.com/eminboydak/duckTerm --skill brainstorming-eminboydak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/eminboydak/duckTerm/tree/main/.agents/skills/brainstorming
Command: npx skills add https://github.com/eminboydak/duckTerm --skill brainstorming-eminboydak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It prevents wasted implementation effort by forcing a structured design conversation—classifying scope, asking clarifying questions, and requiring explicit human approval—before any code is written. ## Core Features & Use Cases - Three-Path Classification: Routes every request into Spike (feasibility probe), Bounded (small change to existing code), or Architectural (new project/subsystem) with a scaled process for each. - Hard Approval Gate: Blocks all implementation until the human partner explicitly approves the presented design, regardless of task size. - Spec Writing & Review: Produces dated design documents under docs/superpowers/specs/, runs a self-review for placeholders and contradictions, then hands off to an implementation-planning skill. - Visual Companion Server: Ships a Node.js WebSocket server that serves HTML mockups and layout options to a browser so visual questions can be answered by seeing rather than reading. - Use Case: When asked to add a feature to an existing app, the skill explores the repo, asks targeted questions one at a time, presents a short in-chat design, and only proceeds after an explicit yes. ## 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 with an AI coding agent?

Invoke the brainstorming skill before any implementation request. It classifies your task as spike, bounded, or architectural, asks clarifying questions one at a time, and presents a design for your explicit approval before any code is written.

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

A spike answers a feasibility question with throwaway work. Bounded covers small changes to flows already existing in the repo. Architectural covers new projects or subsystems and requires a full written spec and implementation plan.

Can the agent skip the design step for simple tasks?

No. The skill enforces a hard approval gate on every path: even a two-sentence design must be presented and explicitly approved before implementation. Only the artifact size scales with simplicity, never the approval requirement.

How does the visual companion browser mockup work?

A bundled Node.js server serves HTML fragments you write to a session content directory, pushing them to the user's browser over WebSocket. User clicks are recorded as JSON events that the agent reads on the next turn.

Where are design spec documents saved?

Specs are written to docs/superpowers/specs/ with a dated filename like YYYY-MM-DD-topic-design.md, committed to git, self-reviewed for placeholders and contradictions, then reviewed by the user before planning begins.

When should the visual companion not be used?

Use the terminal for conceptual questions, tradeoff lists, and requirements discussions. The browser companion is only for genuinely visual content like mockups, wireframes, layout comparisons, and architecture diagrams.