grill-with-docs

Run a grilling session that interviews you about your plan, challenging assumptions and forcing explicit trade-off decisions. The session produces ADRs and a glossary documenting every decision made along the way.

This Skill creates Architecture Decision Records incrementally as the interview progresses, capturing each decision and its rationale. You end the session with documentation already written rather than writing it afterward.

A grilling session is a relentless question-and-answer interview that probes a plan or design for weak points, undefined terms, and unexamined alternatives. It combines critique with documentation by producing ADRs and a glossary.

Yes, the grilling session explicitly uses the domain-modeling skill to ground the discussion in a shared vocabulary. The glossary it produces reflects the domain terms clarified during the interview.

Avoid it for trivial changes with no architectural impact or when requirements are already fully specified and documented. The interview format adds the most value when a design contains ambiguity or contested decisions.