grill-with-docs

Elicit and record domain terms and ADR decisions during planning.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stress-test a plan against a project domain model by eliciting and recording domain terms and decisions.

Core Features & Use Cases

  • Interrogation workflow to surface fuzzy terms and align stakeholders
  • Inline CONTEXT.md updates and ADR capture as decisions crystallize
  • Guardrails to route to specialized skills and maintain documentation fidelity

Quick Start

Begin a grill-with-docs session on your plan to document domain terms and ADR decisions as you go.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I document domain terms and decisions during project planning?

To document domain terms and decisions during planning, use an interrogation workflow to stress-test plans against a project domain model. This surfaces fuzzy terminology and captures decisions as ADRs while updating CONTEXT.md inline as terms crystallize.

What is the best way to stress-test a plan against a domain model?

Stress-testing a plan against a domain model involves running a structured interrogation workflow to elicit and record domain terms. This aligns stakeholders by exposing undocumented or fuzzy terminology and capturing architectural decisions as they emerge.

When do I need to create ADRs and update CONTEXT.md?

You need to create ADRs and update CONTEXT.md when domain terminology is fuzzy or undocumented. A structured interrogation workflow captures these decisions inline as they crystallize during the planning phase, maintaining documentation fidelity.

How do I maintain a domain glossary when terminology is undocumented?

Maintaining a domain glossary when terminology is undocumented requires an interrogation workflow that elicits and records domain terms. As decisions crystallize during planning, glossary terms are updated inline within CONTEXT.md to ensure alignment.

Can I capture architectural decisions while interrogating a project plan?

Yes, you can capture architectural decisions while interrogating a project plan. The workflow records ADRs as decisions crystallize and simultaneously updates CONTEXT.md, ensuring domain context and terminology remain aligned throughout the process.

Why does domain terminology become fuzzy during software planning?

Domain terminology becomes fuzzy during software planning when terms remain undocumented or stakeholders use inconsistent language. An interrogation workflow surfaces these ambiguous terms, records them in a domain glossary, and aligns stakeholders through structured questioning.