grill-with-docs

Validate design plans against domain models using CONTEXT.md glossary alignment.

Updated May 26, 2026
One-click install
npx skills add https://github.com/Peiwvy/myskills --skill grill-with-docs-peiwvy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/Peiwvy/myskills/tree/main/grill-with-docs
Command: npx skills add https://github.com/Peiwvy/myskills --skill grill-with-docs-peiwvy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you validate a proposed design by forcing alignment with your project’s existing domain glossary and documented decisions, reducing misunderstandings and “wrong terminology” drift.

Core Features & Use Cases

  • Relentless plan interrogation: Walks down each branch of the design tree, resolving dependencies between decisions one-by-one via one-question-at-a-time interview.
  • Terminology and glossary alignment: Challenges conflicting terms against CONTEXT.md immediately and proposes precise canonical terminology when language is fuzzy or overloaded.
  • Documentation updates while decisions crystallize: Updates CONTEXT.md inline for resolved terms using the specified glossary format, and offers ADR creation sparingly when trade-offs meet the ADR criteria.

Quick Start

Ask the AI to run the grilling session for your plan and update your CONTEXT.md and any necessary ADRs as you resolve the glossary and decision points.

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 an architecture plan against an existing domain model?

To validate an architecture plan against a domain model, use a one-question-at-a-time interview to interrogate assumptions, reconcile terminology with CONTEXT.md, and clarify boundaries for integration decisions.

What is the best way to align fuzzy domain terminology with a project glossary?

The best way to align fuzzy domain terminology is to challenge conflicting terms immediately against CONTEXT.md and propose precise canonical terminology, updating the glossary inline as decisions are resolved.

How does glossary conflict handling work during a codebase review?

Glossary conflict handling during a codebase review works by interrogating design assumptions and immediately proposing precise canonical terminology when language is fuzzy or overloaded, ensuring alignment with CONTEXT.md.

When should I create an ADR for architecture decisions?

You should create an ADR for architecture decisions only when hard-to-reverse trade-offs are genuinely surprising without context, offering updates sparingly to document rejected alternatives and relationship boundaries.

Can I update CONTEXT.md inline while resolving domain modeling decisions?

Yes, you can update CONTEXT.md inline while resolving domain modeling decisions, applying the specified glossary format to document canonical terminology as soon as conflicts are reconciled.

Does domain modeling interrogation require dependencies to clarify integration boundaries?

Domain modeling interrogation requires no external dependencies to clarify integration boundaries, relying solely on a one-question-at-a-time interview process to walk down each branch of the design tree and resolve decision dependencies.