Grill with Docs (Claude Code skill)
Muscular variant of Grill Me. /grill-with-docs runs a scoping session that doesn't just ask questions: it confronts your plan against the domain glossary (CONTEXT.md), your documented decisions (ADRs), and the existing code. When you use a fuzzy term or one that conflicts with the glossary, it halts immediately: 'your glossary says X but you're describing Y, which is it?' Updates CONTEXT.md inline and proposes an ADR only when 3 conditions are met (hard to reverse, surprising without context, real trade-off).
Strengths
- Confronts the spec against the existing domain glossary, reveals vocabulary conflicts before code
- Updates CONTEXT.md inline during the session, not in post-mortem
- Frames ADR usage: 3 strict conditions, otherwise skip, anti-bloat documentation
- Cross-references with the code: if you say 'we cancel the entire order' but the code allows partial cancellation, the skill surfaces it
Limitations
- Real friction: session takes 30-60 min for a non-trivial feature
- Useless without pre-existing CONTEXT.md or ADRs, the superpower comes from the documented history
- More opinionated than /grill-me, can frustrate teams that just want to start
Best for
- DDD teams that maintain a living CONTEXT.md and want Claude to respect it
- Senior devs with 10+ ADRs already who want to avoid re-debating settled decisions
- Architects who want to industrialise the glossary+ADR discipline without documenting by hand