Агент Planner — от требования к плану реализации
Как агент Planner в Datarim превращает размытое требование в структурированный план с разбивкой по компонентам, стратегией отката и конкретным чеклистом проверки.
В описании задачи написано «добавить экспорт в CSV». В этой фразе нет ни дизайна, ни пути отката, ни критерия завершённости. Агент Planner берёт эту фразу и превращает её во что-то, что разработчик — человек или ИИ — может реально выполнить.
Planner — это ведущий менеджер проекта в пайплайне. Он запускается на /dr-init, чтобы зарегистрировать задачу в бэклоге, и снова на /dr-plan, чтобы написать план реализации. Для этого используется самая мощная модель в наборе: неточность в плане накапливается на каждом последующем шаге.
Что он делает
Каждой задаче присваивается уровень сложности — от L1 до L4 — который определяет, сколько проектной работы выполняется до начала реализации. Небольшой баг-фикс — это L1, он сразу уходит в код. Новый сервис с публичным API — это L4, и сначала проводится полная фаза дизайна.
Для задач L3 и L4 Planner создаёт подробный дизайн из трёх частей: разбивка по компонентам (что строится и как части соединяются), определение интерфейса (как выглядит граница кода снаружи) и описание потоков данных. На основе дизайна формируется план с конкретными шагами реализации, примерами кода, стратегией отката через git или команды миграции и чеклистом проверки — не «протестируй», а «выполни эту команду и убедись в этом выводе».
Один конкретный пример
Приходит задача: добавить систему доставки вебхуков к существующему API. Planner оценивает её как L3. Он читает текущую кодовую базу, обнаруживает, что воркер очереди уже существует, и составляет разбивку по компонентам из трёх частей — продюсер очереди в существующем обработчике запросов, новый воркер-процесс для доставки и таблица повторных попыток в базе данных. В плане реализации указана команда миграции для создания этой таблицы, точная сигнатура функции продюсера и команда для проверки сквозной доставки. Если что-то сломается в процессе деплоя — стратегия отката сводится к одной команде миграции, удаляющей таблицу.
Где он в процессе
Planner запускается первым в пайплайне — до написания кода. На /dr-init он регистрирует задачу и устанавливает уровень сложности. На /dr-plan создаёт документ плана, который читают все последующие агенты. Для сложных задач дизайн Planner передаётся агенту Strategist, который оценивает, правильный ли выбран подход, прежде чем начнётся реализация.
Полное описание — на карточке агента Planner, а общую картину даёт пост что такое Datarim.