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.