grill-with-docs

Challenge project plan decisions against CONTEXT.md and ADRs to surface ambiguities.

13|3|Updated May 12, 2026
One-click install
npx skills add https://github.com/kevinnft/ai-agent-skills --skill grill-with-docs-kevinnft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/kevinnft/ai-agent-skills/tree/main/skills/mattpocock/engineering/grill-with-docs
Command: npx skills add https://github.com/kevinnft/ai-agent-skills --skill grill-with-docs-kevinnft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grilling session that relentlessly challenges your plan against the project's domain language and existing documentation to surface ambiguities and misalignments, ensuring terminology is consistent and decisions are captured.

Core Features & Use Cases

  • Domain alignment: challenge plan decisions against CONTEXT.md and ADRs to surface ambiguities.
  • Inline documentation updates: guide inline updates to CONTEXT.md and ADRs as decisions crystallize.
  • Codebase awareness: optionally explore repository structure to validate terms against the actual codebase.

Quick Start

Begin a probing session that challenges each decision and updates CONTEXT.md and ADRs as decisions crystallize.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I surface ambiguities in project plans against existing documentation?

To surface ambiguities in project plans, you challenge every decision against domain terminology and existing documentation like CONTEXT.md and ADRs, resolving inconsistencies by capturing explicit choices inline.

How do I align CONTEXT.md and ADRs with new project decisions?

Align CONTEXT.md and ADRs by relentlessly challenging plan decisions against domain language, then updating the documentation inline as decisions crystallize to capture explicit choices and surface inconsistencies.

What is the best way to validate domain terminology against the actual codebase?

Validating domain terminology against the codebase involves exploring repository structure to check that project plans and documentation like CONTEXT.md accurately reflect the actual terms used in the code.

When do I need to update ADRs and CONTEXT.md during project planning?

Update ADRs and CONTEXT.md during project planning when you need to resolve misalignments, surface explicit choices, and ensure terminology consistency as decisions crystallize through probing sessions.

Can I use domain language probing to find inconsistencies between plans and docs?

Yes, domain language probing finds inconsistencies by relentlessly challenging plan decisions against existing documentation and domain terminology, guiding inline updates to CONTEXT.md and ADRs as decisions are made.

Does grill-with-docs work with CONTEXT.md and ADR files?

Yes, grill-with-docs works with CONTEXT.md and ADR files by stress-testing project plans against them, surfacing ambiguities, and guiding inline documentation updates as decisions crystallize.