brainstorming

Convert ambiguous ideas into approval-ready design specs through question-by-question collaboration.

2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/miptah21/skills --skill brainstorming-miptah21
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/miptah21/skills/tree/main/.agents/skills/brainstorming
Command: npx skills add https://github.com/miptah21/skills --skill brainstorming-miptah21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents wasted engineering effort by turning raw ideas into clear designs and written specs through structured, approval-gated collaboration.

Core Features & Use Cases

  • Context-first brainstorming: explores the current project state (files, docs, recent commits) before proposing anything.
  • Clarify-then-design flow with hard gating: asks clarifying questions one at a time and blocks implementation until a design is presented and approved.
  • Option-based design proposals: proposes 2–3 approaches with trade-offs and a recommendation, then incrementally presents the design for review.
  • Spec writing and review loop: writes a design doc to the repo, performs a self-review, and requires user review before planning implementation.
  • Optional visual companion: offers a browser-based mockup/diagram tool when visuals would improve understanding.

Quick Start

Use the brainstorming skill for your next feature idea by asking it to explore the project context, ask one clarifying question, and then present a design for approval before any implementation begins.

Frequently Asked Questions about brainstorming

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

FAQPage Schema
How do I turn a vague product idea into an approval-ready design spec?

To turn a vague product idea into an approval-ready design spec, you can use a context-first brainstorming workflow that asks clarifying questions, presents 2-3 design approaches with trade-offs, and writes a committed spec for user approval.

What is the best way to clarify requirements before starting component implementation?

The best way to clarify requirements before component implementation is through a question-by-question collaboration flow that hard-gates coding actions, ensuring scope and constraints are fully defined before transitioning to writing implementation plans.

How does approval gating work during architecture planning and feature design?

Approval gating during architecture planning works by blocking implementation actions until the user explicitly reviews and approves a proposed design, preventing wasted engineering effort on unscoped or ambiguous feature creation.

Can I generate visual mockups to accompany written spec documentation?

Yes, you can generate visual mockups using an optional browser-based companion tool that creates diagrams and visual aids to improve understanding alongside the written spec documentation.

Where are committed design specs stored in the project repository?

Committed design specs are stored as written documents under the docs/superpowers/specs/ directory in your repository, allowing for structured review loops and future reference.

Does this brainstorming flow support exploring existing project context before proposing a design?

Yes, the brainstorming flow explores existing project context by analyzing current files, docs, and recent commits before proposing any design options, ensuring recommendations are grounded in your actual codebase.