skills.rest
titaneric
titanericCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

Runs a structured interview session that challenges plans and generates ADRs and glossary documentation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, gaps, and unchallenged decisions. This Skill runs a relentless interview session that stress-tests a plan or design while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Structured Interrogation: Runs a grilling session that probes a plan or design with tough questions to expose weaknesses and unstated assumptions. - Documentation as Output: Creates Architecture Decision Records (ADRs) and a glossary as the interview progresses, so decisions and terminology are captured automatically. - Domain Modeling Integration: Delegates to the domain-modeling skill to ground the session in structured domain concepts. - Use Case: Before committing to a new system architecture, run a grilling session to challenge the design, then keep the generated ADRs and glossary as the project's decision record. ## Quick Start Ask the assistant to run a grilling session on your current plan or design 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 design or plan with an AI interview?▼

Run a grilling session that asks relentless probing questions about your plan or design to expose gaps and unstated assumptions. The session challenges decisions systematically rather than accepting the plan at face value.

How to generate ADRs from a design discussion?▼

The grilling session creates Architecture Decision Records automatically as the interview progresses. Each challenged decision and its resolution is captured as an ADR alongside a glossary of domain terms.

What documentation does a grilling session produce?▼

It produces two artifacts: Architecture Decision Records documenting the decisions reached during the interview, and a glossary defining the domain terminology used throughout the discussion.

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

No, it depends on the domain-modeling skill to run the session. The SKILL.md explicitly instructs the grilling session to use the domain-modeling skill, so that skill must be available.

When should I use a grilling session instead of a normal design review?▼

Use it when you want adversarial questioning rather than passive feedback, and when you need durable documentation. It is best suited for plans mature enough to defend but not yet finalized.

Related Skills

Explore More Software Engineering Skills→
windmill-labswindmill-labs
17.8k

grill-me

Runs a relentless interview session to sharpen a plan or design.

Official
Basic
yikartyikart
25.6k

to-prd

Generates a PRD from conversation context and publishes it to the project issue tracker.

Official
Intermediate
jarrodmedranojarrodmedrano
2

domain-driven-design

Model business domains using Domain-Driven Design principles with aggregates and bounded contexts.

Community
Advanced
CarbonTailsCarbonTails

grill-me

Conduct structured interview sessions to refine and validate plans or designs.

Official
Intermediate