# goal-planner

Субагент goal-planner для Claude Code раскладывает сложную цель на действия с предусловиями и эффектами, ищет маршрут через A* и пересобирает план после сбоя.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 850 у репозитория
- Автор: ruvnet
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/goal/goal-planner.md
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/goal-planner

## Что делает

goal-planner — субагент для Claude с планировщиком GOAP. Ему описывают текущее состояние и желаемое, а он собирает цепочку действий: у каждого шага свои предусловия, эффекты и цена. Маршрут ищется алгоритмом A*, поэтому из нескольких вариантов выбирается самый дешёвый по сумме шагов, а не первый подходящий.

Режимы различаются охватом: выполнить одно конкретное действие, спланировать внутри одного набора действий или свободно искать по всем доступным, дробя крупную цель на подцели. После запуска план не застывает: результат сверяется с ожидаемым состоянием по петле OODA, и при расхождении маршрут пересчитывается. Отдельные шаги можно отдавать коду, модели или смеси того и другого, а в описании действия указать группы инструментов вроде `grep` или профайлера с запасным вариантом, если их нет.

Вся работа держится на предусловиях, которые реально проверить, и эффектах, которые видно в состоянии. Расплывчатое описание действий даёт план из догадок. Файл субагента кладут в `.claude/agents/goal-planner.md`.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/goal-planner.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/goal-planner.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/goal-planner.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/goal/goal-planner.md

## Когда брать
- разложить цель вроде «сделать приложение готовым к продакшену» на конкретные шаги
- проверить, какие предусловия мешают запустить деплой
- пересобрать план после падения одного из шагов
- выбрать самый дешёвый маршрут, когда к цели ведут несколько цепочек
- привязать каждое действие к нужным инструментам и запасному варианту

## Примеры запросов агенту
- Используй субагента goal-planner: составь план деплоя приложения со всеми зависимостями.
- Позови goal-planner и разбей цель «привести легаси-модуль к продакшену» на шаги с проверками.
- Пусть goal-planner перестроит план, если прогон тестов упал.

## Похожие
- [goal-plan](https://affpapa.org/nevibecode/skills/goal-plan.md) — скилл · 771 установка
- [financial-goal-planner](https://affpapa.org/nevibecode/skills/financial-goal-planner.md) — скилл · 373 установки
- [plannotator-setup-goal](https://affpapa.org/nevibecode/skills/plannotator-setup-goal.md) — скилл · 13600 установок
- [plan-goal](https://affpapa.org/nevibecode/commands/plan-goal.md) — команда · ★ 28179 у репозитория
- [goal-setting-okrs](https://affpapa.org/nevibecode/skills/goal-setting-okrs.md) — скилл · 538 установок
- [swarm-planner](https://affpapa.org/nevibecode/skills/swarm-planner.md) — скилл · 1200 установок

Из того же набора: [ruvnet/agentic-flow](https://affpapa.org/nevibecode/by/ruvnet/agentic-flow.md) — 76 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
