grill-with-docs

Stress-tests plans against CONTEXT.md glossaries and ADR records through structured interviews.

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/Rohithdgrr/REEK-uninstaller --skill grill-with-docs-rohithdgrr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/Rohithdgrr/REEK-uninstaller/tree/main/.opencode/skills/grill-with-docs
Command: npx skills add https://github.com/Rohithdgrr/REEK-uninstaller --skill grill-with-docs-rohithdgrr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Plans often use vague or conflicting domain terminology that drifts away from a project's documented language and recorded architectural decisions, causing design defects and documentation decay. This Skill runs a disciplined one-question-at-a-time interview that challenges a plan against the project's CONTEXT.md glossary and docs/adr/ decision records, updating those files inline as terms and decisions crystallize. ## Core Features & Use Cases - Docs-anchored grilling: Challenges every term in a plan against the existing CONTEXT.md glossary, sharpens fuzzy language, and cross-references claims against the actual codebase. - Inline documentation updates: Edits CONTEXT.md the moment a term is resolved and writes ADRs only when decisions are hard to reverse, surprising, and the result of a real trade-off. - Stdlib-only validators: Ships three Python scripts — a CONTEXT.md linter, an ADR scanner (numbering, format, supersession links), and a glossary-to-code consistency checker that flags dead glossary terms and undefined code-only nouns. - Use Case: Before implementing a new billing feature, run a grilling session to discover that your plan says "account" while CONTEXT.md defines "Customer", resolve the conflict, update the glossary, and record an ADR for the event-sourced write model decision. ## Quick Start Ask the assistant to grill the current feature plan with docs against the project's CONTEXT.md and ADR records.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I stress-test a design plan against project documentation?▼

Run a grill-with-docs session, which interviews you one question at a time about the plan while checking every term against CONTEXT.md and every decision against docs/adr/. Contradictions between your plan, the glossary, and the code are surfaced immediately.

What is a CONTEXT.md file in domain-driven design?▼

CONTEXT.md is a per-bounded-context glossary stored in source control that defines each domain term in one sentence, lists forbidden aliases, and shows relationships between terms. It excludes implementation details and generic programming concepts.

When should I write an architecture decision record?▼

Write an ADR only when a decision is hard to reverse, surprising without context, and the result of a real trade-off — all three must hold. Library swaps, style choices, and easily reversed decisions do not earn ADRs.

Does the glossary consistency checker require external Python packages?▼

No, all three validator scripts are stdlib-only Python. They use regex and filesystem walking to lint CONTEXT.md structure, scan ADR numbering, and cross-reference glossary terms against source code without any pip installs.

How do I detect domain terms used in code but missing from the glossary?▼

Run glossary_code_consistency.py with --context and --code flags. It counts capitalized nouns in non-test source files and reports frequent ones absent from CONTEXT.md, plus glossary terms never used in code.

What are the limitations of the glossary-to-code consistency check?▼

Matching is case-insensitive word-boundary regex, so it cannot distinguish semantic usage from coincidental name matches. Proper-noun detection is a frequency heuristic with a tunable threshold, and only common source file extensions are scanned by default.