grill-with-docs

Run a grilling session that systematically questions your plan's assumptions, edge cases, and trade-offs. This Skill conducts that interview and records each resolved decision as an ADR, so the reasoning is preserved alongside the design.

This Skill writes Architecture Decision Records incrementally as the interview progresses, capturing each decision and its rationale at the moment it is made. It also builds a glossary of domain terms alongside the ADRs.

A grilling session is a relentless question-and-answer interview where a design is challenged to expose hidden assumptions and vague requirements. The goal is to sharpen the plan before any code is written.

The Skill explicitly instructs the session to use the /domain-modeling skill, so that companion skill should be available for the intended workflow. Without it, the domain vocabulary grounding step may not function as designed.

Interview-based review is less suitable for mature, well-documented designs where decisions are already recorded, or for urgent fixes with no time for deliberation. In those cases, direct code review or lightweight checklists are more appropriate.