What problem does it solve? Jumping straight into code without a validated design leads to wasted work, unexamined assumptions, and rework. This Skill enforces a structured discovery process that turns vague ideas into reviewed, user-approved design documents before any implementation begins. ## Core Features & Use Cases - Structured Discovery Dialogue: Explores project context, then asks clarifying questions one at a time to refine purpose, constraints, and success criteria. - Design Presentation & Approval Gate: Proposes 2-3 approaches with trade-offs, presents the design in sections, and blocks all implementation until the user approves. - Spec Review Loop: Writes the design to a dated Markdown file in docs/architecture/, dispatches a spec-document-reviewer subagent, and iterates until approved. - Visual Companion: Optional browser-based companion server (Node.js) that renders mockups, diagrams, and A/B layout options, capturing user clicks via WebSocket events. - Use Case: A user asks to add a new feature to an existing codebase. The Skill explores the repo, asks targeted questions, presents design options, writes a spec, gets it reviewed, and hands off to ticket creation for implementation. ## Quick Start Ask the agent to help you brainstorm and design a new feature before writing any code, and it will walk you through questions, design options, and a written spec.
