grill-with-docs

Run a grilling session that systematically questions the design's assumptions, edge cases, and trade-offs. Each resolved point is captured as an Architecture Decision Record, so the review produces documentation instead of just verbal feedback.

This Skill writes Architecture Decision Records incrementally as the interview progresses, recording each decision and its rationale at the moment it is made. It also maintains a glossary of domain terms that emerge during discussion.

A grilling session is a relentless interview where the design author must defend every choice under questioning. It surfaces hidden assumptions early and converts the answers into ADRs and glossary entries.

No, the instructions explicitly delegate to the domain-modeling skill for structuring concepts. Without that companion skill available, the domain modeling portion of the workflow cannot be executed as designed.

Avoid it for trivial changes with no architectural impact or when decisions are already finalized and documented. The interview format adds the most value for ambiguous, high-stakes designs with unresolved trade-offs.