# Grill with docs

> The same interview, with the answers written down as it goes: terms into a glossary, decisions into decision records.

Canonical: https://mikereams.com/ai/grill-with-docs

Skill · Curated · Planning · updated 2026-10-29. Part of the [AI Library](https://mikereams.com/ai).

What you get: A settled plan, plus a glossary and decision records written while the answers are fresh.

When to use it: When a plan introduces terms or decisions that the next person will need to find.

Ask for it like this: "Grill me on this design and write the glossary and the decision records as we go."

Limits: It creates a file only when there is something to write: no empty glossary, no placeholder records.

- Two skills, one card: grill-with-docs runs the interview and domain-modeling, which keeps the glossary and the records. Text only; I added where terms and records go in my own notes.
- The closest of the set to architecture work: the interview ends with records, not only with agreement.

Source: [mattpocock/skills](https://github.com/mattpocock/skills/tree/59db609/skills/engineering/grill-with-docs) by Matt Pocock (MIT), reviewed at 59db609. Not hosted here. Also covers [domain-modeling](https://github.com/mattpocock/skills/tree/59db609/skills/engineering/domain-modeling), at the same commit.

Reviewed 2026-10-29.

Tags: planning, ADR, glossary, domain model