grill-with-docs
๐ฏSkillfrom mattpocock/skills
|A skill that runs a grilling session to challenge your plan against an existing domain model, sharpen terminology by building a shared language in CONTEXT.md, and document architectural decisions in ADRs before coding begins.
Overview
A skill from Matt Pocock's "Skills For Real Engineers" collection that runs a grilling session where the AI agent asks you detailed questions about what you are building before any coding starts. It goes beyond the basic /grill-me skill by challenging your plan against the existing domain model, building shared language in a CONTEXT.md file, and documenting architecture decisions in ADRs. The goal is to close the communication gap between developer and agent that is the most common source of misalignment.
Key Features
- Structured grilling session where the agent asks detailed questions to fully understand your requirements before writing code
- Builds and maintains a CONTEXT.md file that captures shared domain language and terminology
- Documents architecture decision records (ADRs) based on the grilling session outcome
- Works with any coding agent model and composes with other skills in the mattpocock/skills toolkit
Who is this for?
- Developers who have experienced the frustration of an AI agent building something that does not match their intent
- Engineers who want to establish clear domain language and architecture decisions before implementation begins
- Teams using AI coding agents on complex projects where misalignment leads to costly rework
Same repository
mattpocock/skills(54 items)
Installation
npx vibeindex add mattpocock/skills --skill grill-with-docsnpx skills add mattpocock/skills --skill grill-with-docs~/.claude/skills/grill-with-docs/SKILL.mdSKILL.md
More from this repository10
Interviews the user relentlessly about every aspect of a plan or design until reaching shared understanding, resolving each branch of the decision tree one by one. Provides recommended answers for each question and explores the codebase when answers can be found there.
An agent skill from Matt Pocock's engineering toolkit that helps improve your codebase architecture. Part of a composable skill set designed to fix common AI coding agent failure modes through structured, experience-based workflows.
Enforces test-driven development with a strict red-green-refactor loop using vertical slices (one test then one implementation at a time), emphasizing behavior verification through public interfaces rather than implementation-coupled testing.
Initial setup skill for Matt Pocock's engineering skills collection that configures your backlog manager, triage labels, and documentation paths for AI coding agents.
A composable skill for triaging issues and tickets using configurable labels, designed to fix common failure modes in AI coding agents by providing structured backlog management workflows.
A collection of small, composable engineering skills designed for real development workflows, featuring grilling sessions for requirement alignment, issue tracking integration, and task triage with customizable labels.
A skill that turns the current conversation context and codebase understanding into a structured PRD (Product Requirements Document) and submits it as a GitHub issue, with modular architecture and user story generation.
Breaks a plan, spec, or PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Each issue is a thin end-to-end path through every integration layer that can be demoed or verified on its own.
Composable, model-agnostic agent skills for real engineering workflows, featuring /grill-me for requirement alignment, /prototype for rapid iteration, and task management tools designed to fix common failure modes in AI coding agents.
A collection of composable engineering skills by Matt Pocock designed to fix common AI coding agent failure modes: misalignment via grilling sessions, verbosity through shared domain language (CONTEXT.md), code quality with TDD red-green-refactor loops, and codebase entropy with architecture improvement workflows.