grill-with-docs

Interview users to align plan terminology with CONTEXT.md and ADRs.

Updated May 2, 2026
One-click install
npx skills add https://github.com/ayehiaa/my-travel-assistant --skill grill-with-docs-ayehiaa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/ayehiaa/my-travel-assistant/tree/main/.claude/skills/grill-with-docs
Command: npx skills add https://github.com/ayehiaa/my-travel-assistant --skill grill-with-docs-ayehiaa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It resolves ambiguity and mismatched terminology in plans by forcing a disciplined walkthrough against your existing glossary and documented decisions.

Core Features & Use Cases

  • Relentless domain interviewing: challenges every assumption in your plan until the team reaches shared, precise understanding.
  • Glossary and terminology sharpening: flags conflicts when your wording disagrees with CONTEXT.md and proposes canonical terms.
  • Scenario-based boundary testing: probes edge cases and relationship cardinalities with concrete examples to clarify what’s in-scope vs out-of-scope.
  • Code-to-doc consistency checks: cross-references the codebase to detect contradictions between how you say things work and how they actually work.
  • Documentation updates as you decide: updates CONTEXT.md inline when terms are resolved and offers ADRs sparingly using an explicit trade-off test.

Quick Start

Use grill-with-docs to interview you step-by-step about your proposed feature plan until your terminology and decisions match the existing CONTEXT.md and any required ADRs are justified.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I stress-test a feature plan against existing domain documentation?

To stress-test a feature plan against domain documentation, you undergo an iterative, one-question-at-a-time interview that cross-references your plan with your repository's glossary and documented decisions to eliminate terminology drift and hidden contradictions.

What is the best way to detect terminology drift between a design plan and a codebase?

The best way to detect terminology drift is by cross-referencing the codebase against your proposed wording to find contradictions, automatically flagging conflicts when terms disagree with your documented domain model.

How do I clarify requirements and boundaries for an integration design discussion?

You clarify requirements and boundaries for integration discussions by using scenario-based boundary testing, probing edge cases and relationship cardinalities with concrete examples to define what is in-scope versus out-of-scope.

Does this domain modeling approach automatically update CONTEXT.md and write ADRs?

This domain modeling approach updates CONTEXT.md inline when terminology conflicts are resolved, and it optionally creates Architecture Decision Records using an explicit trade-off test when justified by the design review.

When should I not use an automated glossary conflict detection tool for codebase review?

You should not use glossary conflict detection for codebase review when your design discussion lacks precise boundary definitions, as the relentless domain interviewing requires defined requirements, relationships, and decision points to function effectively.