grill-with-docs

Interrogates plans and designs through structured questioning while generating ADRs and glossary entries.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/CybernetKZ/sdd-kit --skill grill-with-docs-cybernetkz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/CybernetKZ/sdd-kit/tree/main/templates/_migrated/skills/grill-with-docs
Command: npx skills add https://github.com/CybernetKZ/sdd-kit --skill grill-with-docs-cybernetkz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague requirements, and unrecorded decisions. This Skill runs a relentless interview session that stress-tests a plan or design through targeted questioning, while capturing the outcomes as durable documentation such as Architecture Decision Records (ADRs) and glossary entries. ## Core Features & Use Cases - Structured Interrogation: Runs a grilling session built on the domain-modeling skill to expose gaps, ambiguities, and weak assumptions in a plan or design. - Documentation as a Byproduct: Creates ADRs and glossary entries during the interview, so decisions and terminology are recorded as they are clarified. - Existing Convention Awareness: Detects an existing ADR registry and glossary (docs/ADR/ with index, GLOSSARY.md) and records into those formats instead of creating new CONTEXT.md or docs/adr/ conventions. - Use Case: Before implementing a new feature, run a grilling session on the draft design; the session challenges each design choice in Russian-language dialogue and leaves behind ADRs documenting the decisions reached. ## Quick Start Ask the assistant to run a grilling session on your current plan or design document so it can challenge the assumptions and record the resulting 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 design document before implementation?▼

Run a grilling session on the plan or design. The skill asks relentless clarifying questions based on domain modeling, exposing vague requirements and unexamined assumptions, and records the resolved decisions as ADRs and glossary entries.

What documentation does a grilling session produce?▼

The session produces Architecture Decision Records and glossary entries as it progresses. If the project already has a docs/ADR/ registry with an index and a GLOSSARY.md, new entries are recorded in those existing formats.

Does this skill work with an existing ADR registry?▼

Yes. When the project already contains docs/ADR/ with an index and a GLOSSARY.md, the skill records decisions and terms into those files using their established format instead of creating new CONTEXT.md or docs/adr/ conventions.

What language does the grilling interview use?▼

Questions, context, and recommendations to the human are delivered in Russian per the skill's house rules. The generated documentation follows the project's existing ADR and glossary conventions.

When should I not use an interview-based design review?▼

Avoid it for trivial changes with no architectural impact, where a full interrogation session adds overhead without producing meaningful ADRs. It is best suited to plans with significant design decisions or new domain concepts.