grill-with-docs

Challenge plans and designs by surfacing assumptions and contradictions.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/ian-pascoe/dotfiles-chezmoi --skill grill-with-docs-ian-pascoe
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/ian-pascoe/dotfiles-chezmoi/tree/main/dot_agents/skills/grill-with-docs
Command: npx skills add https://github.com/ian-pascoe/dotfiles-chezmoi --skill grill-with-docs-ian-pascoe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you challenge a plan or design with rigorous questioning so weak assumptions, unclear boundaries, and hidden tradeoffs are exposed early.

Core Features & Use Cases

  • Deep Plan Review: It interrogates your idea from multiple angles to uncover missing requirements and inconsistencies.
  • Docs as You Go: It creates supporting artifacts like ADRs and a glossary while the conversation is in progress.
  • Design Alignment: It pairs well with structured domain modeling when teams need shared language and sharper decisions.

Quick Start

Ask the assistant to run a grilling session on your plan or design and capture ADRs and glossary entries as it goes.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I pressure-test a design plan to surface hidden assumptions and contradictions?▼

To pressure-test a design plan, apply structured questioning to expose weak assumptions, unclear boundaries, and missing decisions early. This interrogation uncovers hidden tradeoffs and inconsistencies across product discovery and architecture reviews.

How do I create ADRs and a glossary incrementally during a domain modeling session?▼

You create ADRs and a glossary incrementally by capturing decisions and shared terminology as the conversation progresses. This aligns with the domain-modeling workflow to maintain shared language and sharper team decisions.

What is the best way to challenge an architecture review without derailing the planning workflow?▼

The best way to challenge an architecture review is through structured questioning that surfaces tradeoffs and missing requirements. This keeps the planning workflow aligned by incrementally drafting supporting artifacts like ADRs and glossary entries.

Can I use structured questioning to align team terminology during product discovery?▼

Yes, you can use structured questioning to align team terminology during product discovery. It pairs well with domain modeling to establish shared language and expose unclear boundaries while drafting a glossary.

When should I not use a grilling session for design review?▼

You should avoid a grilling session for design review when your plan lacks basic requirements or your team has not established initial domain modeling context. It requires existing ideas to interrogate for contradictions and missing decisions.