brainstorming

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

Updated May 18, 2026
One-click install
npx skills add https://github.com/fts-pro/FTS-MMIS-AFRIKA --skill brainstorming-fts-pro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/fts-pro/FTS-MMIS-AFRIKA/tree/main/.agent/skills/brainstorming
Command: npx skills add https://github.com/fts-pro/FTS-MMIS-AFRIKA --skill brainstorming-fts-pro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires express, ws, chokidar, and 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 features. This Skill enforces a structured brainstorming workflow that explores user intent, requirements, and design trade-offs 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 Generation and Review: Writes the approved design to a dated spec document, runs a self-review for placeholders, contradictions, and scope issues, then gates implementation behind explicit user sign-off. - Visual Companion: Optionally serves browser-based mockups, wireframes, and side-by-side layout comparisons via a local WebSocket server, recording user clicks as structured events. - Use Case: Before building a new feature, use this Skill to refine the idea through dialogue, produce a committed design spec in docs/superpowers/specs/, and only then hand off to an implementation-planning skill. ## Quick Start Ask the agent to brainstorm the design for your new 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 producing a written spec.

What is the visual companion for brainstorming mockups?▼

The visual companion is a local browser server that displays HTML mockups, wireframes, and side-by-side layout comparisons during brainstorming. You start it with scripts/start-server.sh, and user clicks are recorded as JSON events for the agent to read.

Does the brainstorming skill work for small or simple projects?▼

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

Where are brainstorming design specs saved?▼

Approved 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.

Why does the brainstorming server stop responding?▼

The companion server auto-exits after 30 minutes of inactivity or when its owner process dies. Check the state directory for a server-stopped file and restart it with scripts/start-server.sh before pushing new screens.

When should I not use the browser visual companion?▼

Use the terminal instead when questions are conceptual or textual, such as requirements, scope decisions, trade-off lists, or API design choices. The browser is only for genuinely visual content like layouts, diagrams, and mockups.