grill-with-docs

Interrogate product plans against the domain model and update CONTEXT.md and ADRs.

356|59|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/amazingloft999-droid/mattpocock-skills --skill grill-with-docs-amazingloft999-droid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/amazingloft999-droid/mattpocock-skills/tree/main/skills/engineering/grill-with-docs
Command: npx skills add https://github.com/amazingloft999-droid/mattpocock-skills --skill grill-with-docs-amazingloft999-droid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to challenge and refine their project plan by testing it against the existing domain model, sharpen terminology, and keep documentation (CONTEXT.md, ADRs) up to date as decisions crystallize.

Core Features & Use Cases

  • Relentless, one-question-at-a-time grilling to resolve dependencies between design decisions.
  • Live updates to CONTEXT.md and ADRs to reflect agreed decisions during the session.
  • Optional codebase exploration to validate domain concepts against the repository.

Quick Start

Start the session and begin a guided, one-question-at-a-time grilling flow to resolve design decisions.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stress-test a product plan against an existing domain model?

You can stress-test a product plan against a domain model by running a one-question-at-a-time grilling session that challenges design decisions and updates CONTEXT.md and ADRs inline as decisions crystallize.

What is the best way to keep ADRs and CONTEXT.md updated during design discussions?

The best way to keep ADRs and CONTEXT.md updated during design discussions is to apply crystallized decisions live during a guided interrogation, ensuring domain-aligned choices are cross-referenced with the codebase.

Can I validate domain concepts against my codebase while making design decisions?

Yes, you can validate domain concepts against your codebase through optional codebase exploration during the grilling session to ensure terminology and decisions match the repository.

How does interactive design decision grilling work for resolving dependencies?

Interactive design decision grilling works by asking one question at a time across design branches, forcing teams to resolve dependencies between decisions before moving forward.

Do I need existing documentation files to start grilling my project plan?

You need a domain model to test against, and the session will update CONTEXT.md and ADRs as decisions are made, ensuring your documentation reflects the agreed terminology and design choices.

When should I use an interactive grilling session for domain modeling?

You should use an interactive grilling session when your team needs to challenge a project plan, sharpen domain terminology, and ensure cross-referenced documentation updates happen live as decisions are finalized.