grill-with-docs

Runs a structured design interview that produces ADRs and a glossary.

Updated Aug 14, 2026

Search Tags:#planning #domain modeling #adr #glossary #interview #design review #architecture decision record

Ready to run

npx skills add https://github.com/MDSIXONE/opencode-config --skill grill-with-docs-mdsixone

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/MDSIXONE/opencode-config/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/MDSIXONE/opencode-config --skill grill-with-docs-mdsixone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain hidden assumptions and unresolved trade-offs that surface too late. This Skill stress-tests a plan or design through a relentless question-driven interview while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Design Interrogation: Runs a grilling session that challenges assumptions, edge cases, and trade-offs in a plan or design. - 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 structure the concepts surfaced during the session. - Use Case: Before implementing a new service, run a grilling session on the proposed architecture so every contested decision is recorded as an ADR and shared vocabulary is captured in a glossary. ## Quick Start Ask the assistant to grill my current design proposal and document the decisions as ADRs and a glossary.

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 that systematically questions the design's assumptions, edge cases, and trade-offs. Each resolved point is captured as an Architecture Decision Record, so the review produces documentation instead of just verbal feedback.

How to generate ADRs during a design review?▼

This Skill writes Architecture Decision Records incrementally as the interview progresses, recording each decision and its rationale at the moment it is made. It also maintains a glossary of domain terms that emerge during discussion.

What is a grilling session in design planning?▼

A grilling session is a relentless interview where the design author must defend every choice under questioning. It surfaces hidden assumptions early and converts the answers into ADRs and glossary entries.

Does this skill work without the domain-modeling skill?▼

No, the instructions explicitly delegate to the domain-modeling skill for structuring concepts. Without that companion skill available, the domain modeling portion of the workflow cannot be executed as designed.

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

Avoid it for trivial changes with no architectural impact or when decisions are already finalized and documented. The interview format adds the most value for ambiguous, high-stakes designs with unresolved trade-offs.