skills.rest
PVMalove
PVMaloveCOMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

Runs a structured interview to sharpen plans while generating ADRs and a glossary.

Updated Aug 19, 2026
Search Tags:#planning#domain modeling#requirements#adr#glossary#interview#design review
One-click install
npx skills add https://github.com/PVMalove/claude-agent-harness --skill grill-with-docs-pvmalove
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/PVMalove/claude-agent-harness/tree/main/skills/first-party/pvmalove/grill-with-docs
Command: npx skills add https://github.com/PVMalove/claude-agent-harness --skill grill-with-docs-pvmalove

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden ambiguity that surfaces only during implementation. This Skill runs a relentless interview session that challenges assumptions, sharpens the plan, and captures decisions as documentation (ADRs and a glossary) along the way. ## Core Features & Use Cases - Structured Interview: Runs a /grilling session that interrogates a plan or design to remove uncertainty before work begins. - Documentation as a Byproduct: Creates Architecture Decision Records (ADRs) and a project glossary during the conversation. - Domain Modeling Integration: Delegates to the /domain-modeling skill to ground terminology and concepts. - Use Case: Before starting a new feature epic, run the interview to expose unclear requirements, record each decision as an ADR, and hand a sharpened plan to the spec and ticketing stages. ## Quick Start Ask the agent to run a grilling session on my feature plan and produce ADRs and a glossary as we go.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I remove ambiguity from a feature plan before implementation?▼

Run a grilling session that interviews you about the plan, probing unclear requirements and assumptions. Each resolved decision is captured as an ADR and new terminology goes into a glossary, so the sharpened plan is ready for spec and ticket breakdown.

What documentation does a grilling session produce?▼

The session produces Architecture Decision Records (ADRs) capturing each decision made during the interview, plus a project glossary defining domain terms. These artifacts are created incrementally as the conversation progresses.

Can I use this with other planning skills like spec writing?▼

Yes, it is designed as the first step in a delivery pipeline. The sharpened plan and its ADRs feed directly into spec publication and ticket slicing stages, and it internally delegates to a domain-modeling skill for terminology work.

When should I not run a grilling session?▼

Skip it for small, well-understood changes where requirements are already unambiguous, since the interview adds overhead. It is most valuable for new features or designs with open questions and multiple stakeholders.

Related Skills

Explore More Product & Management Skills→
CommandCodeAICommandCodeAI
103

brainstorming

Convert vague ideas into structured design documents and implementation plans.

Official
Basic
valorisavalorisa
4

create-github-issues

Break down feature plans into vertical slice GitHub issues with dependencies.

Community
Intermediate
ViperJuiceViperJuice
8

{project}-domain

Map project domain vocabulary and entity relationships into a validated glossary.

Community
Intermediate
nyldnnyldn
4.0k

octopus-quick

Automates small ad-hoc tasks with atomic commits and state tracking.

Community
Basic