skills.rest
jordizle
jordizleCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

Interrogates a design plan while generating ADRs and glossary documentation.

Updated Sep 17, 2026
Search Tags:#architecture#documentation#domain modeling#requirements#adr#interview#design review
One-click install
npx skills add https://github.com/jordizle/claude-skills --skill grill-with-docs-jordizle
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/jordizle/claude-skills/tree/main/grill-with-docs
Command: npx skills add https://github.com/jordizle/claude-skills --skill grill-with-docs-jordizle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ambiguous feature designs and plans often hide unexamined assumptions that surface only during implementation. This Skill runs a relentless structured interview to sharpen a plan or design while simultaneously producing the documentation (ADRs and a domain glossary) that records the decisions reached. ## Core Features & Use Cases - Design Interrogation: Challenges a proposed plan or design through persistent questioning until ambiguities are resolved. - Documentation Generation: Creates Architecture Decision Records (ADRs) and a domain glossary as the interview progresses. - Workflow Integration: Invoked by the engineering-loop router as the first step for ambiguous features, producing a proposed ADR before implementation begins. - Use Case: When asked to build a feature with unclear requirements, use this Skill to grill the design, settle open questions, and walk away with a proposed ADR and updated glossary ready for implementation. ## Quick Start Ask the assistant to grill this feature design with docs and produce a proposed ADR and glossary before any implementation starts.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clarify an ambiguous feature design before coding?▼

Run a structured design interrogation that questions every assumption in the plan until ambiguities are resolved. This Skill coordinates the grilling and domain-modeling skills to sharpen the design and record outcomes as ADRs and glossary entries.

How to generate ADRs during a design discussion?▼

Use this Skill to interview the design while it writes Architecture Decision Records and a domain glossary as the conversation progresses. The output is a proposed ADR that is accepted only after implementation confirms it matches reality.

What skills does grill-with-docs depend on?▼

It depends on the grilling and domain-modeling skills, which it invokes by name through the Skill tool. Both must be installed alongside it, otherwise the routing from engineering-loop breaks.

When should I use design grilling versus direct implementation?▼

Use design grilling only for ambiguous features where requirements are unsettled. Well-defined features, straightforward bugs, and tiny changes should go directly to implementation, since grilling adds no value when the design is already settled.

Can grill-with-docs be invoked automatically by other workflows?▼

No, its agent policy sets allow_implicit_invocation to false, so it must be called explicitly. The engineering-loop router invokes it by name for ambiguous feature work as part of its routing sequence.

Related Skills

Explore More Software Engineering Skills→
TobiasPerryTobiasPerry

office-hours

Guide structured context gathering to produce review-ready design documents.

Community
Advanced
prabaljainnprabaljainn

grill-with-docs

Stress-tests plans against domain glossaries and records decisions in CONTEXT.md and ADRs.

Community
Intermediate
mattpocockmattpocock
242.8k

grill-with-docs

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

Community
Basic
saitarrunsaitarrun
4

grill-me

Interview project plans sequentially to expose hidden gaps and assumptions.

Community
Intermediate