# plan-sync

Субагент plan-sync сверяет код закрытых задач со спецификациями и обновляет требования для оставшихся шагов. Субагент устраняет расхождения в именах, API и структурах данных.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 730 у репозитория
- Автор: Gordon Mickel
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/gmickel/flow-next/tree/HEAD/plugins/flow-next/agents/plan-sync.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/plan-sync

## Что делает

Субагент запускается автоматически диспетчером `flow-next-work` после каждой волны готовых задач. Напрямую через диалог его не вызывают: он получает список `COMPLETED_TASK_IDS`, идентификатор родительской спецификации `SPEC_ID` и путь к CLI-утилите `flowctl`.

Внутри агент работает только на чтение терминала: изучает метаданные через `flowctl cat`, `flowctl show` и `flowctl memory read`, а также сканирует реальный код в коммитах через `grep`. Инструменты `Write` и `Task` заблокированы конфигурацией. Все правки в последующие спецификации агент вносит исключительно через инструмент `Edit`, если не включён флаг `DRY_RUN`.

Помимо сигнатур функций и типов данных субагент отслеживает термины глоссария, проектные решения и общую стратегию. Без утилиты `flowctl` и окружения `flow-next` запустить этот сценарий синхронизации не получится.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add gmickel/flow-next
```
В чате агента (не в терминале):
```text
/plugin install flow-next@flow-next
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gmickel/flow-next/tree/HEAD/plugins/flow-next/agents/plan-sync.md

## Когда брать
- обновить спецификации будущих задач после изменений в закрытых тикетах
- найти расхождения между кодом в коммитах и исходным описанием API
- заменить устаревшие термины в задачах по правилам глоссария
- применить архитектурные решения из базы знаний к оставшимся спецификациям

## Примеры запросов агенту
- Запусти flow-next-work для завершённой волны задач спецификации fn-1
- Выполни flow-next-work с DRY_RUN=true для синхронизации оставшихся задач после fn-1.2
- Синхронизируй downstream-спецификации после реализации fn-1.2 и fn-1.3 через flow-next

## Похожие
- [tlc-plan](https://affpapa.org/nevibecode/skills/tlc-plan.md) — скилл · ★ 7191 у репозитория
- [10x-plan](https://affpapa.org/nevibecode/commands/10x-plan.md) — команда · ★ 267 у репозитория
- [interview-me](https://affpapa.org/nevibecode/skills/interview-me.md) — скилл · 73400 установок
- [openspec-propose](https://affpapa.org/nevibecode/skills/openspec-propose.md) — скилл · 4600 установок
- [openspec-archive-change](https://affpapa.org/nevibecode/skills/openspec-archive-change.md) — скилл · 4500 установок
- [om-auto-manage-issues](https://affpapa.org/nevibecode/skills/om-auto-manage-issues.md) — скилл · 4100 установок

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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