openspec-brainstorm

What problem does it solve?

Many feature ideas or small changes are implemented before their assumptions, constraints, and success criteria are clarified, leading to rework and misaligned implementations. This Skill guides collaborative exploration of intent, constraints, and trade-offs so a clear, approved design is produced before any OpenSpec or implementation steps are taken.

Core Features & Use Cases

• Context-first exploration: Instructs the agent to examine project files, docs, recent commits, and existing OpenSpec change context for informed questioning.
• One-question-at-a-time clarification: Drives focused, incremental clarification to converge on purpose, constraints, and success criteria.
• Approach comparison and recommendation: Proposes 2–3 approaches with trade-offs, recommends a preferred option, and scales design sections to complexity.
• Visual Companion support: Offers an optional browser-based mockup/diagram tool when visual questions are needed (explicit consent required).
• Handoff brief: Produces a concise, reviewed handoff summary recommending the next OpenSpec command or skill without editing OpenSpec artifacts.

Quick Start

Ask it to brainstorm an OpenSpec change for <brief idea>, explore project context, ask clarifying questions one at a time, propose approaches with trade-offs, and produce a short handoff brief recommending the next OpenSpec step.