Interviews a plan or design and generates ADRs and glossary documentation.
npx skills add https://github.com/gmackie/agent-skills --skill grill-with-docs-gmackie
Please help me install this Agent Skill. Skill: grill-with-docs Source: https://github.com/gmackie/agent-skills/tree/main/skills/grill-with-docs Command: npx skills add https://github.com/gmackie/agent-skills --skill grill-with-docs-gmackie
High-intent search queries and answers about installing and using this skill.
Run a grilling session on the plan or design, which asks relentless clarifying questions to expose weak assumptions. As the interview proceeds, decisions are recorded as ADRs and terms are added to a glossary.
The grilling interview captures Architecture Decision Records as decisions are made during the conversation. This avoids writing ADRs retroactively and keeps rationale tied to the actual discussion.
The session produces two artifacts: ADRs recording architectural decisions and a glossary defining domain terms. Both are created incrementally as the interview progresses rather than afterward.
The skill explicitly instructs the agent to run the grilling session using the domain-modeling skill, so domain modeling is part of its intended workflow. Without it, the shared vocabulary grounding would be missing.
Interview-based review is less useful for trivial changes with no architectural impact or when decisions are already fully documented. It adds the most value for ambiguous plans with unresolved trade-offs.
PlagueHODraft architectural proposals documenting problem statements, architecture, decisions, and risks.
sumpalabsGenerate module relationship maps and caller graphs using a project's domain glossary.
kevinnftExtract domain terminology from conversations into a structured glossary file.
lucas-ferrari-correaGuide structured RFC interviews to generate formal RFC documents.
