Verified:GitHub

grill-with-docs

Interrogates a plan or design and produces ADRs and a glossary.

Updated Jul 25, 2026

Search Tags:#planning #documentation #domain modeling #adr #glossary #interview #design review

One-click install

npx skills add https://github.com/regisleandro/clara-financas --skill grill-with-docs-regisleandro

Or copy as Structured Prompt for Agent▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague terms, and unexamined trade-offs that only surface during implementation. This Skill runs a relentless structured interview that pressure-tests a plan or design while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Structured Interrogation: Runs a grilling session that challenges assumptions, edge cases, and design decisions in a plan. - Documentation as a Byproduct: Creates Architecture Decision Records (ADRs) and a glossary incrementally as the interview progresses. - Domain Modeling Integration: Delegates to the domain-modeling skill to ground the discussion in a shared vocabulary. - Use Case: Before implementing a new billing module, run a grilling session on the design doc to expose unresolved questions and automatically record each decision as an ADR with agreed terminology in the glossary. ## Quick Start Start a grilling session on my current design document and record the decisions as ADRs and glossary entries.

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

Run a grilling session on the design document. The skill asks relentless questions about assumptions, edge cases, and trade-offs, and records each resolved decision as an ADR plus glossary entries as the session progresses.

What is an ADR and how does this skill create one?▼

An ADR (Architecture Decision Record) documents a design decision with its context and rationale. During the grilling interview, each decision that emerges from the questioning is written up as an ADR alongside a shared glossary.

Can I use this skill for domain modeling workshops?▼

Yes. The skill explicitly delegates to the domain-modeling skill during the session, so terminology and domain concepts surfaced by the interview are captured consistently in the glossary.

When should I not use a grilling session for a plan?▼

Avoid it for trivial or already-validated plans where the interview overhead exceeds the value. It is designed for designs with unresolved ambiguity, not for rubber-stamping finished decisions.