grill-with-docs
vinvcn/mattpocock-skills-zh-cn
Iterative questioning interviews to refine plans and designs while generating ADRs and glossaries.
What is grill-with-docs?
A skill that conducts structured, continuous questioning interviews to sharpen plans or designs. It generates Architecture Decision Records (ADRs) and domain vocabulary documentation as outputs, helping teams clarify thinking and create lasting reference materials.
- Conducts iterative questioning interviews to probe and refine plans or designs
- Generates Architecture Decision Records (ADRs) documenting key decisions
- Creates domain glossaries capturing key terminology and concepts
- Identifies gaps and ambiguities in planning through structured questioning
- Produces documentation artifacts during the interview process
How to install grill-with-docs
npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill grill-with-docsHow to use grill-with-docs
- 1.Call the skill tool twice: once with `grilling` to conduct the questioning interview
- 2.Call the skill tool a second time with `domain-modeling` to generate the documentation artifacts
- 3.Review generated ADRs and glossary entries for accuracy and completeness
Use cases
- Refining architectural decisions before implementation begins
- Clarifying product requirements and design intent with stakeholders
- Building shared vocabulary and mental models across teams
- Documenting design rationale for future team members
- Validating completeness of technical or product plans
- Architects and technical leads
- Product managers and designers
- Teams building new systems or features
- Anyone formalizing implicit knowledge into documentation
grill-with-docs FAQ
An ADR (Architecture Decision Record) documents important architectural decisions, their context, and rationale. This skill creates them to ensure decisions are explicit and future-proof.
The skill conducts iterative questioning to probe assumptions, identify gaps, and refine thinking around your plan or design.
The glossary captures domain-specific terminology and concepts identified during the interview, creating a shared reference for the team.
Yes, the skill applies to any plan or design that benefits from rigorous questioning and documented decision rationale.
Full instructions (SKILL.md)
Source of truth, from vinvcn/mattpocock-skills-zh-cn.
name: grill-with-docs description: 一个用来打磨计划或设计的持续追问式访谈，并在过程中创建文档（ADRs 和词汇表）。 disable-model-invocation: true
调用两次 Skill 工具，分别指定 grilling 和 domain-modeling。
Related skills
More from vinvcn/mattpocock-skills-zh-cn and the wider catalog.
grilling
Systematically pressure-test plans, decisions, or ideas through structured questioning.
handoff
Compress conversation into a handoff document for the next agent to continue work.
implement
Implement features from specs or tickets with TDD and code review.
improve-codebase-architecture
Scan codebases for architectural deepening opportunities and generate visual refactoring reports.
loop-me
Interview-driven workflow specification tool using the Loop lens to identify and design automatable patterns.
migrate-to-shoehorn
Migrate TypeScript test assertions from `as` to type-safe @total-typescript/shoehorn helpers.