К основному содержанию
плагин

grill-with-docs — плагин для Claude Code: план и установка

Плагин grill-with-docs проверяет план по языку проекта и решениям из CONTEXT.md и docs/adr/, а затем обновляет эти документы по ходу обсуждения.

MIT ★ 30 251 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add alirezarezvani/claude-skills
/plugin install grill-with-docs@claude-code-skills
Открыть на GitHub

Что делает 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

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
grill-me JuliusBrussee Скилл grill-me для Claude Code стресс-тестирует планы, архитектурные решения и идеи в интервью по одному вопросу за раз. CX Codex +1 2 900установок grill JuliusBrussee Скилл grill задаёт точечные вопросы по одному за раз, чтобы отсеять слабые места в идее фичи до составления спецификации. CX Codex +1 816установок codex-spec-interviewer stark-ai-de Скилл codex-spec-interviewer для Claude Code и Codex превращает нечёткие требования в выверенное техническое задание. Он сопоставляет вводные с репозиторием и формирует критерии приёмки перед началом кодинга. CX Codex +1 2 700установок claude-spec-interviewer stark-ai-de Скилл claude-spec-interviewer превращает нечёткую задачу в проверенную спецификацию с критериями приёмки, планом тестирования и нужными ADR до написания кода. CX Codex +1 2 600установок docs-writer justxor Субагент docs-writer автоматически актуализирует README, API-документацию, комментарии и ADR когда вы меняете код. Проверяет фактическое поведение и держит примеры в синхронизации с реальностью. CX Codex ★ 353звёзд репо update-docs alexj11324 Скилл update-docs для Claude Code находит документацию проекта, которой коснулись изменения кода или решений. Перед правками он показывает план и ждёт одобрения. CX Codex +1 ★ 88звёзд репо

Из того же набора488

Весь набор →
video-content-strategist Плагин video-content-strategist для Claude Code помогает планировать видеостратегию, писать сценарии роликов и оптимизировать каналы на YouTube. Также помогает выстраивать пайплайны Shorts, Reels и TikTok. ★ 30 251звёзд репо business-investment-advisor Плагин business-investment-advisor для Claude Code анализирует инвестиции в оборудование, недвижимость, найм и технологии, сравнивая проекты по ROI, IRR, NPV и сроку окупаемости. Помогает распределить ограниченный бюджет между вариантами. ★ 30 251звёзд репо prompt-governance Плагин prompt-governance для Claude, который ведёт промпты в продакшене: версионирование, A/B-тесты, реестр и защита от регрессий. ★ 30 251звёзд репо llm-cost-optimizer Плагин llm-cost-optimizer снижает расходы на API языковых моделей через маршрутизацию запросов и кэширование промптов. Пригодится при высоких счётах за токены и запуске новых ИИ-функций. ★ 30 251звёзд репо power-user-coach Плагин power-user-coach для Claude Code на старте подбирает приёмы под ваши задачи, а затем изредка даёт одну подсказку по ходу диалога. ★ 30 251звёзд репо behuman Плагин behuman добавляет внутренний диалог перед генерацией ответа, чтобы Claude Code писал естественнее и без сухого роботизированного тона. ★ 30 251звёзд репо snowflake-development Плагин snowflake-development для Claude Code помогает работать с Snowflake SQL, пайплайнами данных и Snowpark Python. Он также охватывает Cortex AI и dbt. ★ 30 251звёзд репо compliance-os Плагин compliance-os для Claude Code подбирает применимые фреймворки, сопоставляет контроли, симулирует аудит и собирает единый пул доказательств для команд, ведущих несколько программ соответствия. ★ 30 251звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой