grill-with-docs

Run a grilling session that subjects the design to persistent structured questioning about assumptions, scope, and trade-offs. Each challenged decision is captured as an Architecture Decision Record so the reasoning is preserved.

An Architecture Decision Record (ADR) documents a significant design decision along with its context and rationale. This Skill creates ADRs automatically as decisions are made and defended during the interview session.

Yes, the grilling approach works for any plan or design that benefits from rigorous questioning. The outputs are ADRs and a glossary, which are most natural in software and technical planning contexts.

Yes, the session explicitly delegates to the domain-modeling skill to establish shared vocabulary and domain concepts. Without it, the glossary and domain grounding portions of the workflow would not function as intended.

Avoid it for trivial changes with no meaningful trade-offs, where the interview overhead exceeds the value. It is best suited to designs with real architectural decisions worth documenting as ADRs.