skills.rest
cloudofgeorge
cloudofgeorgeCOMMUNITY
Explore all skills by this author →
Website𝕏@cloudofgeorgeGitHub

grill-with-docs

Runs a structured interview to sharpen plans while generating ADRs and glossary documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions and unresolved questions that surface too late. This Skill runs a relentless interview session that pressure-tests a plan or design while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Structured Grilling Session: Runs a /grilling interview that challenges assumptions and exposes gaps in a plan or design. - Documentation as Output: Creates Architecture Decision Records (ADRs) and a glossary as the interview progresses. - Domain Modeling Integration: Uses the /domain-modeling skill to ground the discussion in a shared vocabulary. - Use Case: Before implementing a new feature, run this Skill to interrogate the design, record each decision as an ADR, and build a glossary of domain terms for the team. ## Quick Start Ask the agent to run a grilling session on your current plan or design so it can challenge assumptions and produce 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 plan before implementation?▼

Run a grilling session that interviews you about the plan, challenging assumptions and exposing gaps. This Skill conducts that interview and records the outcomes as ADRs and a glossary as you go.

How to create ADRs during design discussions?▼

This Skill generates Architecture Decision Records automatically as the grilling interview progresses. Each decision surfaced during the session is captured as an ADR alongside a growing domain glossary.

What is a grilling session for engineering plans?▼

A grilling session is a relentless question-and-answer interview that pressure-tests a plan or design. It forces explicit answers about assumptions, trade-offs, and domain terminology before implementation begins.

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

No, it explicitly delegates to the /domain-modeling skill as part of the grilling session. Both skills must be available in the environment for the workflow to run as documented.

When should I not use a grilling interview for planning?▼

Avoid it for trivial or well-understood tasks where the overhead of producing ADRs and a glossary adds no value. It is best suited to plans with meaningful ambiguity or architectural impact.

Related Skills

Explore More Software Engineering Skills→
ev3rlitev3rlit

prd

Generate product requirements documents with executive summaries, user stories, and acceptance criteria.

Community
Advanced
RohithdgrrRohithdgrr

grill-with-docs

Stress-tests plans against CONTEXT.md glossaries and ADR records through structured interviews.

Community
Advanced
SwitchbackTechSwitchbackTech
228

grill-with-docs

Grill a plan against the repository's domain model to surface ambiguities.

Official
Advanced
NNPopovNNPopov
2

grill-with-docs

Clarify product plans against codebase, glossary, and architecture notes.

Community
Advanced