grill-with-docs

Run a grilling session that interviews you about your plan, probing assumptions and edge cases through persistent questioning. The session challenges each design decision and records the resolved outcomes as Architecture Decision Records.

This Skill creates Architecture Decision Records automatically as the interview progresses. Each challenged decision that reaches a conclusion is captured as an ADR, so documentation is a byproduct of the conversation rather than a separate task.

A glossary defines the domain terms used across a project so the team shares one vocabulary. During the grilling session, ambiguous or important terms surfaced by the domain-modeling skill are defined and collected into this glossary.

No, it orchestrates other skills. It runs a grilling session and delegates the domain reasoning to the domain-modeling skill, so both of those skills must be available for it to function.

Avoid it for trivial changes with no architectural impact, since the interview overhead outweighs the benefit. It is best suited to plans with meaningful design decisions, new domains, or unclear requirements.