grill-with-docs

Validate a plan by grilling it against the current domain model with iterative questioning and inline documentation updates.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/mostafa-K-raihan/skills --skill grill-with-docs-mostafa-k-raihan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/mostafa-K-raihan/skills/tree/main/grill-with-docs
Command: npx skills add https://github.com/mostafa-K-raihan/skills --skill grill-with-docs-mostafa-k-raihan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams validate and align their plan against the existing domain language and decisions by methodically grilling assumptions, terminology, and context, while keeping documentation inline.

Core Features & Use Cases

  • Relentless questioning to uncover hidden dependencies and ensure shared understanding.
  • Step-by-step exploration of design branches, with decisions reflected in CONTEXT.md and ADRs as they crystallize.
  • Inline documentation updates during the session to keep the project language consistent.

Quick Start

Begin a grilling session by presenting your plan and I will relentlessly challenge it against your domain docs and update inline decisions as they 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 validate a plan against my domain documentation?

Validate a plan against domain documentation by applying iterative questioning to challenge assumptions, clarify terminology, and ensure alignment with your current domain model and project context. This process uncovers hidden dependencies and documents decisions inline.

What is the best way to align terminology during plan development?

Align terminology during plan development by methodically grilling your plan against existing domain docs, resolving ambiguities step-by-step, and updating CONTEXT.md inline to maintain a shared understanding and consistent project language.

How does grilling a plan help resolve dependencies?

Grilling a plan resolves dependencies through relentless, step-by-step questioning that exposes hidden assumptions and design branches, ensuring all decision points are documented in ADRs and CONTEXT.md as they crystallize for full traceability.

Can I update my CONTEXT.md inline while challenging a plan?

Yes, you can update CONTEXT.md inline while challenging a plan. The grilling process requires iterative questioning one item at a time, directly reflecting crystallized decisions and resolved terminology into your project documentation during the session.

When do I need to document decisions in ADRs during plan validation?

Document decisions in ADRs during plan validation when exploring design branches step-by-step. As the grilling process clarifies dependencies and context, decisions are captured inline to ensure alignment, consistency, and traceability across the project documentation.

What distinguishes iterative grilling from standard plan reviews?

Iterative grilling distinguishes itself by relentlessly challenging plans one item at a time against the domain model, resolving dependencies through step-by-step exploration, and producing inline documentation updates to ensure alignment and traceability.