What problem does it solve? Design plans often contain fuzzy terminology, hidden contradictions with existing code, and undocumented decisions that cause confusion later. This Skill interviews you relentlessly about every aspect of a plan, challenges inconsistencies against your codebase and domain glossary, and captures resolved terminology and architectural decisions as documentation the moment they crystallize. ## Core Features & Use Cases - Socratic Design Interrogation: Walks down each branch of the design tree one question at a time, providing recommended answers and resolving dependencies between decisions. - Inline Glossary Maintenance: Updates CONTEXT.md immediately when terms are resolved, flags ambiguous language, and challenges usage that conflicts with existing definitions. - Selective ADR Creation: Offers Architecture Decision Records only when a decision is hard to reverse, surprising without context, and the result of a real trade-off. - Use Case: Before writing a PRD for a new billing feature, run this Skill to stress-test your domain model — it will catch that you use "account" to mean both Customer and User, record the distinction in CONTEXT.md, and document why you chose event-sourced orders in an ADR. ## Quick Start Ask the agent to grill you on your design plan for the new feature using the grill-with-docs skill, answering each question one at a time until shared understanding is reached.
