grill-with-docs

Challenges proposed design plans using CONTEXT.md glossary and ADRs as reference.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/luizgmassa/Useful-Agent-Skills --skill grill-with-docs-luizgmassa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/luizgmassa/Useful-Agent-Skills/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/luizgmassa/Useful-Agent-Skills --skill grill-with-docs-luizgmassa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Grills a proposed plan by challenging it against your existing domain language and documentation, so you converge on shared terminology and correct relationships before you implement.

Core Features & Use Cases

  • Relentless domain questioning: Interviews every assumption and forces precise answers about the meaning of terms and boundaries between concepts.
  • Terminology and glossary validation: Detects conflicts with your CONTEXT.md language and resolves ambiguous terms into a canonical glossary entry.
  • Inline documentation updates: Updates CONTEXT.md as terms get resolved, and offers ADRs only when a decision has real trade-offs that are hard to reverse.

Quick Start

Ask your agent to run grill-with-docs on your current design plan, using the repository’s CONTEXT.md and ADRs as the source of truth.

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 domain terminology against my existing codebase documentation?

Validate domain terminology by challenging a proposed design plan against an existing domain glossary and documented decisions to eliminate mismatched terms and unclear boundaries. The process cross-checks assumptions with the codebase and docs to ensure accurate terminology alignment.

What is the best way to align architecture review terminology with a project glossary?

Align architecture review terminology by applying relentless domain questioning to interview every assumption and force precise answers about terms and boundaries. This detects conflicts with your documented language and resolves ambiguous terms into canonical glossary entries.

When do I need to create an ADR during a refactoring discussion?

Create an ADR during a refactoring discussion only when a resolved decision has real trade-offs that are hard to reverse. The process uses sparing ADR creation criteria and formats, prioritizing inline CONTEXT.md updates for standard terminology resolutions instead.

How do I update CONTEXT.md when resolving ambiguous domain terms?

Update CONTEXT.md through immediate inline updates as ambiguous terms get resolved during the questioning process. This ensures that canonical glossary entries are captured directly in the documentation while the design plan is being stress-tested.

Can I use domain questioning to stress-test product design plans before implementation?

Yes, you can use domain questioning to stress-test product and system design plans before implementation by challenging them against existing domain language. This ensures terms and relationships align with the codebase and docs, preventing mismatched terminology.

Does terminology alignment require one-at-a-time questioning or batch processing?

Terminology alignment requires one-at-a-time questioning with codebase cross-checks to accurately resolve each term and boundary. This methodical approach ensures precise answers and immediate CONTEXT.md inline updates without missing contextual dependencies.