grill-with-docs — плагин для Claude Code: план и установка
Плагин grill-with-docs проверяет план по языку проекта и решениям из CONTEXT.md и docs/adr/, а затем обновляет эти документы по ходу обсуждения.
MIT ★ 30 251 обновлён 2026-10-23
/plugin marketplace add alirezarezvani/claude-skills
/plugin install grill-with-docs@claude-code-skillsЧто делает grill-with-docs
grill-with-docs ведёт пошаговый разбор плана: задаёт по одному вопросу, сверяет термины с CONTEXT.md, решения с docs/adr/, а спорные места сопоставляет с кодовой базой. По итогам сессии остаются заметки, обновления в CONTEXT.md и новые ADR, когда решение трудно отменить, требует контекста и связано с реальным компромиссом.
В состав входят три Python-инструмента для проверки CONTEXT.md, нумерации и структуры ADR, а также согласованности терминов со столбцами кода. Есть три справочных документа, субагент cs-grill-with-docs и слэш-команда /cs-grill-with-docs. Для запуска проверок нужен Python; путь src/ в команде нужно заменить, если код лежит в другом каталоге.
Какие задачи решает
- проверить план по языку существующего проекта
- найти противоречия между глоссарием и кодом
- просканировать ADR на нумерацию и структуру
- зафиксировать архитектурные решения во время обсуждения
Примеры запросов агенту
- Запусти
/cs-grill-with-docsдля проверки этого плана поCONTEXT.md,docs/adr/и коду. - Проверь термины в
CONTEXT.md, затем задай вопросы по каждой ветке плана по одному. - Перед сессией выполни проверки для
CONTEXT.md,docs/adr/иsrc/.
Как установить grill-with-docs
Через маркетплейс плагинов
/plugin marketplace add alirezarezvani/claude-skills/plugin install grill-with-docs@claude-code-skillsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о grill-with-docs
Как установить grill-with-docs в Claude Code?
Выполните /plugin marketplace add alirezarezvani/claude-skills и затем /plugin install grill-with-docs@claude-code-skills.
Что делает grill-with-docs?
Плагин разбирает план с учётом языка проекта, записанных решений и кода. Он обновляет CONTEXT.md и при соблюдении трёх условий предлагает создать ADR.
Чем grill-with-docs отличается от grill-me?
grill-me работает только с текстом плана и оставляет заметки. grill-with-docs добавляет CONTEXT.md, docs/adr/, кодовую базу и обновления документов.
Исходный текст
grill-with-docs · MIT
# grill-with-docs Docs-anchored grilling session. Walks the decision tree of a plan one branch at a time, but does so against the project's existing **language** (`CONTEXT.md`) and recorded **decisions** (`docs/adr/`). Sharpens terminology + records architecturally-significant decisions inline as they crystallise. ## Attribution **Derived from [Matt Pocock's grill-with-docs](https://github.com/mattpocock/skills/tree/main/skills/engineering/grill-with-docs)** (MIT, © 2026 Matt Pocock). Matt's interview discipline + domain-awareness rules preserved verbatim per his MIT license — relentless one-question-at-a-time grilling, codebase-and-docs-first exploration, the three-criterion gate for offering an ADR (hard-to-reverse + surprising-without-context + real-trade-off). ## How this differs from `grill-me` | Aspect | `grill-me` | `grill-with-docs` | |---|---|---| | Grounding | Plan text only | Plan + `CONTEXT.md` + `docs/adr/` + codebase | | Output | Session notes | Session notes **plus** inline updates to CONTEXT.md and (when warranted) new ADRs | | Question source | Decision tree extracted from plan | Decision tree **plus** language conflicts, fuzzy terms, code-vs-glossary contradictions | | When to use | Stress-testing a fresh plan | Onboarding a plan into an established codebase with documented language | Both ship as separate plugins; pick whichever matches the situation. The `grill-me` skill is plan-only; `grill-with-docs` is plan + project memory. ## What this adds on top of Matt's original | Addition | Where | Why | |---|---|---| | **3 stdlib Python tools** | `skills/grill-with-docs/scripts/` | Lint CONTEXT.md format · Walk docs/adr/ for numbering + body integrity · Cross-reference bold terms in CONTEXT.md against codebase usage (dead glossary + code-only common nouns) | | **3 in-depth references** (7+ sources each) | `skills/grill-with-docs/references/` | Ubiquitous language canon · ADR practice canon · CONTEXT.md as living artifact | | **cs-grill-with-docs persona agent** | `agents/cs-grill-with-docs.md` | Docs-aware grill voice; pre-flights the linters before the first question | | **`/cs-grill-with-docs` slash command** | `commands/cs-grill-with-docs.md` | Activation + workflow handoff | ## Matt's original (preserved) > "Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. Ask the questions one at a time, waiting for feedback on each question before continuing. If a question can be answered by exploring the codebase, explore the codebase instead." > "Only offer to create an ADR when all three are true: hard to reverse, surprising without context, the result of a real trade-off. If any of the three is missing, skip the ADR." ## Quick start ```bash # 1. Lint existing CONTEXT.md (if present) python skills/grill-with-docs/scripts/context_md_linter.py CONTEXT.md # 2. Scan existing ADRs (if present) python skills/grill-with-docs/scripts/adr_scanner.py docs/adr/ # 3. Cross-reference glossary terms against codebase python skills/grill-with-docs/scripts/glossary_code_consistency.py \ --context CONTEXT.md --code src/ # 4. Use /cs-grill-with-docs to start the session ``` ## License MIT (matching Matt's upstream).
© Alireza Rezvani · MIT · alirezarezvani/claude-skills