grill-with-docs

Interviews users to sharpen plans while generating ADRs and glossary documentation.

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

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 structured interview that challenges a plan or design while simultaneously capturing the outcomes as Architecture Decision Records (ADRs) and a domain glossary. ## Core Features & Use Cases - Relentless Interviewing: Runs a grilling session that probes and stress-tests a plan or design through targeted questions. - Documentation as a Byproduct: Creates ADRs and glossary entries during the interview rather than as a separate documentation pass. - Domain Modeling Integration: Delegates to the domain-modeling skill to structure the interrogation around domain concepts. - Use Case: Before committing to an architecture, run a grilling session on your design proposal; the session exposes weak assumptions and leaves behind ADRs explaining each decision and a glossary of agreed terms. ## Quick Start Ask the assistant to grill my current plan or design and produce ADRs and a glossary as we go.

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

Run a grilling session that interviews you about the plan with relentless probing questions. Weak assumptions and gaps surface through the interrogation, and the decisions you make are recorded as ADRs and glossary entries.

How to generate ADRs during design discussions?▼

This Skill creates Architecture Decision Records as a byproduct of the interview itself. Each decision reached during the grilling session is captured as an ADR, so documentation happens alongside the discussion rather than afterward.

What is the difference between grill-me and grill-with-docs?▼

Both run a relentless interview to sharpen a plan, but grill-with-docs additionally produces documentation artifacts. It creates ADRs and a domain glossary during the session by delegating to the domain-modeling skill.

Does this skill run autonomously without user input?▼

No, it is an interactive interview that depends on your answers to probing questions. The disable-model-invocation flag means it is invoked explicitly, and the session progresses through dialogue rather than automated analysis.

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

Avoid it when the plan is already validated and you need execution rather than scrutiny, or when you lack time for an interactive session. In those cases, direct specification or ticket-generation skills are a better fit.