grill-with-docs

Guide domain clarification interviews and update CONTEXT.md and ADRs inline.

1|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/ari-ayvazyan/AISkills --skill grill-with-docs-ari-ayvazyan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/ari-ayvazyan/AISkills/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/ari-ayvazyan/AISkills --skill grill-with-docs-ari-ayvazyan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grilling sessions that ensure your plan aligns with the existing domain model, sharpen terminology, and inline-update documentation (CONTEXT.md, ADRs) as decisions crystallize.

Core Features & Use Cases

  • Domain-clarification interviews to align language with repository terminology.
  • Terminology sharpening and conflict resolution with real-time doc updates.
  • Inline documentation refinement for CONTEXT.md and ADRs during decision making.

Quick Start

Begin an interactive session to stress-test your plan against your project's language and documentation.

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 project plan against existing domain terminology?

You can stress-test a plan against existing domain terminology by running interactive clarification interviews that validate your proposed terms against repository documentation and decision records. This ensures your plan aligns with the established domain model before implementation.

What is the best way to resolve terminology conflicts during domain clarification?

Resolving terminology conflicts during domain clarification involves iterating on definitions within an interactive session until consensus is reached. The process validates terms against repository structure and updates documentation inline as decisions crystallize.

How do I inline-update CONTEXT.md and ADRs during decision making?

You can inline-update CONTEXT.md and ADRs during decision making by conducting a grilling session that refines documentation in real time as terminology conflicts are resolved. This keeps your decision records synchronized with the latest domain language.

Do I need a specific model invocation to update repository documentation inline?

No model invocation is required to update repository documentation inline. The domain clarification process functions independently to validate terms against repository structure and update CONTEXT.md and ADRs in real time.

When should I use domain clarification interviews for my project documentation?

Use domain clarification interviews when you need to align language with repository terminology and sharpen definitions before implementing a plan. It is applicable to projects that want to stress-test decisions against existing domain models and decision records.