Verified:GitHub

grill-with-docs

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

4|Updated May 26, 2026

Search Tags:#planning #architecture #domain modeling #adr #glossary #interview #design review

One-click install

npx skills add https://github.com/YYG501/PM-AI-Harness --skill grill-with-docs-yyg501

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/YYG501/PM-AI-Harness/tree/main/vendor/mattpocock-skills/skills/engineering/grill-with-docs
Command: npx skills add https://github.com/YYG501/PM-AI-Harness --skill grill-with-docs-yyg501

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 against a plan or design, sharpening it while producing documentation artifacts as a byproduct. ## Core Features & Use Cases - Relentless Design Interview: Challenges a plan or design with probing questions to expose weak assumptions and gaps. - Documentation as Output: Creates Architecture Decision Records (ADRs) and a domain glossary during the interview process. - Composed Workflow: Orchestrates two underlying capabilities, grilling and domain-modeling, in a single invocation. - Use Case: Before committing to a new system architecture, run this Skill to stress-test the design and walk away with ADRs and a shared vocabulary for the team. ## Quick Start Ask the assistant to grill my current design document and produce ADRs and a glossary from the discussion.

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 structured grilling interview against the design that challenges assumptions, unclear terms, and unexamined trade-offs. This Skill automates that interview and records the outcomes as ADRs and a glossary.

What documentation does a design review interview produce?▼

This Skill produces Architecture Decision Records capturing key decisions and a domain glossary defining shared terminology. Both artifacts are generated as the interview progresses rather than afterward.

Can this Skill be invoked automatically by the AI?▼

No, it sets disable-model-invocation to true and its agent policy disallows implicit invocation. It must be explicitly invoked by the user.

What are the limitations of an interview-based design review?▼

The interview only sharpens what is presented; it cannot validate runtime behavior, performance, or feasibility of unexamined implementation details. Pair it with prototyping or testing for full validation.