grill-with-docs

Align engineering plans with domain glossary and architectural decisions.

1|Updated May 7, 2026
One-click install
npx skills add https://github.com/Soham407/studio-kickstart --skill grill-with-docs-soham407
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/Soham407/studio-kickstart/tree/main/architecture/matt-pocock-grill-with-docs
Command: npx skills add https://github.com/Soham407/studio-kickstart --skill grill-with-docs-soham407

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces misalignment between a proposed design and your project’s established domain language, terminology, and recorded architectural decisions.

Core Features & Use Cases

  • Relentless plan interrogation: Walks through each branch of the design, resolving dependencies between decisions one-by-one.
  • Terminology and glossary challenges: Flags conflicts with existing CONTEXT.md definitions and sharpens vague or overloaded terms.
  • Living documentation updates: Updates CONTEXT.md inline as terms get resolved, and proposes ADRs only when the decision is a meaningful trade-off.
  • Codebase cross-checking: Inspects the repository to resolve questions and detect contradictions between stated intent and actual implementation.

Quick Start

Ask the AI to grill your current plan against your repository’s existing CONTEXT.md and docs/adr/, one question at a time, until the design language and dependencies are agreed.

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 engineering plan against my domain model and existing architecture decisions?

Validating an engineering plan against your domain model involves iteratively interrogating design assumptions one question at a time, cross-checking the repository code, and flagging terminology conflicts with your established CONTEXT.md glossary.

What is the best way to align new design specifications with domain-driven design terminology?

Aligning design specifications with domain-driven design terminology requires challenging vague or overloaded terms against a living glossary, updating CONTEXT.md inline as definitions are resolved, and reconciling trade-offs across contexts.

When should I create an Architecture Decision Record during a design review?

You should create an Architecture Decision Record during a design review only when the interrogation process identifies a meaningful trade-off, sparingly documenting decisions rather than recording every minor plan adjustment.

How do I check if my stated design intent contradicts the actual codebase implementation?

To check if stated design intent contradicts the actual codebase implementation, perform repository-aware validation that inspects the code directly to detect contradictions and resolve dependencies between documented decisions.

Can I use this approach to resolve terminology conflicts across different bounded contexts?

Yes, you can resolve terminology conflicts across different bounded contexts by challenging assumptions one question at a time, ensuring decision dependencies and trade-offs are reconciled across all relevant artifacts and contexts.