grill-with-docs
mattpocock/skills
Conduct rigorous design interviews while auto-generating ADRs and glossary docs.
What is grill-with-docs?
A structured interview skill that challenges assumptions and refines plans or designs through relentless questioning. As you work through the interview, it simultaneously generates Architecture Decision Records (ADRs) and domain glossary entries to document decisions and terminology.
- Asks probing questions to stress-test and sharpen your plan or design
- Captures key decisions and records them as ADRs
- Builds a domain glossary from terminology discussed during the interview
- Identifies gaps and assumptions in your thinking
- Creates documentation artifacts as a byproduct of the interview process
How to install grill-with-docs
npx skills add https://github.com/mattpocock/skills --skill grill-with-docsHow to use grill-with-docs
- 1.Call the Skill tool with 'grilling' mode to begin the relentless interview
- 2.Answer the probing questions honestly to stress-test your plan
- 3.Call the Skill tool with 'domain-modeling' mode to extract and formalize terminology
- 4.Review the generated ADRs and glossary entries for completeness
- 5.Iterate on your design based on gaps or challenges uncovered
Use cases
- Validating a new system architecture before implementation
- Refining a product design by questioning core assumptions
- Documenting design decisions while they're being made
- Building shared vocabulary across a team during design sessions
- Stress-testing a plan to uncover hidden dependencies or risks
- Architects and technical leads
- Product managers designing new features
- Teams planning major system changes
- Anyone formalizing implicit design knowledge
grill-with-docs FAQ
'Grilling' conducts the relentless interview to challenge your plan; 'domain-modeling' extracts and formalizes the terminology and concepts discussed into a glossary and ADR entries.
Have a plan, design, or proposal in mind that you want to stress-test. The skill works best when you have something concrete to discuss.
No, it's a complement to design reviews. It helps you prepare by identifying gaps and documenting decisions, but human review and feedback are still essential.
Yes, you can use it to retrospectively document and challenge decisions in an existing design, or to plan improvements to current systems.
Full instructions (SKILL.md)
Source of truth, from mattpocock/skills.
name: grill-with-docs description: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. disable-model-invocation: true
Call the Skill tool twice, for "grilling" and "domain-modeling".
Related skills
More from mattpocock/skills and the wider catalog.
