Агент сломал то, что работало: как откатиться назад

Коротко

Почему у агента нет кнопки «отменить»?

Первое, что удивляет непрограммиста: агент не показывает черновик, а сразу делает. Он создаёт файлы, переписывает существующие, устанавливает нужные ему компоненты, запускает проект.

В текстовом редакторе есть отмена последнего действия, потому что изменения живут в памяти программы. Тут изменения живут на диске, и их может быть тридцать за одну задачу.

Отсюда правило, которое я даю на первых занятиях: страховка ставится до работы, а не после аварии. Это не занудство, а разница между «потерял двадцать минут» и «потерял два дня».

Сама авария при этом не редкость и не признак плохого агента. Он перебирает варианты, и часть из них оказывается хуже предыдущего.

Три типовые аварии, которые я вижу чаще всего:

• Улучшил и сломал. Просьба «сделай красивее» превращается в переписанную страницу, где заодно отвалилась работавшая форма.
• Обновил зависимости. Агент поставил свежую версию какого-то компонента, и проект перестал запускаться целиком. Внешне это выглядит как «вчера работало, сегодня нет», хотя ты ничего не менял в своей части.
• Спрятал ошибку вместо починки. Сообщение об ошибке исчезло с экрана, потому что агент убрал проверку, а не причину. Самый неприятный случай: выглядит как успех, всплывает через неделю на живых пользователях.

Точка сохранения простыми словами

Аналогия с игрой работает лучше всего. Ты проходишь сложный уровень, сохраняешься перед боссом, и если что-то пошло не так, загружаешься.

Разница только в том, что сохранёнка в проекте называется по-другому и хранит не позицию персонажа, а состояние всех файлов сразу: код, тексты, настройки, структуру папок.

Термин лишним не будет, если ты собираешься читать документацию: этот снимок называют коммитом, а всю систему таких снимков - контролем версий. Другие слова из этой области я собрал в словаре вайбкодинга.

Когда фиксировать состояние?

На занятиях этот вопрос звучит почти дословно так: «мы фиксируем каждый раз, когда я на сегодня задачу закончила, но проект-то не закончен?» Отвечаю: да, именно так. Фиксация не означает готовность продукта, она означает «сюда можно вернуться».

1. В начале работы

   Проект в известном состоянии, всё работает. Первая точка - опора для всего сеанса.

2. Перед рискованной правкой

   Меняешь структуру, ставишь новую библиотеку, переделываешь то, что уже работает. Сначала снимок.

3. После каждого рабочего результата

   Заработала функция - зафиксируй. Не жди, пока накопится «достойный объём».

4. В конце сеанса

   Даже если задача не доделана. Незаконченное состояние тоже стоит сохранить, иначе назавтра начнёшь с непонятного.

Один нюанс, который стоит проговорить агенту сразу: фиксируем осознанно, а не всё подряд. Иногда в снимок попадают временные файлы, выгрузки с данными или файл с паролями, и они остаются в истории надолго. Проси показать список того, что войдёт в снимок, если работаешь с чувствительными материалами.

Как откатиться, если сломалось?

Порядок действий:

1. Остановись. Не проси «почини» в панике: каждая новая правка усложняет возврат.
2. Спроси, что изменилось. «Покажи списком, что поменялось с последней зафиксированной точки, коротко и по-русски».
3. Реши, что откатывать. Иногда достаточно одного файла, иногда нужен весь проект.
4. Попроси вернуть. «Верни проект к последней точке сохранения, ничего не дописывая».
5. Проверь руками. Открой, нажми, пройди сценарий. Отсутствие ошибок на экране агента ещё не значит, что всё работает: как это принимать, разбирал в материале про приёмку работы агента.
6. Зафиксируй заново и только потом продолжай.

Чего откат не спасёт?

Это место, где люди обжигаются второй раз, уже освоив фиксацию.

База данных. Снимок проекта не хранит содержимое базы. Если агент почистил таблицу, откат кода её не вернёт. На одном из разборов участник сформулировал это точно: данные можно случайно стереть, поэтому нужна база с резервной копией. Копию базы делают отдельно и по расписанию.

Файлы вне проекта. Документы на рабочем столе, выгрузки, чужие папки. Если агенту дали доступ шире, чем к проекту, страховка тоже нужна шире.

Внешние действия. Отправленное письмо, опубликованный пост, платёж, запись в чужой системе. Их не отменить откатом. Единственная защита - подтверждение перед выполнением.

Про то, где вообще проходит граница между «поиграться» и «работает на живых данных», подробно писал в материале про деплой прототипа и персональные данные.

Три привычки, чтобы не доводить до отката

Первая привычка - план до действий. «Сначала опиши, что собираешься менять, потом делай». Половина неудачных правок отваливается уже на этом шаге, когда ты видишь, что агент понял задачу не так.

Вторая - одна правка за раз. Соблазн попросить пять улучшений одной фразой велик, но когда что-то ломается, ты не знаешь, какое из пяти виновато. С одной правкой причина очевидна.

Третья - не соглашаться вслепую. Режим, в котором ИИ-агент делает всё без подтверждений, экономит время и увеличивает цену ошибки. Держать его включённым разумно на песочнице и опасно на проекте с живыми данными.

Четвёртая, менее очевидная: не наводить порядок в папке проекта руками. Как это ломает работу агента и что делать вместо, разбирал в материале про гигиену рабочей папки.

Частые вопросы

Главный вывод

Правило, которое дешевле всего выучить заранее: работа с агентом безопасна ровно настолько, насколько ты подготовил возврат.

Практический минимум выглядит так: снимок в начале сеанса, снимок после каждого рабочего результата, план до рискованных правок и отдельная копия данных. Четыре привычки, каждая из которых стоит секунды.

Сегодня же спроси агента, когда в твоём проекте была последняя точка сохранения. Если ответ «её нет», ты только что нашёл главный риск ближайшей недели.