Grill With Docs for Claude Code: Design Interview With a Project Glossary
Grill With Docs challenges assumptions while capturing settled domain terms in a glossary and durable architectural decisions in a short decision record.
中文Setup for Claude Code
Claude Code in a disposable project with write access. Install both companion skills from the same repository revision.
- Copy skills/engineering/grill-with-docs into .claude/skills/grill-with-docs/.
- Copy skills/productivity/grilling and skills/engineering/domain-modeling into their respective .claude/skills/ folders. Keep the domain-modeling format templates with its SKILL.md.
- Open Claude Code at the project root, invoke /grill-with-docs, and review file changes as decisions are approved.
Example task
In an empty scratch project, ask /grill-with-docs to settle the difference between a seven-minute cart hold and a paid reservation. In the first round, specify when the reservation exists, then agree to record both definitions in GLOSSARY.md.Expected result
GLOSSARY.md distinguishes the two terms and contains the agreed trigger. An ADR appears only when the discussion reaches a decision that warrants a durable record.
Upstream documentation
Original SKILL.md on GitHub · MIT license · Source reviewed
Frequently asked question
What is the difference between Grill Me and Grill With Docs?
Both use the grilling interview. Grill With Docs also invokes domain-modeling to keep agreed vocabulary and qualifying decisions in the project.