What problem does it solve? Teams often jump from a vague idea straight into code, leaving scope, behavior, and trade-offs undecided. This Skill runs a disciplined shaping session that settles product decisions one at a time and produces a stable spec before any implementation begins. ## Core Features & Use Cases - One-decision-at-a-time interviews: Presents a single consequential question with a recommended answer and rationale, deciding cheap reversible choices as labeled assumptions. - Evidence-grounded decisions: Reads project knowledge (GLOSSARY.md, docs/decisions/, PRODUCT.md) and verifies third-party tool behavior from real sources before building on it. - Visual and diagram support: Renders prototypes or variant comparisons for experiential choices and diagrams for multi-branch flows, while keeping linear flows in prose. - Spec generation: Writes docs/specs/<slug>/spec.md with outcomes, acceptance criteria, constraints, assumptions, deferred points, and risks, linking approved prototypes and decision contracts. - Use Case: A PM wants to add workspace invitations. The Skill interviews through the state model, confirms edge cases like re-inviting expired links, and writes an implementation-ready spec without touching product code. ## Quick Start Ask the agent to use shape-idea to clarify your feature idea and produce an implementation-ready spec in docs/specs.
