Ask an AI coding agent to "build an online appointment booking system," and it will start writing code in seconds—guessing everything you left out along the way.
Can customers book without an account? Can two people book the same staff member at the same time? What even separates a Customer from a Staff member from an Admin? When your prompt doesn't answer these, the agent decides for you—and some of those guesses will be wrong.
In this article, I walk through grill-with-docs, a skill from Matt Pocock's skills repository that interviews you one question at a time before any code gets written. It sharpens vague requirements into precise terms, writes the agreed vocabulary into a CONTEXT.md glossary, and produces a spec you can actually build from.
The article covers:
- What grill-with-docs does and how it fits into an agentic workflow.
- Installation and when to reach for it (and when not to).
- A full step-by-step walkthrough with real prompts and screenshots.
- Common mistakes to avoid and its practical limitations.
Read the full walkthrough here 👇
Top comments (0)