grill-with-docs

Clarify domain concepts through Q&A and update CONTEXT.md and ADRs.

Updated Apr 21, 2026

Search Tags:#code review #interactive design #decision recording #real-time documentation #domain clarification

Ready to run

npx skills add https://github.com/erikshafer/CritterCab --skill grill-with-docs-erikshafer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/erikshafer/CritterCab/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/erikshafer/CritterCab --skill grill-with-docs-erikshafer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill aids in clarifying domain understanding and terminology, and in updating documentation inline as decisions are made, ensuring a shared understanding and maintaining accurate records.

Core Features & Use Cases

Domain Clarification: Engage in a Q&A session to explore and clarify domain concepts and decisions.
Documentation Update: Automatically update CONTEXT.md and ADRs as decisions are made during the session.
Use Case: When designing a new feature, use this Skill to discuss and document the design decisions, ensuring that the team has a clear understanding and that the documentation is kept up to date.

Quick Start

Start a grilling session with the 'grill-with-docs' skill to discuss your feature design and update documentation inline.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema

How do I clarify domain concepts and update documentation during a design discussion?▼

You clarify domain concepts and update documentation by engaging in an interactive Q&A session that explores design decisions and records them in real-time. This ensures shared understanding and maintains accurate project records.

What is the best way to record design decisions while discussing a new feature?▼

The best way to record design decisions is through an interactive grilling session that automatically updates your project documentation and Architecture Decision Records inline as decisions are made.

Can I automatically update CONTEXT.md and ADRs during a code review or design session?▼

Yes, you can automatically update CONTEXT.md and ADRs during a design session. The documentation is updated inline as decisions are made, ensuring records stay accurate without manual editing.

Do I need a structured documentation format to interactively clarify domain terminology?▼

Yes, you need a structured documentation format and a decision recording mechanism. These prerequisites allow the interactive clarification session to effectively capture and update domain terminology accurately.

How does real-time documentation update work when exploring domain design decisions?▼

Real-time documentation update works by facilitating a Q&A session to explore domain concepts, then writing the outcomes directly into project files as decisions are reached. This keeps records aligned with the discussion.

When should I use an interactive grilling session for documentation updates?▼

You should use an interactive grilling session when designing a new feature and needing to discuss, clarify, and document design decisions. This ensures the team maintains a clear, shared understanding of the domain.