skills.rest
mmnavarr
mmnavarrCOMMUNITY
Explore all skills by this author →
Website𝕏@mxlcolmGitHub

grill-with-docs

Runs a structured interview session that challenges plans and produces ADRs and glossary documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague terminology, and unexamined trade-offs that surface too late. This Skill stress-tests a plan through a relentless question-driven interview while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Socratic Plan Review: Runs a grilling session that probes assumptions, edge cases, and design decisions in a plan or design. - Documentation as a Byproduct: Creates Architecture Decision Records (ADRs) and a glossary as the interview progresses, so decisions and terminology are captured in writing. - Use Case: Before implementing a new service architecture, run a grilling session on the design doc to expose weak points and automatically record each resolved decision as an ADR with a shared glossary of domain terms. ## Quick Start Ask the assistant to grill my current plan or design document and record 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 design document before implementation?▼

Run a grilling session on the design document, which interviews you with probing questions about assumptions, trade-offs, and edge cases. Each resolved decision is recorded as an ADR and key terms are added to a glossary.

How to create ADRs while reviewing an architecture plan?▼

This Skill generates Architecture Decision Records as a byproduct of the interview. As each design question is discussed and resolved during the grilling session, the decision and its rationale are written into an ADR.

What documents does a grilling session produce?▼

A grilling session produces two kinds of documentation: Architecture Decision Records capturing resolved design decisions, and a glossary defining the domain terminology that surfaces during the interview.

When should I use an interview-based plan review instead of a checklist?▼

Use an interview-based review when the plan involves novel domain concepts or ambiguous requirements that a static checklist cannot probe. The adaptive questioning follows the discussion, while checklists suit standardized, well-understood review criteria.

Related Skills

Explore More Software Engineering Skills→
MSiccDevMSiccDev
20

arc42-section-08

Document crosscutting concepts spanning multiple building blocks in arc42 systems.

Official
Advanced
roerohanroerohan
27

grill-with-docs

Validate implementation plans against project domain models and architectural decisions.

Community
Intermediate
sylin-orgsylin-org
4

koan-data-modeling

Define aggregate-first domain models with lifecycle hooks and value objects in Koan Framework.

Official
Intermediate
prasunTimalsinaprasunTimalsina

grill-me

Interview plans and designs through structured one-question-at-a-time interrogation.

Community
Advanced