What problem does it solve? Designs and plans often contain hidden assumptions that only surface during implementation. This Skill runs a structured interview that challenges a plan against the project's existing documentation, capturing durable decisions as ADRs and glossary terms before specification begins. ## Core Features & Use Cases - Document-grounded interrogation: Grills the phase scope against on-disk artifacts such as requirements, phase plans, binding ADRs, architecture boundaries, and CLI exit codes rather than intuition. - Decision capture as you go: Anything settled during the interview that outlives the phase is written into a new ADR in docs/decisions/ or a term in CONTEXT.md. - Spec Loop integration: Acts as the first step of the internal Spec Loop (grill-with-docs → to-spec → to-tickets → implement), feeding settled outcomes into the next specification step. - Use Case: Before writing a spec for a new API phase, run the interview to pressure-test the phase plan against existing ADRs and module boundaries, recording any new architectural decisions along the way. ## Quick Start Ask your agent to run the grill-with-docs skill to interview the current phase plan against the project docs and record any lasting decisions as ADRs.
