grill-with-docs

Grill project plans against domain models and update CONTEXT.md and ADRs.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/brandtam/rubber-ducky --skill grill-with-docs-brandtam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/brandtam/rubber-ducky/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/brandtam/rubber-ducky --skill grill-with-docs-brandtam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation inline as decisions crystallise.

Core Features & Use Cases

  • Relentless domain-clarification questioning to surface ambiguities.
  • Live updates to CONTEXT.md and ADRs as decisions crystallize.
  • Guidance through codebase exploration to validate terminology and boundaries.

Quick Start

Start a guided grilling session and answer each question until the domain terms and decisions are clearly documented in CONTEXT.md and ADRs.

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 project plan against a domain model to find ambiguities?

To stress-test your plan against a domain model, run a guided grilling session that uses relentless questioning to surface ambiguities and misalignments, ensuring terminology is sharpened and decisions are captured in CONTEXT.md.

When do I need to update ADRs during domain modeling?

Update ADRs during domain modeling when decisions crystallize during a plan validation session. Propagating these changes to repository documentation ensures architectural choices remain aligned with the clarified domain boundaries.

Can I enforce terminology discipline by inspecting the codebase during documentation?

Yes, you can enforce terminology discipline by inspecting the codebase for supporting evidence. This guided codebase exploration validates that domain boundaries and terms in your CONTEXT.md accurately reflect the implementation.

What is the best way to surface misalignments between project requirements and domain boundaries?

The best way to surface misalignments between requirements and domain boundaries is through domain-clarification questioning. This approach challenges your plan against the existing domain model and updates documentation inline as decisions crystallize.

Does this approach work without external dependencies for updating context artifacts?

Yes, updating context artifacts works without external dependencies. The grilling process relies on guided codebase exploration and decision crystallization to directly update CONTEXT.md and ADRs within your repository.