G

grill-with-docs

bymattpocock·#13 trending

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

150,900stars
First seenApr 28, 2026

Installation

Send this command to your AI agent:

npx skills add https://github.com/mattpocock/skills --skill grill-with-docs

Documentation

Relentless design interrogation that stress-tests plans against your domain model and sharpens terminology inline.

  • Explores your codebase to ground discussions in existing code, glossaries (CONTEXT.md), and architectural decisions (ADRs)
  • Challenges fuzzy language, resolves terminology conflicts, and updates your domain glossary as decisions crystallize
  • Tests design decisions against concrete scenarios to expose edge cases and boundary violations
  • Creates or updates CONTEXT.md and ADRs only when warranted, keeping documentation lean and decision-focused