grill-with-docs

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

Updated Mar 30, 2026

Search Tags:#domain modeling #adr #glossary #design review #plan validation #architecture decisions

One-click install

npx skills add https://github.com/ninthday/skills-base --skill grill-with-docs-ninthday

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/ninthday/skills-base/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/ninthday/skills-base --skill grill-with-docs-ninthday

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions and unresolved decisions that surface too late. This Skill stress-tests a plan through relentless questioning while simultaneously capturing the outcomes as durable documentation. ## Core Features & Use Cases - Relentless Interrogation: Delegates to the grilling skill to expose unresolved assumptions in a plan, decision, or design. - Documentation as a Byproduct: Delegates to the domain-modeling skill to create Architecture Decision Records (ADRs) and glossary entries during the interview. - Use Case: Before implementing a new service architecture, run this Skill to challenge the design decisions and automatically record each resolved decision as an ADR with agreed terminology in a glossary. ## Quick Start Ask the agent to grill my current design proposal and document the decisions as ADRs and glossary entries.

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 agent?▼

Invoke this Skill on your plan or design document. It runs a relentless interview that challenges each decision, then records the resolved outcomes as Architecture Decision Records and glossary entries.

What documentation does grill-with-docs produce?▼

It produces Architecture Decision Records (ADRs) capturing each decision made during the interview, plus glossary entries defining agreed domain terminology. Both are created incrementally as the questioning proceeds.

Does grill-with-docs work on its own?▼

No, it is an orchestration Skill that invokes two other skills: grilling for the interrogation loop and domain-modeling for the documentation output. Both must be available for it to function.

When should I use grill-with-docs instead of just grilling?▼

Use grill-with-docs when you want the interview outcomes persisted as ADRs and glossary entries. Use grilling alone when you only need to challenge assumptions without producing formal documentation.