Режимы Plan и Build: сначала план, потом правки

Два основных агента

В OpenCode несколько агентов, и два из них вы будете переключать постоянно:

• Build — рабочий агент. Создаёт и правит файлы, запускает команды. С ним вы работали в прошлом уроке.
• Plan — агент для обдумывания. Читает проект, задаёт уточняющие вопросы и предлагает план, но файлы проекта не меняет.

Переключаются они клавишей Tab. Под полем сообщения видно имя текущего агента: build или plan.

Зачем сначала план

Когда задача простая — поменять цвет кнопки, — план не нужен. Но если задача затрагивает несколько мест, агент в режиме Build сразу начнёт писать код, и о его решениях вы узнаете уже по готовым правкам. Иногда они разумные, а иногда агент:

• понял задачу шире, чем вы хотели, и переделал полпроекта;
• выбрал сложное решение там, где хватило бы простого;
• не учёл то, о чём вы забыли сказать.

План показывает эти решения заранее. Прочитать пять строк плана быстрее, чем разбираться в сотне строк кода и откатывать их.

Как работать с планом

Переключитесь в Plan и опишите задачу:

Хочу добавить возможность создавать свои привычки
и удалять ненужные. Предложи план.

Агент изучит index.html и ответит примерно так:

План:
1. Добавить над списком поле ввода и кнопку «Добавить».
2. Хранить список привычек в localStorage вместе с отметками.
3. Рядом с каждой привычкой — кнопка удаления с подтверждением.
4. При удалении убирать и отметки этой привычки.
5. Не давать добавить пустую привычку или дубликат.

Теперь прочитайте план и задайте себе вопросы: всё ли здесь нужно? Не забыто ли что-то важное? Например, вам не нужно подтверждение при удалении — скажите об этом прямо в режиме Plan:

Подтверждение при удалении не нужно. Остальное подходит.

Когда план устраивает, нажмите Tab, переключитесь в Build и напишите:

Выполни план.

Большие задачи — по шагам

Если в плане больше пяти-шести пунктов, не выполняйте его целиком за раз. Попросите агента сделать первый шаг, проверьте результат, потом следующий:

Сделай только шаги 1 и 2. Остальное пока не трогай.

Так ошибку проще поймать: если сломалось, то в последнем маленьком шаге, а не где-то среди десяти правок. И откатить один шаг проще, чем всё сразу.