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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It prevents wasted implementation by forcing early alignment on intent, constraints, and a concrete design before any coding or scaffolding starts.

Core Features & Use Cases

  • Context-first understanding: Reviews the project’s current state (files/docs/recent changes) to ground the design in reality.
  • Clarify one step at a time: Asks a single clarifying question per message to progressively refine requirements.
  • Design with options and trade-offs: Proposes 2–3 approaches, recommends one, and presents the design in sections with approval gates.
  • Hard safety gate for implementation: Blocks any implementation, code generation, scaffolding, or other execution until the user approves the written design.
  • Writes and commits a design spec: Produces a design doc in the default docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md location and asks the user to review it.
  • Plan handoff: Only after approval, transitions by invoking the writing-plans skill to produce an implementation plan.

Quick Start

Use the brainstorming skill when you’re about to build or change anything, then answer its first clarifying question to start refining the design.

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 feature idea into an approved design spec before coding?

To turn a vague idea into an approved design spec, you need a pre-implementation brainstorming workflow that clarifies requirements, proposes design options, and gates execution until a written design document is approved by stakeholders.

What is the best way to prevent wasted implementation during early product development?

The best way to prevent wasted implementation is to enforce early alignment on intent and constraints using a brainstorming workflow that blocks code generation until a concrete design spec is reviewed and explicitly approved.

How do I refine product requirements without getting overwhelmed by implementation details?

You refine product requirements by using a workflow that asks a single clarifying question at a time to progressively discover constraints, then proposes 2-3 design approaches with trade-offs before any implementation begins.

Can I generate code and scaffolding while still deciding on the overall component design?

No, a strict safety gate blocks any code generation, scaffolding, or implementation actions while brainstorming. You must review and approve the committed design document before execution control is released.

Where should I store the design document after finishing the requirements discovery process?

After finishing requirements discovery, the design document is automatically written and committed to the default location at `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` for user review and future reference.

What happens after I approve the design spec for my feature development?

After you approve the design spec, the brainstorming workflow transitions control by invoking the `writing-plans` skill to produce a detailed implementation plan for the approved design.