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

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

Команда plan-goal собирает условие завершения из task_plan.md и подставляет его в /goal, чтобы агент не остановился на середине плана.

MIT ★ 28 179 обновлён 2026-11-04

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

Что делает plan-goal

Команда читает task_plan.md, выводит из него условие завершения и передаёт текст в /goal. Дальше Claude Code гоняет агента, пока быстрая модель не подтвердит условие по транскрипту. Файлы при этой проверке не читаются, поэтому условие и берут из плана: цикл встаёт, когда закрыт план, а не когда переписка выглядит законченной.

Сначала ищется активный план: sh ${CLAUDE_PLUGIN_ROOT}/scripts/resolve-plan-dir.sh, в PowerShell resolve-plan-dir.ps1. Несколько планов без селектора дают PWF_PLAN_AMBIGUOUS_V1 и отказ: команда не хватает первый попавшийся файл, придётся задать PLAN_ID=<slug>. Переменная PWF_PLAN_ROOT фиксирует корень проекта, неверный корень не принимается.

Аргумент дописывается к условию отдельной фразой. В текст попадают только заголовки фаз и критерии приёмки, так что в лимит /goal на 4000 знаков это укладывается. Без task_plan.md команда откажется и отправит сначала выполнить /plan. Снять цель потом можно через /goal clear.

Какие задачи решает

  • дотянуть агента до последней фазы плана без ручных подталкиваний
  • превратить чек-лист фаз в условие остановки, которое можно проверить
  • запустить длинную задачу и уйти по своим делам
  • закрыть цикл по готовому плану, а не по бодрому тону переписки

Примеры запросов агенту

  • /plan-goal
  • /plan-goal до тех пор, пока все тесты не пройдут
  • /plan-goal до конца плана, меня не спрашивай

Как установить plan-goal

1Через маркетплейс плагинов

/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files

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

.claude/commands/plan-goal.md

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

Вопросы о plan-goal

Как установить plan-goal в Claude Code?

Добавьте маркетплейс: /plugin marketplace add OthmanAdi/planning-with-files, потом поставьте плагин: /plugin install planning-with-files@planning-with-files. Файл самой команды лежит в .claude/commands/plan-goal.md.

Что делает plan-goal?

Превращает task_plan.md в условие завершения для /goal: фазы со статусом complete плюс проверку через check-complete.sh. После этого агент работает, пока условие не подтвердится.

Что будет, если в проекте несколько планов?

Скрипт выбора печатает PWF_PLAN_AMBIGUOUS_V1, и команда отказывается работать. Нужно указать PLAN_ID=<slug> и вызвать её снова.

Исходный текст

plan-goal.md · MIT
---
description: "Bridge Claude Code's /goal to the active plan. Derives a goal condition from task_plan.md and invokes /goal so Claude keeps working until the plan is complete. Available since v2.38.0."
disable-model-invocation: true
allowed-tools: "Read Bash"
---

Bridge the active plan to Claude Code's `/goal` primitive.

Steps:

1. Validate `${PWF_PLAN_ROOT}` as an absolute existing project root when set; refuse an invalid root pin. Otherwise use cwd as the project root. Resolve the selected plan with `sh ${CLAUDE_PLUGIN_ROOT}/scripts/resolve-plan-dir.sh` (PowerShell: `& "$env:CLAUDE_PLUGIN_ROOT\scripts\resolve-plan-dir.ps1"`). A printed directory is the selected plan. On empty output:
   - With non-empty `${PLAN_ID}`, the plan selector was rejected. Refuse and ask the user to correct the pin; never fall back to another plan.
   - If `resolve-plan-dir.sh --check-ambiguity` (PowerShell: `-CheckAmbiguity`) prints `PWF_PLAN_AMBIGUOUS_V1`, multiple plans exist without a selector. Refuse and ask the user to set `PLAN_ID=<slug>`.
   - Otherwise use legacy `task_plan.md` from the validated project root (`PWF_PLAN_ROOT` when set), if it exists. A valid root pin alone does not reject a legacy root plan.
   The shared `.planning/.active_plan` pointer does not bind a parallel session.
2. Read the selected `task_plan.md` and retain its absolute path for the goal condition and completion check.
3. Derive a goal condition from the plan content:
   - Default: "all phases in the selected task_plan.md report Status: complete and check-complete.sh with that explicit plan path reports ALL PHASES COMPLETE"
   - If user passed an argument: use that as an additional clause (e.g., `/plan-goal until all tests pass`)
4. Issue Claude Code's `/goal <condition>` with the derived text.
5. Confirm to the user: print the goal condition + the active plan ID + remind that `/goal clear` cancels.

If `task_plan.md` does not exist, refuse and direct user to run `/plan` first.

Why this exists:

`/goal` runs the agent until a small fast model confirms the condition is met. It evaluates the transcript only, not files. By deriving the condition from the plan file, this command turns the file-based plan into a measurable termination criterion for `/goal`, so the loop terminates when the plan is actually done, not when the conversation looks done.

Notes:

- `/plan-goal` does not replace `/goal`. It composes with it. Users can still run `/goal "any text"` directly.
- The derived condition stays under the 4000-char limit `/goal` enforces by quoting only phase headers + acceptance criteria, not full task body.
- Combine with `/plan-loop` for a "babysit until done" workflow: `/plan-loop` cadence + `/plan-goal` termination.

© OthmanAdi · MIT · OthmanAdi/planning-with-files

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

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
goal-plan ruvnet Скилл goal-plan создаёт пошаговые планы для сложных задач, анализирует, какие условия должны быть выполнены перед каждым шагом, оценивает затраты и переходит на новый маршрут, если что-то пошло не так. CX Codex +1 771установок plan disler Команда plan для Claude Code превращает описание задачи в пошаговый план реализации и сохраняет его в specs/. Помогает продумать фичу до начала кодинга. CX Codex +1 ★ 3 990звёзд репо qiaomu-goal-meta-skill joeseesun Скилл qiaomu-goal-meta-skill превращает расплывчатую задачу в готовую команду /goal для Codex: с критериями проверки, границами записи и условиями остановки. CX Codex +1 857установок copilot-goal-skill Gaetan Semet Плагин copilot-goal-skill ставит задачу в цикл: один субагент делает, второй проверяет результат по свежему контексту, пока не выполнит цель. ★ 18звёзд репо task_plan nwverse Субагент task_plan для Claude Code формирует и передаёт пользователю план независимых задач для запуска агентов на компьютерах. Запускается при постановке работы, требующей агента или больше нескольких вызовов инструментов. CX Codex ★ 395звёзд репо build disler Команда build для Claude Code читает файл с планом и вносит его в код проекта. Реализует готовый план и выводит раздел ## Report из него. CX Codex +1 ★ 3 990звёзд репо

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

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

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

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