grill-with-docs

Validate project plans against the CONTEXT.md glossary and detect terminology contradictions.

13|1|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/nandinhos/devorq_v3 --skill grill-with-docs-nandinhos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/nandinhos/devorq_v3/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/nandinhos/devorq_v3 --skill grill-with-docs-nandinhos

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

DEVORQ-GRILL v1.0.0 — Terminology sparring for DEVORQ v3.6.2. Validates the plan against the glossary (CONTEXT.md), detects contradictions between code and plan, and creates ADRs when decisions qualify. Integrated with GATE-0 as a non-blocking BREAK/warn.

Core Features & Use Cases

  • Validates the plan against the existing CONTEXT.md glossary to prevent vague terms.
  • Detects contradictions between code and plan and proposes ADRs when decisions are non-trivial.
  • Integrates with DEVORQ flow as a non-blocking gate (GATE-0) with breaking/warning signals to guide teams.

Quick Start

Install the grill-with-docs skill and run grill-detect.sh to start context scanning and ADR vetting.

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 project terminology against a CONTEXT.md glossary?

To validate project terminology against a CONTEXT.md glossary, use the grill-detect.sh script to scan context and surface contradictions between code and plans. This prevents vague terms by checking your plan against existing defined vocabulary.

How do I generate ADRs for non-trivial design decisions?

You can generate ADRs for non-trivial design decisions by running grill-suggest-adr.sh to vet decisions and grill-create-adr.sh to create them. This workflow triggers when terminology contradictions or significant design choices are detected during validation.

What is terminology governance in DEVORQ-driven development?

Terminology governance in DEVORQ-driven development is the process of guarding vocabulary consistency using a CONTEXT.md glossary. It validates plans against defined terms, detects code contradictions, and integrates as a non-blocking GATE-0 warn to guide teams without halting progress.

Can I use shell scripts to detect contradictions between code and project plans?

Yes, you can use shell scripts like grill-detect.sh to detect contradictions between code and project plans. The script scans for terminology mismatches against your CONTEXT.md glossary and proposes ADRs when the detected design decisions qualify.

Do I need a CONTEXT.md file to initialize terminology scanning?

Yes, you need a CONTEXT.md file or existing code to initialize terminology scanning. The grill-init-context.sh script sets up the required glossary environment, enabling detection and ADR generation for DEVORQ-driven contexts.

When should I expect a breaking signal during terminology validation?

You should expect a breaking signal during terminology validation when the grill-detect.sh script finds severe contradictions between your plan and the CONTEXT.md glossary. Integrated as a non-blocking GATE-0, it issues warnings or breaks to guide teams on vocabulary issues.