grill-with-docs

What problem does it solve? Design decisions made in conversation are often under-examined and then lost, leaving future engineers wondering why the code looks the way it does. This Skill runs a relentless interview to stress-test a plan or design and captures the outcomes as durable documentation. ## Core Features & Use Cases - Socratic Design Review: Delegates to a grilling interview that challenges assumptions and exposes weak spots in a plan before implementation. - Automatic ADR Creation: Records hard-to-reverse, surprising, trade-off-driven decisions as numbered ADRs in docs/adr/ using the Michael Nygard format. - Ubiquitous Language Glossary: Builds CONTEXT.md files with opinionated term definitions, aliases to avoid, relationships, and flagged ambiguities, plus CONTEXT-MAP.md for multi-context repos. - Use Case: While designing a billing module, the interview surfaces that "account" means both Customer and User; the Skill resolves the ambiguity into CONTEXT.md and writes an ADR explaining why Billing communicates via domain events instead of synchronous HTTP. ## Quick Start Ask the assistant to grill the current design plan and document the decisions and domain terms that emerge from the discussion.