grill-with-docs

Stress-tests feature plans against project glossaries and ADRs while capturing decisions inline.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/MohamedSayedK/omnigrid --skill grill-with-docs-mohamedsayedk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/MohamedSayedK/omnigrid/tree/main/assets/core/skills/grill-with-docs
Command: npx skills add https://github.com/MohamedSayedK/omnigrid --skill grill-with-docs-mohamedsayedk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Proposed features often drift from a project's established vocabulary, contradict locked architectural decisions, or carry unstated assumptions that surface only after costly implementation. This Skill interrogates a plan against the project's documented domain model before any PRD is written, so terminology, decisions, and boundaries are settled up front. ## Core Features & Use Cases - Domain-model grilling: Challenges a plan across five axes — terminology drift, ADR conflicts, unstated assumptions, boundary crossings, and unresolved forks — using OMNIGRID-CONTEXT.md and omnigrid/artifacts/adrs/ as the source of truth. - Inline decision capture: Writes resolved terms to the glossary, architectural trade-offs to sequentially numbered ADRs, and minor resolved misreadings to a Flagged ambiguities section, each with its rationale. - Lazy doc creation: Creates OMNIGRID-CONTEXT.md and ADR files the first time a decision makes them real, without scolding the user for missing docs. - Use Case: A developer proposes a refactor that renames a core concept. The Skill flags that the glossary explicitly avoids that synonym, quotes the conflicting ADR, forces a decision on the fork, and records the outcome — so the follow-up PRD stage needs no re-derivation. ## Quick Start Ask the assistant to grill your proposed feature plan against the project's context glossary and ADRs before writing the PRD.

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 feature plan against existing architecture decisions?▼

Run the grill stage before writing any PRD. It checks the plan against every ADR in omnigrid/artifacts/adrs/ and the glossary in OMNIGRID-CONTEXT.md, quoting conflicts directly and forcing explicit decisions on unresolved forks.

What is an ADR and when should I create one?▼

An ADR is a markdown file capturing one architectural decision with its context, chosen option, rejected alternatives, and consequences. Create one when a decision has trade-offs and downstream impact; smaller resolved misreadings belong in the glossary's Flagged ambiguities section.

What happens if my project has no context glossary or ADRs yet?▼

The Skill proceeds silently and creates the files lazily the first time a term or decision actually resolves. It never flags their absence as an error or asks you to scaffold documentation upfront.

Does the grill stage commit changes to my repository?▼

No. The Skill updates OMNIGRID-CONTEXT.md and ADR files in the working tree, but nothing is staged or committed. The user reviews the changes and owns the commit.

When should I use a grilling conversation instead of writing a PRD directly?▼

Use it when a plan invents new terminology, touches multiple modules, or has several plausible shapes. Plans that skip the grill often contradict locked decisions or embed assumptions that surface expensively during implementation.