grill-with-docs

Validate proposed plans against CONTEXT.md domain models and ADRs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents misalignment between a proposed design and the project’s established terminology, domain model, and documented decisions by forcing a plan to be clarified and validated.

Core Features & Use Cases

  • Relentless plan interview: It questions every branch of the design tree one step at a time until shared understanding is reached.
  • Terminology and glossary sharpening: It detects conflicts with the project’s glossary in CONTEXT.md and proposes precise canonical terms.
  • Scenario-driven boundary testing: It probes edge cases and relationships using concrete invented scenarios to resolve ambiguous boundaries.
  • Code and documentation cross-checking: If answers can be derived from the codebase, it explores it to surface contradictions and reconcile statements with reality.
  • Inline documentation updates: It updates CONTEXT.md immediately when terms are resolved, keeping it free of implementation details, and offers ADRs only when a real trade-off is recorded.

Quick Start

Ask the AI to run grill-with-docs on your proposed change, and provide the high-level plan you want stress-tested.

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 existing project documentation?

To validate an architecture plan against existing documentation, you stress-test the proposed design by cross-referencing the codebase and questioning every branch against the established domain model to eliminate ambiguity.

What is the best way to resolve mismatched terminology in a domain model?

Resolving mismatched terminology in a domain model requires detecting conflicts within the project glossary, proposing precise canonical terms, and immediately updating CONTEXT.md to maintain consistency across the architecture.

When do I need an Architecture Decision Record for my design?

You need an Architecture Decision Record when your design stress-testing reveals a hard-to-reverse trade-off. ADRs should be suggested sparingly to ensure decision traceability only for significant architectural choices, not implementation details.

How do I test edge cases for ambiguous domain boundaries?

Testing edge cases for ambiguous domain boundaries involves using scenario-driven boundary testing, probing relationships with concrete invented scenarios to resolve ambiguities and validate the architecture step-by-step.

Can I use CONTEXT.md to track glossary updates during codebase review?

Yes, you can use CONTEXT.md to track glossary updates during a codebase review. It should be updated inline with resolved terms immediately, keeping the documentation free of implementation details and aligned with the domain model.

Why does my proposed integration plan conflict with documented architecture decisions?

A proposed integration plan conflicts with documented architecture decisions when terminology is mismatched or boundaries are ambiguous. Relentless plan interviewing and codebase cross-referencing surface these contradictions to reconcile statements with reality.