grill-with-docs

Interrogate a design plan against the repository domain model in CONTEXT.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents ambiguous, mismatched implementations by forcing you to reconcile your plan with the existing domain glossary, update terminology as you learn, and document decisions as they crystallize.

Core Features & Use Cases

  • Relentless plan interrogation: Interviews the plan branch-by-branch and resolves dependencies between decisions one-by-one until shared understanding is reached.
  • Glossary and terminology alignment: Challenges conflicting terms against CONTEXT.md, proposes canonical replacements for fuzzy language, and keeps definitions tight.
  • Inline documentation updates: Updates CONTEXT.md immediately when terms are resolved and offers ADR creation only when trade-offs make it worthwhile.

Quick Start

Use grill-with-docs for your next design or implementation plan to pressure-test vocabulary and domain relationships against CONTEXT.md while the AI asks one question at a time until you align.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I align my software design plan with an existing domain glossary?

To align your software design plan with a domain glossary, this Skill interrogates your plan branch-by-branch against CONTEXT.md to resolve terminology conflicts and propose canonical replacements, updating the glossary immediately as you answer questions one at a time.

What is the best way to document architecture decisions during a design session?

Documenting architecture decisions during a design session is handled by generating Architecture Decision Records (ADRs) using specified formats, offered only when trade-offs make it worthwhile, while keeping CONTEXT.md updated as terms are resolved inline.

Does this approach require YAML frontmatter to interrogate a codebase plan?

Yes, interrogating a codebase plan requires YAML frontmatter metadata to function, ensuring that domain boundaries and decision dependencies are resolved correctly while cross-referencing existing code and documentation.

How do I eliminate ambiguous assumptions in multi-step implementation plans?

You eliminate ambiguous assumptions in multi-step implementation plans by applying relentless plan interrogation that interviews the plan branch-by-branch, resolving dependencies between decisions one-by-one until shared understanding is reached.

When should I not use a one-question-at-a-time domain modeling approach?

You should not use this one-question-at-a-time domain modeling approach for simple tasks that lack multi-step architecture needs, as it requires waiting for feedback and is built for sessions where terminology, boundaries, and decision dependencies must be resolved.