goal-planner — субагент для Claude Code: что делает и как установить
Субагент goal-planner для Claude Code раскладывает сложную цель на действия с предусловиями и эффектами, ищет маршрут через A* и пересобирает план после сбоя.
лицензия не указана ★ 850 обновлён 2026-10-26
.claude/agents/goal-planner.mdЧто делает goal-planner
goal-planner — субагент для Claude с планировщиком GOAP. Ему описывают текущее состояние и желаемое, а он собирает цепочку действий: у каждого шага свои предусловия, эффекты и цена. Маршрут ищется алгоритмом A*, поэтому из нескольких вариантов выбирается самый дешёвый по сумме шагов, а не первый подходящий.
Режимы различаются охватом: выполнить одно конкретное действие, спланировать внутри одного набора действий или свободно искать по всем доступным, дробя крупную цель на подцели. После запуска план не застывает: результат сверяется с ожидаемым состоянием по петле OODA, и при расхождении маршрут пересчитывается. Отдельные шаги можно отдавать коду, модели или смеси того и другого, а в описании действия указать группы инструментов вроде grep или профайлера с запасным вариантом, если их нет.
Вся работа держится на предусловиях, которые реально проверить, и эффектах, которые видно в состоянии. Расплывчатое описание действий даёт план из догадок. Файл субагента кладут в .claude/agents/goal-planner.md.
Какие задачи решает
- разложить цель вроде «сделать приложение готовым к продакшену» на конкретные шаги
- проверить, какие предусловия мешают запустить деплой
- пересобрать план после падения одного из шагов
- выбрать самый дешёвый маршрут, когда к цели ведут несколько цепочек
- привязать каждое действие к нужным инструментам и запасному варианту
Примеры запросов агенту
- Используй субагента goal-planner: составь план деплоя приложения со всеми зависимостями.
- Позови goal-planner и разбей цель «привести легаси-модуль к продакшену» на шаги с проверками.
- Пусть goal-planner перестроит план, если прогон тестов упал.
Как установить goal-planner
Вручную: положить файлы
.claude/agents/goal-planner.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/goal-planner.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/goal-planner.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о goal-planner
Как установить goal-planner в Claude Code?
Скопируйте файл субагента в .claude/agents/goal-planner.md внутри проекта.
Что делает goal-planner?
Строит план от целевого состояния: взвешивает действия по предусловиям, эффектам и цене, затем ищет самую дешёвую последовательность через A*.
Что нужно, чтобы планы получались рабочими?
Описывать действия так, чтобы предусловия можно было проверить, а эффекты отражались в состоянии. Поиск опирается именно на них.