grill-with-docs

Interrogates a plan or design through structured questioning while generating ADRs and glossary documentation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague requirements, and undocumented decisions. This Skill runs a relentless interview session that challenges a plan or design through pointed questions, while simultaneously capturing the outcomes as Architecture Decision Records (ADRs) and a project glossary. ## Core Features & Use Cases - Structured Interrogation: Runs a grilling session that probes weaknesses, ambiguities, and unstated 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. - Domain Modeling Integration: Leverages the /domain-modeling skill to ground the questioning in a structured model of the problem domain. - Use Case: Before starting implementation of a new feature, run a grilling session on the design proposal to expose gaps and automatically produce decision records and shared vocabulary for the team. ## Quick Start Ask the assistant to grill your current design proposal and document the decisions and terminology that emerge from the session.

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

Run a grilling session that subjects the design to relentless structured questioning, exposing hidden assumptions and gaps. The session documents outcomes as ADRs and glossary entries while the interview progresses.

How to create ADRs during design discussions?

This Skill generates Architecture Decision Records automatically as decisions are clarified during the interrogation session. It also builds a glossary of domain terms, so documentation emerges as a byproduct of the conversation rather than a separate task.

What is a grilling session for design review?

A grilling session is a structured interview where the AI relentlessly questions a plan or design to sharpen it. It uses domain modeling to ground the questions and records decisions and terminology along the way.

Does grill-with-docs work on its own?

No, it depends on other skills to function. It runs a /grilling session and uses the /domain-modeling skill, so those skills must be available in the environment for it to operate.

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

Interview-based review is less suitable when the design is already fully specified and validated, or when you need automated static analysis of code rather than conceptual questioning. It targets early-stage plans where assumptions remain unexamined.