grill-with-docs

Stress-tests plans through structured questioning while updating CONTEXT.md glossaries and ADRs inline.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill grill-with-docs-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/grill-with-docs
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill grill-with-docs-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans often contain fuzzy terminology, hidden contradictions with existing code, and undocumented decisions that future readers cannot understand. This Skill runs an interrogation-style session that challenges your plan against your project's domain language and documented decisions, capturing outcomes in CONTEXT.md and ADR files as they crystallise. ## Core Features & Use Cases - Relentless plan interrogation: Asks one question at a time, walking each branch of the design tree and providing a recommended answer for every question. - Domain language enforcement: Challenges terms that conflict with the existing CONTEXT.md glossary, sharpens vague wording into canonical terms, and updates the glossary inline. - Selective ADR creation: Offers Architecture Decision Records only when a decision is hard to reverse, surprising without context, and the result of a real trade-off. - Use Case: Before implementing a partial order cancellation feature, run a session to discover that your code cancels entire Orders while your plan assumes partial cancellation, then record the resolved terminology in CONTEXT.md and the trade-off in docs/adr/0003-partial-cancellation.md. ## Quick Start Start a grilling session to stress-test my implementation plan for the new billing flow against our existing domain model 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 software design plan before implementing it?

Run a grilling session that interviews you about every aspect of the plan, one question at a time, with a recommended answer for each. It explores the codebase to answer questions itself and surfaces contradictions between your stated intent and the actual code.

What is a CONTEXT.md glossary file in a software project?

CONTEXT.md is a domain glossary defining canonical terms for a project, with avoided synonyms listed under each term. It contains only language definitions, never implementation details, and lives at the repo root or per-context in multi-context repos.

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 repos that have multiple bounded contexts?

Yes. If a CONTEXT-MAP.md exists at the repo root, the session reads it to locate each context's CONTEXT.md and context-specific docs/adr directories. System-wide decisions go in the root docs/adr folder.

What are the limitations of documentation-driven plan review?

The session depends on existing documentation being accurate and on the user answering questions honestly. It creates files lazily, so repos with no prior documentation start from scratch, and it does not execute or test code changes itself.