Grill With Docs

Grill With Docs#

Relentless interview that sharpens a plan while maintaining the project glossary and ADRs as decisions crystallise.

Description#

The grill-with-docs skill is grill-me plus the domain-modeling discipline running in the same session. While interviewing, it challenges terminology against resources/agent-docs/GLOSSARY.md, sharpens fuzzy terms, stress-tests domain relationships with edge-case scenarios, cross-references claims against the code, updates the glossary inline, and offers ADRs under resources/agent-docs/adr/ for hard-to-reverse, surprising, trade-off decisions.

Triggers#

/wf:grill-with-docs

Also: “grill with docs”, “interview me and record decisions”.

Workflow#

  1. Run the grill-me interview rules (one question at a time, recommended answers, decisions to the user).

  2. Apply the domain-modeling discipline throughout.

  3. Update the glossary the moment a term is resolved.

  4. Offer ADRs sparingly, using the domain-modeling criteria.

  5. Stop on confirmed shared understanding; suggest to-spec.

Output#

Updated resources/agent-docs/GLOSSARY.md and, when warranted, new ADRs under resources/agent-docs/adr/.

Attribution#

Adapted from the grill-with-docs, grilling, and domain-modeling skills in mattpocock/skills (MIT license).

Contents