grill-with-docs

Conduct structured interviews and generate ADRs and glossaries for design plans.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/yash-garg/pi-config --skill grill-with-docs-yash-garg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/yash-garg/pi-config/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/yash-garg/pi-config --skill grill-with-docs-yash-garg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams refine unclear plans and designs by conducting a structured interview process while capturing important decisions and domain knowledge.

Core Features & Use Cases

  • Relentless Design Interviews: Guides users through focused questioning to challenge assumptions and improve technical or product plans.
  • Documentation Creation: Produces architecture decision records and glossaries alongside the discussion process.
  • Use Case: A product team can use this Skill to pressure-test a new system design and create a durable record of the reasoning behind key decisions.

Quick Start

Use the grill-with-docs skill to interview me about my plan and create the supporting design documents.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I refine an unclear product plan through structured documentation?

Refine an unclear product plan through structured documentation by conducting a focused design interview that challenges assumptions and captures important decisions. This process generates architecture decision records and glossaries alongside the discussion.

What is the best way to create architecture decision records during a design review?

The best way to create architecture decision records during a design review is to use a guided interview process that pressure-tests system designs and produces durable records of the reasoning behind key decisions.

How does an interview-based approach improve domain modeling and terminology refinement?

An interview-based approach improves domain modeling by relentlessly questioning assumptions during collaborative design sessions, directly refining terminology and generating a glossary to align team understanding.

Can I pressure-test a system design and generate a glossary at the same time?

Yes, you can pressure-test a system design and generate a glossary simultaneously by running a structured questioning process that captures domain knowledge and produces supporting design documents in parallel.

When do I need architecture decision records for product planning?

You need architecture decision records for product planning when you must pressure-test a new system design and create a durable record of the reasoning behind key technical or product decisions.

Do I need a domain-modeling workflow to generate ADRs?

Yes, you need integration with domain-modeling workflows to effectively create ADRs and glossaries during collaborative design sessions, ensuring assumptions and terminology are properly refined.