plan-loop — команда для Claude Code: планирование и установка
Команда plan-loop для Claude Code запускает регулярные проверки через /loop и отслеживает файлы плана. Автоматизирует работу по фазам без ручного контроля.
MIT ★ 28 179 обновлён 2026-10-24
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-filesЧто делает plan-loop
plan-loop запускает плановый цикл поверх /loop. Команда принимает интервал вроде 10m и необязательный промпт, находит активный план, затем передаёт задачу в /loop. Без собственного промпта она читает task_plan.md и progress.md, запускает scripts/check-complete.sh, добавляет запись о прогрессе при остановке и обновляет статус завершённой фазы.
После запуска команда показывает интервал и идентификатор активного плана. Обычный /loop без аргументов использует встроенный промпт Claude Code, а plan-loop каждый тик привязывает к файлам планирования. Для остановки по завершении плана её можно сочетать с /plan-goal. Без task_plan.md команда откажется работать и попросит сначала выполнить /plan. Доступна начиная с v2.38.0.
Какие задачи решает
- проверять оставшиеся фазы плана по расписанию
- добавлять запись в
progress.mdпри остановке - обновлять статус завершённой фазы в
task_plan.md - запускать следующий этап без ручного тика
- останавливать цикл после выполнения плана
Примеры запросов агенту
- Запусти
/plan-loop 10mи продолжай активный план по файламtask_plan.mdиprogress.md. - Запусти
/plan-loop 5mи проверяй оставшиеся фазы, а при остановке добавляй краткую запись вprogress.md. - Запусти
/plan-loop 10mвместе с/plan-goal, чтобы остановить цикл после завершения плана.
Как установить plan-loop
1Через маркетплейс плагинов
/plugin marketplace add OthmanAdi/planning-with-files/plugin install planning-with-files@planning-with-files2Вручную: положить файлы
.claude/commands/plan-loop.mdВызов — /plan-loop. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/plan-loop.mdВызов — /prompts:plan-loop. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/plan-loop.prompt.mdВручную: положить файлы
.gemini/commands/plan-loop.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о plan-loop
Как установить plan-loop в Claude Code?
Выполните /plugin marketplace add OthmanAdi/planning-with-files, затем /plugin install planning-with-files@planning-with-files. Файл команды находится по пути .claude/commands/plan-loop.md.
Что делает plan-loop?
Команда добавляет к /loop плановый контекст: перечитывает файлы плана, запускает проверку завершения и при необходимости записывает прогресс.
Что произойдёт без task_plan.md?
Команда откажется запускать цикл и направит вас сначала к /plan.
Исходный текст
plan-loop.md · MIT
---
description: "Run a planning-aware cadence with Claude Code's /loop. Default tick checks plan status, runs check-complete, nudges progress.md update if stalled. Available since v2.38.0."
disable-model-invocation: true
allowed-tools: "Read Bash"
---
Run a planning-aware cadence on top of Claude Code's `/loop` primitive.
Steps:
1. Parse args:
- First arg matching `^\d+[smhd]$` is the interval (default `10m`).
- Remaining args are an optional task prompt.
2. Resolve the active plan as in `/plan-attest`.
3. Compose the loop prompt:
- If user passed a task prompt: use it verbatim.
- Else: use the default planning tick prompt:
```
Read task_plan.md and progress.md. Run scripts/check-complete.sh to see remaining phases.
If no progress.md entry has been added since the last loop tick, write one summarizing the current state.
If a phase finished, update its Status: line in task_plan.md.
Continue the next phase if work remains.
```
4. Invoke `/loop <interval> <prompt>`.
5. Confirm to the user: print the interval, the active plan ID, and remind that bare `/loop` invocation alone (without args) runs Claude Code's built-in maintenance prompt — `/plan-loop` differs by always grounding the tick in the planning files.
If `task_plan.md` does not exist, refuse and direct user to run `/plan` first.
Why this exists:
`/loop` runs prompts on cron without any plan-state contract. `/plan-loop` injects a plan-aware default so the recurring tick always re-reads the planning files first, runs the completion check, and writes a progress entry. Users get "babysit my plan" UX without writing a custom loop prompt.
Notes:
- `/plan-loop` composes with `/loop`; it does not replace it. `/loop 5m "anything"` still works.
- For "babysit until plan is done" semantics: combine `/plan-loop 10m` (cadence) with `/plan-goal` (termination criterion). The loop runs every 10 minutes; the goal stops the loop when the plan is complete.
- The default tick prompt is intentionally short so it stays within compaction-safe length.
© OthmanAdi · MIT · OthmanAdi/planning-with-files