grill-with-docs

Interviews users to sharpen designs while updating CONTEXT glossaries and ADRs.

2|Updated May 14, 2026
One-click install
npx skills add https://github.com/AnthonyPoschen/agent-skills --skill grill-with-docs-anthonyposchen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/AnthonyPoschen/agent-skills/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/AnthonyPoschen/agent-skills --skill grill-with-docs-anthonyposchen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design discussions often end with fuzzy terminology and decisions that live only in chat transcripts, forcing teams to re-litigate vocabulary later. This Skill runs a relentless interview that challenges ambiguous terms and contradictions while writing durable domain documentation as decisions crystallise. ## Core Features & Use Cases - Relentless design interview: Challenges fuzzy terms, surfaces contradictions with code and existing glossary entries, and forces concrete scenarios until the plan is sharp enough to implement. - Inline documentation updates: Updates the CONTEXT.md glossary and creates ADRs in docs/adr as decisions are made, plus optional living alignment docs when the repo declares them. - First-party domain-modeling integration: Loads the sibling domain-modeling skill directly, with no third-party mattpocock/skills runtime dependency. - Use Case: When starting a new feature, run the interview to pin down domain vocabulary, record architectural decisions as ADRs, and leave the repo with an accurate glossary instead of a lost chat transcript. ## Quick Start Ask the agent to grill you on your new feature design and update the project glossary and ADRs as decisions are made.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I keep design decisions documented during planning?▼

Run a grilling interview that challenges ambiguous terms and forces concrete scenarios, then record each crystallised decision immediately. This Skill updates the CONTEXT.md glossary and creates ADRs in docs/adr inline as the discussion progresses.

What is a CONTEXT.md glossary in domain modeling?▼

CONTEXT.md is a project glossary that defines domain terminology so teams share consistent vocabulary. This Skill updates it inline as terms are clarified during the design interview, keeping definitions aligned with actual decisions.

When should I write an ADR during feature design?▼

Write an ADR when a decision meets the ADR criteria defined in the domain-modeling skill, typically for significant architectural choices. This Skill creates entries under docs/adr as those decisions crystallise during the interview.

Does grill-with-docs require mattpocock/skills to be installed?▼

No, this is a first-party adaptation that loads the sibling domain-modeling skill directly from the same repository. It explicitly avoids any dependency on /setup-matt-pocock-skills or third-party mattpocock/skills paths.

When are living alignment docs updated versus skipped?▼

Living short alignment docs are updated only if the repository explicitly declares them, per the domain-modeling skill rules. If the repo does not declare them, they are correctly skipped rather than created.