One question at a time
Never a wall of questions. Each one lands alone, waits for your answer, and shapes what gets asked next.
Free · Claude Code plugin · Nothing reaches our servers
Get grilled before you build.
Grill with Docs turns Claude Code into a relentless design interviewer: one sharp question at a time, each with a recommended answer — while every settled decision is written into your repo as ADRs and a living glossary.
Coming soon to the plugin marketplaceSee how it works
One command · plain-markdown output · works in any repo
Features
An interview that leaves a paper trail
A recommendation with every question
Each question arrives with the interview’s own recommended answer, so you react to a concrete position instead of a blank page.
Walks the whole design tree
Branches are explored in dependency order, decision by decision, until nothing in the plan is settled by accident.
Reads code before asking
Questions the codebase can answer are answered by exploring the codebase — your attention is saved for real decisions.
ADRs the moment decisions land
Every settled decision becomes an architecture decision record in docs/adr/ right away. No “we’ll document it later.”
A glossary that pushes back
Vague or overloaded terms get challenged and sharpened into canonical language, recorded in CONTEXT.md.
Edge cases as concrete scenarios
Invented scenarios probe the boundaries between concepts until your definitions stop wobbling.
Calls out contradictions
When your plan disagrees with your code — or with your own glossary — the interview says so, with the receipt.
The output is deliberately boring: markdown ADRs and glossary entries, committed to your repo like code. Six months later, the repo still remembers why.
How it works
Bring a plan. Leave with decisions.
Bring a plan
A design doc, a rough outline, or an idea still in your head. Run the command inside your repo and say what you want to build.
Survive the interview
Questions come one at a time, each with a recommended answer to accept or push back on. The interview walks every branch until the design stops wobbling.
Keep the docs
ADRs land in
docs/adr/, terminology lands inCONTEXT.md. Review the diff, commit, and the reasoning ships with the code.
Privacy
Nothing to collect.
No one listening.
The plugin is a set of instructions for your own Claude Code. We never see your code, your plans, or your answers — nothing is sent to us, because there is nothing of ours to send it to. Even this website runs no trackers.
Read the privacy policy →0our servers
0analytics
0accounts
Responsibility
Your platforms’ terms are the rulebook
Grill with Docs runs on top of Claude Code and the AI service you already use. Use it only in ways those platforms’ own terms allow, and treat every recommendation as a starting point to review — the decisions, and what you build with them, are yours.
Read the terms of service →FAQ
Questions, answered
What exactly is Grill with Docs?
A plugin for Claude Code, the AI coding tool from Anthropic. It adds a command that turns your session into a structured design interview: one question at a time, each with a recommended answer, walking every branch of your plan until the decisions hold up. Settled decisions are written into your repo as architecture decision records (ADRs) and glossary entries as you go.
Do you collect any of my data?
No. The plugin is a set of instruction files that run entirely inside your own Claude Code session. It has no server side, no accounts, no analytics, and no telemetry — we never see your code, your plans, or your answers, and nothing is ever transmitted to us. Your conversation is processed by your AI provider under your own agreement with them, exactly like any other Claude Code session.
Is it free?
Yes. The plugin is free to install and use. You bring your own Claude Code setup — whatever you pay your AI provider is between you and them.
What do I need to run it?
A working Claude Code installation and a repo to point it at. The plugin adds no other dependencies, no build step, and no configuration.
What files does it write?
Plain markdown, inside your repo: architecture decision records under docs/adr/, and glossary terms in CONTEXT.md. Everything shows up in git diff and gets reviewed and committed like any other change.
Are the recommended answers reliable?
They are AI-generated starting points, not professional advice. The whole point of the interview is that you push back: review every recommendation and every ADR before you act on it. You stay the decision-maker, and you are responsible for what you build — see the terms of service.
Is this an Anthropic product?
No. Grill with Docs is an independent tool by Day21, not affiliated with, sponsored by, or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic, PBC, used here only to describe compatibility. Your use of Claude Code itself remains governed by Anthropic’s own terms.
Your next plan deserves a grilling.
Coming soon to the plugin marketplace. Questions in the meantime? Get in touch.