grill

Installation
SKILL.md

Grill the Plan

A plan sounds finished long before it is finished. This skill is the interview that finds the gap between "sounds right" and "is right" — by interrogating the plan against the two things it can't argue with: the actual code, and the project's own established language. Run it before tickets exist, when changing your mind costs a sentence instead of a worktree.

How to grill

One question at a time. Ask, wait for the answer, let it reshape the next question. A wall of twenty questions gets a wall of twenty shallow answers; a sequence gets you to the real constraint.

Check the code before you ask. If the answer is already in the repo, go read it — don't make the user recite what the code already states. Reserve questions for what only a human knows: intent, priorities, trade-offs, the future.

Ask the question with its recommendation. Don't just surface a problem — propose the resolution you'd pick, so the user can agree, correct, or veto in one turn.

What to hunt for

  • Terminology conflicts. When the plan's words contradict the project's glossary (CONTEXT.md or equivalent), surface it on the spot: "Your glossary defines 'cancellation' as a refund event, but here you're using it for an abandoned cart — which is it?" Mismatched vocabulary is a mismatched model, and it ships as bugs.
  • Vague, overloaded terms. Sharpen them with a proposal: "You said 'account' — do you mean the billing Customer or the auth User? I'll assume Customer unless you say otherwise."
  • Fuzzy boundaries. Stress-test the edges with concrete, invented scenarios that force precision about where one concept ends and the next begins: "A user deletes their org while a job is mid-run — does the job still see the org or not?"
  • Code-reality contradictions. When the plan assumes behaviour the code doesn't have, flag it with the evidence: "The plan says auth middleware already injects the tenant, but auth.ts:40 only sets the user — the tenant is never read. Who adds it?"
Installs
28
First Seen
Jun 2, 2026
grill — oisincoveney/skills