skills.rest
mintuz
mintuzCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

Runs a structured interview session that challenges a design and produces ADRs and a glossary.

3|Updated Nov 8, 2014
Search Tags:#planning#domain modeling#adr#glossary#interview#design review#architecture decision record
One-click install
npx skills add https://github.com/mintuz/.dotfiles --skill grill-with-docs-mintuz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/mintuz/.dotfiles/tree/main/agents/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/mintuz/.dotfiles --skill grill-with-docs-mintuz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain unexamined assumptions and vague terminology. This Skill stress-tests a plan through a relentless question-and-answer session while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Design Interrogation: Runs a grilling session that probes a plan or design for weaknesses, gaps, and unstated assumptions. - Documentation Generation: Creates Architecture Decision Records (ADRs) and a glossary as the interview progresses. - Use Case: Before implementing a new service, have the design grilled so every key decision is challenged and recorded as an ADR, with domain terms captured in a glossary for the team. ## Quick Start Start a grilling session on my current design and document the decisions as ADRs and a glossary.

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 grilling session that systematically questions the design's assumptions, trade-offs, and edge cases. Each challenged decision is captured as an Architecture Decision Record so the reasoning is preserved.

How to generate ADRs from a design discussion?▼

The session converts challenged design decisions into Architecture Decision Records as the interview progresses. Each ADR records the context, decision, and rationale surfaced during questioning.

What is a domain glossary in software design?▼

A domain glossary defines the key terms and concepts used in a system so the team shares a common vocabulary. This Skill builds the glossary incrementally as terms surface during the design interview.

When should I use a design grilling session?▼

Use it before committing to implementation, when a plan or architecture needs rigorous challenge. It is less useful for trivial changes or designs that have already been reviewed and documented.

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
ethan-rioethan-rio

grill-with-docs

Stress-test project plans against domain glossaries, ADRs, and codebase context.

Community
Intermediate
dairectivdairectiv

doctrine-mapping

Standardize Doctrine entity and aggregate mappings with PHP 8 attributes.

Official
Basic
ladislasladislas
2

pac-grill-me

Interrogate plans one question at a time to resolve decision branches.

Community
Intermediate