plan-doctor — команда для Claude Code: что делает и как установить
Команда plan-doctor проверяет, не молчат ли хуки planning-with-files: находится ли план, срабатывает ли инжект, в каком состоянии аттестация. Запускайте, когда хуки притихли.
MIT ★ 28 179 обновлён 2026-10-24
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-filesЧто делает plan-doctor
/plan-doctor запускает скрипт plan-doctor.sh из корня проекта и выдаёт строки PASS, WARN и FAIL. Проверяет то, что в planning-with-files ломается молча: определение активного плана, инжект хуков, форму пути у canonicalizer, состояние аттестации, поверхности установки и задержку хука на каждый запуск.
Хуки и поиск плана при проблеме завершаются с кодом 0 и ничего не пишут, поэтому сломанная установка выглядит как «плана ещё нет». Доктор показывает разницу за один проход. Строки отчёта агент передаёт как есть, а при FAIL объясняет, что чинить. Для resolver смотрите .planning/.active_plan и имена каталогов планов. Для injection при найденном плане проверьте PLANNING_DISABLED и обновитесь выше v3.6.0: там исправлена причина с realpath в Windows-native coreutils. Предупреждение tamper снимается повторным одобрением через /plan-attest, если правку плана сделали вы.
Команда только диагностирует, сама ничего не чинит. Ей нужен инструмент Bash, а на Windows без Git Bash в PATH агент ищет sh.exe рядом с git.exe. Модель сама её не запустит: в команде стоит disable-model-invocation: true, вызывать нужно вручную.
Какие задачи решает
- выяснить, почему хуки planning-with-files молчат
- проверить установку плагина на новой машине
- понять, находится ли активный план по
.planning/.active_plan - поймать случай, когда план найден, а инжект хука не срабатывает
- увидеть задержку хука на каждый запуск
Примеры запросов агенту
- Запусти
/plan-doctor: хуки planning-with-files что-то притихли - Я поставил плагин на новый ноутбук, проверь установку через
/plan-doctor - Прогони
/plan-doctorи покажи строки PASS, WARN и FAIL без изменений
Как установить plan-doctor
1Через маркетплейс плагинов
/plugin marketplace add OthmanAdi/planning-with-files/plugin install planning-with-files@planning-with-files2Вручную: положить файлы
.claude/commands/plan-doctor.mdВызов — /plan-doctor. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/plan-doctor.mdВызов — /prompts:plan-doctor. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/plan-doctor.prompt.mdВручную: положить файлы
.gemini/commands/plan-doctor.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о plan-doctor
Как установить plan-doctor в Claude Code?
Выполните /plugin marketplace add OthmanAdi/planning-with-files, затем /plugin install planning-with-files@planning-with-files. Для ручной установки положите файл команды в .claude/commands/plan-doctor.md.
Что делает plan-doctor?
Запускает plan-doctor.sh в текущем проекте и показывает PASS, WARN и FAIL по определению плана, инжекту хуков, пути canonicalizer, аттестации, поверхностям установки и задержке хука. Нужен он потому, что эти механизмы при сбое молчат.
Работает ли plan-doctor в Codex и чинит ли он проблемы сам?
Codex входит в список платформ, файл команды для него лежит в ~/.codex/prompts/plan-doctor.md. Сам команда ничего не исправляет: она только диагностирует и подсказывает, что делать при FAIL.
Исходный текст
plan-doctor.md · MIT
---
description: "Self-check for the planning-with-files mechanisms that fail silently: plan resolution, hook injection, canonicalizer path shape, attestation state, install surfaces, and per-fire hook latency. Run it whenever hooks seem quiet or after installing on a new machine. Available since v3.6.0."
disable-model-invocation: true
allowed-tools: "Bash"
---
Run the planning-with-files self-check against the current project directory.
Steps:
1. Run the doctor script from the project root:
- Linux/macOS/Git Bash: `sh ${CLAUDE_PLUGIN_ROOT}/scripts/plan-doctor.sh`
- Windows without Git Bash on PATH: locate Git Bash via `git.exe` (its `usr\bin\sh.exe` sibling) and run the same script with it.
2. Report the PASS/WARN/FAIL lines to the user verbatim — they are designed to be read as-is.
3. If any line reports FAIL, explain the matching remediation:
- resolver FAIL → inspect `.planning/.active_plan` content and plan dir names.
- injection FAIL with a resolving plan → the hooks are silently dark; upgrading past v3.6.0 fixes the Windows-native-coreutils realpath cause. Also check `PLANNING_DISABLED`.
- tamper WARN → re-approve with `/plan-attest` if the plan edit was intentional.
4. Do not attempt automatic fixes; this command is diagnostic only.
Why this exists: the mechanisms this skill relies on (hook injection, plan resolution) exit 0 and stay silent by design when something is off, so a broken install looks identical to "no plan yet". The doctor makes the difference visible in one pass.
© OthmanAdi · MIT · OthmanAdi/planning-with-files