К основному содержанию
команда CX Codex

plan-doctor — команда для Claude Code: что делает и как установить

Команда plan-doctor проверяет, не молчат ли хуки planning-with-files: находится ли план, срабатывает ли инжект, в каком состоянии аттестация. Запускайте, когда хуки притихли.

MIT ★ 28 179 обновлён 2026-10-24

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

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

2Вручную: положить файлы

.claude/commands/plan-doctor.md

Вызов — /plan-doctor. Для всех проектов — ~/.claude/commands/

Вопросы о 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

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
ctx-doctor mksglu Скилл ctx-doctor для Claude Code и ещё пяти платформ проверяет готовность context-mode к работе. Запускает диагностику и показывает таблицу статусов без правок. CX Codex +1 1 800установок omc-doctor Yeachan-Heo Скилл omc-doctor для Claude Code разбирает установку oh-my-claudecode: сверяет версию плагина с npm и ищет в настройках старые хуки. CX Codex +1 913установок ruflo-doctor ruvnet Скилл ruflo-doctor прогоняет диагностику установки Ruflo и показывает, что сломано: Node.js, npm, git, конфиг, демон, база памяти, ключи API, MCP-серверы. С флагом --fix чинит типовые поломки. CX Codex +1 755установок basecamp-doctor basecamp Скилл basecamp-doctor проверяет состояние Basecamp CLI, учётных данных и интеграции с агентами. Помогает быстро найти, что сломалось в настройке или требует обновления. CX Codex +1 325установок memory-doctor basicmachines-co Скилл memory-doctor для Claude Code проверяет локальные проекты Basic Memory и объясняет найденные проблемы. Запускается, когда поиск пропускает заметки, дублирует их или сохранение выглядит потерянным. CX Codex +1 249установок doctor OrchestKit Скилл doctor проверяет состояние компонентов OrchestKit, манифестов, хуков, субагентов и серверов MCP. Находит сбои конфигурации и подсказывает способы исправления перед релизом. CX Codex +1 227установок

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

Весь набор →
plan Команда запускает файловое планирование в стиле Manus для сложных задач. Она создаёт файлы task_plan.md, findings.md и progress.md либо подхватывает уже начатый план проекта. CX Codex +1 ★ 28 179звёзд репо pwf Команда pwf для Claude Code запускает файловое планирование задачи через три заметки. Агент подключает её по запросу спланировать работу. CX Codex +1 ★ 28 179звёзд репо pwf Команда pwf запускает рабочий процесс planning-with-files: создаёт план задачи, файл находок и файл прогресса для текущего проекта. CX Codex +1 ★ 28 179звёзд репо status Команда status показывает текущую фазу проекта, процент готовности и ошибки из task_plan.md. Команда запускается для быстрой проверки прогресса без перечитывания всех рабочих файлов. CX Codex +1 ★ 28 179звёзд репо plan-goal Команда plan-goal собирает условие завершения из task_plan.md и подставляет его в /goal, чтобы агент не остановился на середине плана. CX Codex +1 ★ 28 179звёзд репо plan-attest Команда plan-attest фиксирует содержимое task_plan.md с помощью хэша SHA-256. Хуки блокируют инъекцию плана в модель, если файл изменился без повторного подтверждения. CX Codex +1 ★ 28 179звёзд репо plan-loop Команда plan-loop для Claude Code запускает регулярные проверки через /loop и отслеживает файлы плана. Автоматизирует работу по фазам без ручного контроля. CX Codex +1 ★ 28 179звёзд репо planning-with-files Скилл planning-with-files держит план многошаговой задачи в трёх markdown-файлах и возвращает к ним агента каждый ход — контекст не разваливается на длинной сессии. CX Codex +1 ★ 28 179звёзд репо

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

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