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

plan-loop — команда для Claude Code: планирование и установка

Команда plan-loop для Claude Code запускает регулярные проверки через /loop и отслеживает файлы плана. Автоматизирует работу по фазам без ручного контроля.

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-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-files

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

.claude/commands/plan-loop.md

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

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

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

Каталог слэш-команд →
ds-plan-loop aicodeking Скилл ds-plan-loop для Claude Code составляет план с проверкой каждого шага, пересматривает его и выполняет задачу поэтапно. Запускается для работы с несколькими файлами, неясным объёмом или после пропущенных шагов. CX Codex +1 569установок review-loop 2dmurali Скилл review-loop запускает цикл «работа — критика — правка»: отдельный субагент оценивает результат по шкале 1–10 и возвращает замечания, пока не наберётся нужный балл. CX Codex +1 114 900установок stitch-loop официальный google-labs-code Скилл stitch-loop организует автономную сборку страниц через Stitch MCP. Агент берёт задачу из файла-эстафеты, создаёт экран, переносит код в проект и сразу пишет задание для следующей итерации. CX Codex +1 58 200установок next-dev-loop vercel Скилл next-dev-loop проверяет, что правка в Next.js реально работает в запущенном приложении, а не только компилируется. Нужен при разработке через next dev. CX Codex +1 26 700установок langgraph-human-in-the-loop langchain-ai Скилл langgraph-human-in-the-loop для Claude Code и других платформ: строит графы LangGraph с паузами, ждущими человеческого ввода, одобрения или валидации. CX Codex +1 18 300установок verification-loop affaan-m Скилл verification-loop проводит код через сборку, проверки типов, линтер, тесты, поиск секретов и просмотр diff. Запускайте его после изменений или перед созданием PR. CX Codex +1 7 200установок

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

Весь набор →
status Команда status показывает текущую фазу проекта, процент готовности и ошибки из task_plan.md. Команда запускается для быстрой проверки прогресса без перечитывания всех рабочих файлов. CX Codex +1 ★ 28 179звёзд репо plan-doctor Команда plan-doctor проверяет, не молчат ли хуки planning-with-files: находится ли план, срабатывает ли инжект, в каком состоянии аттестация. Запускайте, когда хуки притихли. 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звёзд репо planning-with-files Скилл planning-with-files держит план многошаговой задачи в трёх markdown-файлах и возвращает к ним агента каждый ход — контекст не разваливается на длинной сессии. CX Codex +1 ★ 28 179звёзд репо planning-with-files Скилл planning-with-files сохраняет план задач, ход работы и находки в markdown-файлах проекта. Выручает в длинных задачах от пяти вызовов инструментов, защищая контекст от стирания. CX Codex +1 ★ 28 179звёзд репо planning-with-files Скилл planning-with-files для Claude Code и Codex, который сохраняет план, находки и журнал сессии в файлы на диске. При следующем запуске агент читает task_plan.md, findings.md и progress.md и продолжает с того места, где остановился. CX Codex +1 ★ 28 179звёзд репо planning-with-files Плагин planning-with-files хранит план задачи в task_plan.md, findings.md и progress.md на диске, чтобы агент продолжил работу после /clear, сжатия контекста или сбоя. CX Codex ★ 28 179звёзд репо

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

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