skills.rest
coseto6125
coseto6125COMMUNITY
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

Interviews a plan or design while writing ADRs and a glossary.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions and vague terminology that only surface during implementation, when fixing them is expensive. This Skill stress-tests a plan through a relentless interview while simultaneously capturing the outcomes as durable documentation. ## Core Features & Use Cases - Relentless Interview: Runs a grilling session that challenges every weak point in a plan or design until the reasoning is sharp. - Documentation as a Byproduct: Produces Architecture Decision Records (ADRs) and a project glossary as the interview progresses, using the domain-modeling skill's vocabulary approach. - Use Case: Before starting a new module, present your draft design and let the interview expose ambiguous terms and unjustified decisions, ending with ADRs and a shared glossary the whole team can reference. ## Quick Start Ask the assistant to run a grill-with-docs session on your current plan or design document.

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 interview on the design: each decision and assumption is challenged with pointed questions until the reasoning is explicit. This skill additionally records the outcomes as ADRs and a glossary during the session.

How to create ADRs while discussing a design?▼

This skill writes Architecture Decision Records as the interview progresses, so each challenged decision is captured with its rationale immediately. It also builds a glossary of domain terms using the domain-modeling skill.

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

The grilling skill only stress-tests a plan, decision, or idea through interview. Grill-with-docs runs the same interview but additionally produces ADRs and a glossary as persistent documentation.

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

Avoid it for trivial changes with no architectural weight, or when the plan is already finalized and only needs execution. The interview format is most valuable early, when decisions can still change cheaply.

Related Skills

Explore More Software Engineering Skills→
MDSIXONEMDSIXONE

grill-with-docs

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

Community
Basic
prabaljainnprabaljainn

grill-with-docs

Stress-tests plans against domain glossaries and records decisions in CONTEXT.md and ADRs.

Community
Intermediate
yknothingyknothing
1

domain-modeling

Identify core domain concepts and produce a ubiquitous language glossary.

Community
Advanced
silentFellowsilentFellow
1

grill-with-docs

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

Community
Basic