grill-with-docs

Stress-tests plans through structured interviews while updating CONTEXT.md glossaries and ADR documentation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans often contain fuzzy terminology, hidden contradictions with existing code, and undocumented decisions that future engineers will question. This Skill runs a relentless one-question-at-a-time interview that challenges your plan against your project's domain language and codebase, then captures resolved terms and decisions as documentation inline. ## Core Features & Use Cases - Socratic plan interrogation: Walks each branch of the design tree one question at a time, providing a recommended answer for every question and exploring the codebase when answers can be found there. - Ubiquitous language enforcement: Challenges terms that conflict with the existing CONTEXT.md glossary, sharpens vague words into canonical terms, and updates the glossary inline as terms are resolved. - Selective ADR capture: Offers Architecture Decision Records only when a decision is hard to reverse, surprising without context, and the result of a real trade-off, using a minimal one-paragraph format. - Use Case: Before implementing a partial order cancellation feature, run a grilling session that exposes the contradiction between your stated behavior and the code's full-cancellation logic, resolves 'cancellation' vs 'refund' terminology into CONTEXT.md, and records the event-sourcing decision as ADR 0003. ## Quick Start Start a grilling session on my plan for the new billing flow and update our CONTEXT.md and ADRs as we make decisions.

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 one question at a time about every branch of the design tree. Each question comes with a recommended answer, and questions answerable from the codebase are resolved by exploring the code directly.

How to maintain a ubiquitous language glossary in a repo?

Keep a CONTEXT.md at the repo root with one-sentence term definitions, aliases to avoid, relationships, and flagged ambiguities. Update it inline whenever a term is resolved during design discussions rather than batching changes.

When should I write an architecture decision record?

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

Does this work with multiple bounded contexts in one repo?

Yes. A root CONTEXT-MAP.md lists each context, its location, and its relationships, while each context keeps its own CONTEXT.md and context-specific docs/adr directory. System-wide decisions live in the root docs/adr folder.

What happens when my plan contradicts the existing code?

The session cross-references your statements against the codebase and surfaces contradictions directly, such as code that cancels entire orders while you described partial cancellation. You must resolve which behavior is correct before proceeding.