grill-with-docs

Interviews users to stress-test plans against domain glossaries and ADR documentation.

3|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/craft-ts/craft-ts --skill grill-with-docs-craft-ts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/craft-ts/craft-ts/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/craft-ts/craft-ts --skill grill-with-docs-craft-ts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans often embed fuzzy terminology and decisions that contradict a project's existing domain language or documented architecture. This Skill runs a structured interrogation of your plan, one question at a time, checking every term and decision against CONTEXT.md glossaries and ADRs so inconsistencies surface before implementation. ## Core Features & Use Cases - Relentless plan interrogation: Walks each branch of the design tree, asking one question at a time with a recommended answer, and explores the codebase directly when a question can be answered there. - Terminology sharpening: Challenges terms that conflict with CONTEXT.md, proposes canonical names for vague language, and updates the glossary inline as terms are resolved. - Decision recording: Offers to write ADRs only when a decision is hard to reverse, surprising without context, and the result of a real trade-off, using the format in ADR-FORMAT.md. - Use Case: Before building a partial order cancellation feature, run a grilling session to discover that your code cancels entire Orders while your plan assumes partial cancellation, then record the resolution in CONTEXT.md and an ADR. ## Quick Start Start a grilling session on my plan for the new billing flow and challenge it against our existing CONTEXT.md and ADRs.

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 software design plan before implementation?▼

Run a grilling session that interviews you about every branch of the plan, one question at a time, with a recommended answer for each. Questions that can be resolved by reading the codebase are answered through code exploration instead of asking you.

How to keep domain terminology consistent across a project?▼

Maintain a CONTEXT.md glossary that defines canonical terms and lists words to avoid. During design discussions, conflicting or vague terms are flagged immediately and the glossary is updated inline as each term is resolved.

When should I write an architecture decision record?▼

Write an ADR only when a decision is hard to reverse, surprising without context, and the result of a genuine trade-off between alternatives. If any of these three conditions is missing, skip the ADR to avoid documentation noise.

Does this work with multiple bounded contexts in one repo?▼

Yes. If a CONTEXT-MAP.md exists at the repo root, it lists each context, its location, and its relationships. The session infers which context the current topic belongs to and asks when it is unclear.

What are the limitations of a plan grilling session?▼

The session challenges plans and records decisions but does not implement code or validate runtime behavior. CONTEXT.md is strictly a glossary, so implementation details and specs must be documented elsewhere.