What problem does it solve?
Prevents premature implementation by turning vague ideas or requests into validated designs and actionable specs before any code or configuration changes are made. It reduces wasted work from unexamined assumptions, clarifies scope, and ensures stakeholder alignment prior to development.
Core Features & Use Cases
- Explore project context: check files, docs, and recent commits to ground the conversation in the current codebase and constraints.
- One-question-at-a-time clarification: ask targeted clarifying questions to converge on purpose, constraints, and success criteria.
- Multiple approaches with recommendation: propose 2–3 approaches, compare trade-offs, and lead with a recommended option.
- Design presentation and gating: present the design in iterative sections, request user approval after each section, and refuse any implementation action until approval.
- Spec authoring and review: write the validated design to docs/specs/active/YYYY-MM-DD-<topic>-design.md, perform a self-review for placeholders and contradictions, and request user review before transitioning to implementation planning.
- Visual companion support: optionally offer a browser-based mockup/diagram companion for visual questions, served from a local session directory.
Quick Start
Please help me brainstorm and produce a validated design for a new feature by first exploring project context and then asking clarifying questions one at a time.