skills.rest
J0Jng
J0JngCOMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

Interrogates a plan or design while generating ADRs and a glossary.

7|1|Updated Jul 17, 2026
Search Tags:#planning#architecture#domain modeling#adr#glossary#interview#design review
One-click install
npx skills add https://github.com/J0Jng/MathModelingAgents --skill grill-with-docs-j0jng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/J0Jng/MathModelingAgents/tree/main/.claude/skills/engineering/grill-with-docs
Command: npx skills add https://github.com/J0Jng/MathModelingAgents --skill grill-with-docs-j0jng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain hidden assumptions, vague terms, and unchallenged decisions that surface only during implementation. This Skill runs a relentless structured interview that pressure-tests a plan or design and captures the outcomes as durable documentation. ## Core Features & Use Cases - Relentless Design Interview: 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 during the /grilling session to structure the discussion. - Use Case: Before starting a new service, run a grilling session on your draft architecture; walk away with a hardened design plus ADRs and a shared glossary for the team. ## Quick Start Ask the assistant to run a grilling session on your current design document so it challenges the plan and produces 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 on the design, which interrogates assumptions, trade-offs, and edge cases through structured questioning. The session also produces ADRs and a glossary documenting the decisions reached.

What documentation does a design grilling session produce?▼

The session produces Architecture Decision Records (ADRs) capturing key decisions and a glossary defining domain terms. These documents are created incrementally as the interview progresses.

How do I create ADRs during a design review?▼

Use the grill-with-docs workflow, which writes ADRs as decisions are challenged and resolved during the interview. This avoids writing decision records retroactively after the review ends.

Does this skill work with domain modeling?▼

Yes, the grilling session explicitly delegates to the /domain-modeling skill. Domain modeling structures the discussion of entities, boundaries, and terminology while the interview challenges the design.

When should I not use a design grilling interview?▼

Avoid it for trivial changes or well-understood tasks where interrogation adds no value. It is intended for plans and designs with meaningful ambiguity, assumptions, or architectural trade-offs.

Related Skills

Explore More Software Engineering Skills→
PlagueHOPlagueHO
2

architectural-proposals

Draft architectural proposals documenting problem statements, architecture, decisions, and risks.

Community
Advanced
atelier-fashionatelier-fashion
159

architect

Generate architecture designs and task breakdowns from requirements.

Official
Advanced
mgreenlymgreenly

ddd

Standardize domain concepts and glossary across the ikigai project.

Community
Advanced
milistumilistu
7

conventional-comments

Format code-review feedback with labeled Conventional Comments.

Community
Basic