skills.rest
changfengpro
changfengproCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, gaps, and ambiguities that surface too late. This Skill runs a relentless interview session that stress-tests your plan or design while capturing the outcomes as Architecture Decision Records (ADRs) and a glossary. ## Core Features & Use Cases - Relentless Interviewing: Runs a /grilling session that challenges assumptions and exposes weaknesses in a plan or design. - Documentation as a Byproduct: Creates ADRs and glossary entries during the session, so decisions and terminology are recorded as they emerge. - Domain Modeling Integration: Uses the /domain-modeling skill to structure the interrogation around domain concepts. - Use Case: Before committing to a new system architecture, run a grilling session to pressure-test the design and walk away with documented decisions and a shared vocabulary. ## Quick Start Ask the assistant to grill my current design plan and produce ADRs and a glossary from the session.

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 with an AI interview?▼

Run a grilling session that relentlessly questions your plan or design to expose hidden assumptions and gaps. The session uses domain modeling to structure the interrogation around your system's core concepts.

What documentation does a design grilling session produce?▼

The session produces Architecture Decision Records (ADRs) and a glossary as it progresses. Decisions and terminology are captured in real time rather than documented separately afterward.

What is an ADR in software design?▼

An ADR (Architecture Decision Record) is a short document capturing a significant architectural decision, its context, and its consequences. This Skill generates ADRs automatically during the interview session.

When should I use a grilling session instead of a design review meeting?▼

Use it when you want systematic, relentless questioning of assumptions without scheduling a group review. It works best early in planning, before decisions solidify, and leaves behind written ADRs and a glossary.

Can this Skill be invoked automatically by the AI?▼

No, the Skill sets disable-model-invocation to true and its agent policy disallows implicit invocation. It only runs when you explicitly request a grilling session.

Related Skills

Explore More Software Engineering Skills→
quaid-appquaid-app
3

architectural-proposals

Draft structured architectural proposals with problem statements, decisions, and risks.

Official
Advanced
yikartyikart
25.6k

to-prd

Generates a PRD from conversation context and publishes it to the project issue tracker.

Official
Intermediate
MilesChouMilesChou
1

ddd-strategic-design

Discover domain boundaries and generate DDD artifacts from stakeholder interviews.

Community
Basic
willdadywilldady
63

grill-with-docs

Interrogate technical designs and generate Architecture Decision Records and project glossaries.

Community
Intermediate