Grill-Me technique: iterative structured interviewing for human and Artificial…
Grill-Me technique: iterative structured interviewing for human and Artificial Intelligence (AI) alignment in code generation
- Matt Pocock's Grill Me technique is a concrete clarification-first workflow in which the agent asks one question at a time, walks the design tree branch by branch, recommends answers, and stops only when shared understanding has been reachedPocock (2025)Pocock (2025)
- Direct code-generation research shows that adding a targeted clarifying-question phase before code generation materially improves first-pass correctness on underspecified tasks, including a GPT-4 benchmark correctness increase from 70.96% to 80.80% in ClarifyGPTMu et al. (2023)
- A second clarification-before-code study, ClariGen, reports that high-quality clarifications improve code correctness and reliability while reducing later revision needs, which supports the same mechanism through a separate research program but currently with thinner evidence than ClarifyGPTMiao et al. (2025)
- Baseline Copilot usability evidence shows why Grill Me matters: users often prefer generated code as a starting point, but still lose effectiveness when they must understand, edit, and debug output produced from incomplete or mismatched requirementsVaithilingam et al. (2022)Nadi (2022)
- The strongest software-engineering analogue for Grill Me is requirements discovery rather than prompt optimization, because Three Amigos workshops use concrete examples, edge cases, technical constraints, and testability questions to surface hidden assumptions before implementation beginsSmart (2017)Pocock (2025)Mitchell (2026)
- Pocock's public examples report Grill Me sessions ranging from 16 questions on a smaller feature to roughly 30 to 50 questions on more complex changes, and he says these conversations often last about 45 minutes, which suggests the practice is a real discovery phase rather than a one-line prompt enhancementPocock (2025)Pocock (2025)
- Compared with jumping directly to code, Grill Me is best supported as a way to improve first-output correctness and reduce correction rounds under ambiguity, but direct evidence that it always shortens total time-to-working-feature is still missingMu et al. (2023)Miao et al. (2025)Peng et al. (2023)Mitchell (2026)
- The available evidence suggests Grill Me is likely transferable across models and stacks because clarification gains appear in multi-model studies and the same explore-then-plan guidance appears in both Anthropic and GitHub workflow recommendations, but industrial cross-language head-to-head data remains thinMu et al. (2023)Anthropic (2025)GitHub (2025)
Research Question
How effectively does the "Grill Me" technique, relentless iterative structured interviewing of the human developer by the AI assistant to build a shared design concept before generating any code, reduce misalignment between human intent and AI-generated output, and what are the measurable outcome differences compared to jumping directly into plan or code generation?
Findings
Executive Summary
Grill Me is an effective alignment technique when the task is ambiguous because it turns more of the user's hidden intent into explicit pre-code constraints before generation begins. The strongest direct evidence comes from clarification-before-code research, which shows measurable gains in first-pass correctness and reliability when models ask targeted questions before writing code. Baseline Copilot studies explain why that helps in practice: direct generation is often fast and locally useful, but developers still lose time when they must understand, edit, and debug code generated from incomplete requirements. The remaining uncertainty is which ingredient matters most, because current studies do not cleanly separate ambiguity reduction from extra interaction time, richer examples, or longer context accumulation, and they do not yet show the full-project wall-clock effect in production.
Key Findings
- Matt Pocock's Grill Me technique is a concrete clarification-first workflow in which the agent asks one question at a time, walks the design tree branch by branch, recommends answers, and stops only when shared understanding has been reached.
- Direct code-generation research shows that adding a targeted clarifying-question phase before code generation materially improves first-pass correctness on underspecified tasks, including a GPT-4 benchmark correctness increase from 70.96% to 80.80% in ClarifyGPT.
- A second clarification-before-code study, ClariGen, reports that high-quality clarifications improve code correctness and reliability while reducing later revision needs, which supports the same mechanism through a separate research program but currently with thinner evidence than ClarifyGPT.
- Baseline Copilot usability evidence shows why Grill Me matters: users often prefer generated code as a starting point, but still lose effectiveness when they must understand, edit, and debug output produced from incomplete or mismatched requirements.
- The strongest software-engineering analogue for Grill Me is requirements discovery rather than prompt optimization, because Three Amigos workshops use concrete examples, edge cases, technical constraints, and testability questions to surface hidden assumptions before implementation begins.
- Pocock's public examples report Grill Me sessions ranging from 16 questions on a smaller feature to roughly 30 to 50 questions on more complex changes, and he says these conversations often last about 45 minutes, which suggests the practice is a real discovery phase rather than a one-line prompt enhancement.
- Compared with jumping directly to code, Grill Me is best supported as a way to improve first-output correctness and reduce correction rounds under ambiguity, but direct evidence that it always shortens total time-to-working-feature is still missing.
- The available evidence suggests Grill Me is likely transferable across models and stacks because clarification gains appear in multi-model studies and the same explore-then-plan guidance appears in both Anthropic and GitHub workflow recommendations, but industrial cross-language head-to-head data remains thin.
Assumptions
- [assumption] The current Pocock first-party sources are an acceptable substitute for the dead Total TypeScript seed URL because they describe the same technique in current public form.
- [assumption] The absence of an accessible long-run randomized field study means project-length benefits must be inferred from benchmark studies, usability studies, and requirements-discovery analogues rather than asserted directly.
Analysis
The evidence supports Grill Me most strongly as an ambiguity-management workflow rather than as a universal speed hack. Direct clarification studies carry the core causal weight because they measure code-generation outcomes before and after an explicit questioning phase. Ambiguity reduction is the best-supported explanation for the gains, but it is not the only plausible explanation, because clarification sessions also add more interaction time, more user-provided examples, and more context tokens before generation starts. The practical trade-off is therefore front-loaded questioning cost versus downstream debugging cost, which means Grill Me should have its highest Return on Investment on ambiguous, multi-step, or high-consequence changes rather than on tiny, already-explicit tasks.
Risks, Gaps, and Uncertainties
- The direct clarification studies are controlled or benchmark-oriented, not longitudinal production studies.
- ClariGen evidence is currently accessible as an abstract and project summary rather than a fully reviewed camera-ready paper in this session.
- Pocock's question-count examples are informative but may reflect his teaching style and chosen examples rather than a stable industry median.
- No accessible study isolates total wall-clock feature delivery for grill-first versus prompt-to-code across a full project lifecycle.
Open Questions
- What is the smallest set of question categories that captures most of Grill Me's alignment benefit without making the session feel slow?
- Can automated instrumentation measure whether grill-first sessions reduce later code review comments, bug-fix churn, or failed test iterations in real repositories?
- Does the benefit curve flatten after a certain number of questions, or does value depend mainly on surfacing a small number of high-impact hidden constraints?
- Which parts of Grill Me can be automated from repository context without losing the human alignment benefit?
sources
- [x] Pocock (2025) grill-me skill
- [x] Pocock (2025) My Grill Me Skill Has Gone Viral
- [x] Pocock (2025) 5 Agent Skills I Use Every Day
- [x] Mu et al. (2023) ClarifyGPT: Empowering LLM-based Code Generation with Intention Clarification
- [x] Miao et al. (2025) ClariGen: Bridging Instruction Gaps via Interactive Clarification in Code Generation
- [x] Addlesee et al. (2024) Clarifying Completions: Evaluating How LLMs Respond to Incomplete Questions
- [x] Vaithilingam et al. (2022) Expectation vs. Experience: Evaluating the Usability of Code Generation Tools Powered by Large Language Models
- [x] Nguyen and Nadi (2022) An Empirical Evaluation of GitHub Copilot's Code Suggestions
- [x] Peng et al. (2023) The Impact of AI on Developer Productivity: Evidence from GitHub Copilot
- [x] GitHub (2024) Does GitHub Copilot improve code quality? Here's what the data says
- [x] Liang et al. (2023) Practices and Challenges of Using GitHub Copilot: An Empirical Study
- [x] Anthropic (2025) Claude Code best practices
- [x] GitHub (2025) How to build reliable AI workflows with agentic primitives and context engineering
- [x] Smart (2017) One to request, one to suggest and one to protest: the anatomy of a Three Amigos Requirements Discovery workshop
- [x] Mitchell (2026) Fundamentals-first versus specs-to-code
- [x] Mitchell (2026) Deep modules in AI-augmented development
- [x] Mitchell (2026) Intent Driven Development
| version | date | commit | summary |
|---|---|---|---|
| 1.0 | 2026-04-30 | 02e771d | Initial completion |