Plan Mode
Отдельный режим агента WorkAI, который сначала исследует код и строит пошаговый план, и только потом — с явного разрешения — переходит к правкам файлов.
Planning (Plan Mode) — отдельный режим композера чата, наравне с Build, Agent и Ask. В нём агент не редактирует файлы и не выполняет команды: он изучает кодовую базу и формулирует пошаговый план, который вы просматриваете и при необходимости правите, прежде чем отдавать его на реализацию.
Как включить
Выберите «Планирование» в выпадающем списке режимов в поле ввода чата — там же, где переключаетесь между Build, Agent и Ask. Отдельного хоткея для переключения в этот режим в текущей версии WorkAI нет — режим выбирается через пикер.
Почему это "жёсткий" режим
В отличие от обычного Agent, где модель просто обычно не трогает файлы без вашего согласия, в Plan Mode инструменты редактирования и выполнения физически не передаются модели — это не просьба «пожалуйста, не редактируй», а исключение инструментов из набора, который видит модель. Недоступны, в частности:
- редактирование, создание, удаление, перемещение файлов;
- запуск терминала и любых команд;
- операции git с побочными эффектами (commit, push, branch, merge, rebase и т.п.);
- выполнение ячеек/файлов ноутбука, запуск задач и тестов.
Доступны при этом инструменты, которые не трогают ваш проект: поиск по коду, чтение файлов, работа с памятью агента, список задач (todo) самого плана и уточняющие вопросы.
Как строится план
- Агент по необходимости задаёт уточняющие вопросы, если формулировка задачи неполная.
- Исследует релевантные части кодовой базы через поиск и чтение файлов.
- Формирует план в виде карточки: заголовок, краткое описание и список шагов.
Готовый план отображается не сырым markdown, а структурированной карточкой — заголовок, описание, список шагов с индикаторами статуса (не начат / выполняется / готово) и панель действий снизу.
Что можно сделать с планом
На карточке плана доступны:
- Open plan («Open plan») — открывает полный текст плана отдельной вкладкой редактора с подсветкой markdown. Файл можно редактировать прямо там: правки, сделанные снаружи чата, подхватываются и попадают в план. Если план поменялся одновременно и из чата, и во внешнем редакторе, побеждает версия из чата.
- Implement («Implement») — передаёт план на реализацию агенту с полным набором инструментов (редактирование, терминал и т.д.). У кнопки есть клавиатурный акселератор ⌘⏎ / Ctrl+⏎, который срабатывает, пока фокус на карточке.
- Выбор модели для этапа реализации — тот же пикер модели, что и в обычном чате.
- Delegate на каждом отдельном шаге — открывает новую агентскую сессию, сфокусированную только на этом шаге, если хотите поручить его отдельно, не запуская реализацию всего плана целиком.
Пока агент реализует план, карточка показывает прогресс по шагам («Implementing k/N»), а по завершении — статус «Done». Если план поменялся уже после того, как реализация началась, карточка отмечает его как обновлённый — это сигнал, что стоит запустить Implement заново, чтобы применить изменения.
Где хранится план
План автоматически сохраняется в файл в вашем воркспейсе (в скрытой служебной папке проекта) и доступен по ссылке прямо на карточке — по клику открывается исходный файл плана. Если в окне не открыта папка проекта, план всё равно сохраняется, но во внутреннем хранилище агента, а не в файловой системе проекта.
Когда использовать
Plan Mode имеет смысл, когда:
- задача затрагивает много файлов или систем и легко упустить что-то важное, если сразу довериться автоматическим правкам;
- есть несколько разумных способов реализации и вы хотите сверить подход до того, как агент начнёт писать код;
- формулировка задачи расплывчата и сначала нужно понять масштаб, прежде чем на что-то соглашаться.
Для быстрых и рутинных изменений можно сразу работать в обычном Agent — не каждая задача требует отдельного плана.
Если результат не устроил
Если реализация плана пошла не туда, зачастую быстрее не донастраивать её через новые реплики в чате, а отменить изменения, уточнить сам план и запустить Implement заново — так проще держать контроль над тем, что именно должно измениться, чем добиваться этого точечными правками уже написанного кода.
Дальше
Общий обзор режимов чата и то, что скрывается за «Auto», — на странице Model Router.