Выпуск 5 · вайбкодинг · агенты · откат · чекпоинты · git

Если нейросеть сломала проект: откат за одну команду

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

Главное в двух строках

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

Разница ровно одна — есть ли точка, к которой можно вернуться. Делать такую точку пять секунд, возврат к ней — одна команда.

Если всё сломалось прямо сейчас

Не читайте страницу с начала. Идите сразу в раздел «Сломалось. Что делать по шагам».

Сломалось. Что делать по шагам

1

Не паникуйте и не чините

Главная ошибка — начать просить агента «исправь ошибку» поверх сломанного. Так ломается ещё сильнее. Сначала вернуться, потом разбираться.

2

Не читайте текст ошибки

Вам он не нужен. Серьёзно: понимать, что именно развалилось, — работа, которую вы не обязаны делать.

3

Напишите агенту /rollback

Он не бросится ничего откатывать: сначала покажет список сохранённых состояний человеческими словами.

4

Согласитесь сохранить сломанное отдельно

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

5

Выберите последнюю точку, где всё работало

Не «на шаг назад», а именно ту, про которую вы помните, что проверяли её руками. Обновите браузер: приложение должно работать.

6

Поставьте чекпоинт и подумайте, нужна ли была эта задача

Половина поломок — от задач, которые не стоило начинать. Об этом ниже.

А если чекпоинтов нет

Тогда откатываться некуда, и это главный повод прочитать остальную страницу. Что делать сейчас: скопируйте всю папку проекта куда-нибудь в сторону (чтобы не стало хуже), потом попросите агента «найди, что перестало работать после последнего изменения, и верни только это». Получится дольше и не всегда. Первый же рабочий результат после этого — сразу /checkpoint.

Две команды, которые закрывают тему

Сохранить рабочее состояние

когда проверили руками и всё хорошо
/checkpoint настройки категорий

Вернуться назад

когда перестало работать
/rollback

Имя чекпоинта пишите человеческими словами и про смысл, а не про файлы: через неделю вы будете выбирать из списка по этим именам. «Бюджеты и умный ввод» — хорошо, «правки» — плохо.

Когда жать чекпоинт

Четыре момента. Больше ничего запоминать не нужно.

Когда функция заработала и вы её проверили

Не «кажется, готово», а проверили руками. Чекпоинт фиксирует хорошее, а не любое.

Перед запросом, который трогает хранилище данных

Всё, где есть слова «схема», «миграция», «перенести данные», «поменять формат».

Перед любым «обнови всё, что с этим связано»

Эта формулировка должна включать лампочку: вы только что разрешили агенту трогать что угодно.

Перед тем, как уйти от компьютера

Вернётесь и будете знать, где была последняя твёрдая земля.

Пять секунд. Спасает час, а иногда вечер и настроение.

Запросы, которые ломают

Невинный с виду запрос из выпуска. Так пишут все, и я тоже.

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

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

Слова-триггеры в вашем запросе

  • «обнови всё, что с этим связано»
  • «везде», «во всём проекте», «заодно»
  • «перепиши», «переделай по-нормальному»
  • «удали неиспользуемое»
  • «поменяй формат хранения»

Признаки в ответе агента

  • в плане больше десяти файлов
  • слова «миграция», «схема», «пересчитать старые данные»
  • он сам пишет «это рискованно»
  • задача оказалась больше, чем вы ожидали
  • трогается то, что вы не просили

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

Это не про нейросети. Живой разработчик, который правит четырнадцать файлов разом, ошибётся так же. Просто он потратит на это три дня, а не три минуты.

Как надо было

Тот же самый запрос, но по-человечески: сначала чекпоинт, потом план, и только потом решение — делать или не делать.

Безопасный заход на рискованную задачу подставьте свою задачу
/plan-feature

[ваша задача]

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

Ничего не меняй, пока я не подтвержу.

План сразу сказал то, чего я не знал: четырнадцать файлов, нужна миграция, старые данные придётся пересчитывать. И тут возник вопрос, которого не было в первый раз: а зачем мне вообще эти копейки? Приложение и так считает в копейках внутри и показывает рубли снаружи. Менять не нужно ничего.

Половина поломок — от задач, которые не нужно было начинать

План помогает это увидеть до того, как что-то сломается, а не после.

Что это такое: Git без Git

Под капотом чекпоинты и откат работают через Git — ту самую систему, которую мы молча поставили в первом выпуске. Для работы достаточно понимать три вещи.

РазУ проекта есть снимки сохранённые состояния, к каждому можно вернуться
ДваСнимок делается, когда работает проверили руками — сохранили. Не наоборот
ТриВернуться можно к любому не только на шаг назад, а на любое число шагов

Посмотреть список снимков своими глазами можно одной командой в терминале, в папке проекта. Это те самые имена, которые вы давали командой /checkpoint.

Показать список снимков

в терминале, в папке проекта
git log --oneline

Больше про Git знать не нужно, чтобы делать приложения. Захотите разобраться по-настоящему — будет отдельный ролик, он появится в разделе материалов к видео. Это не обязательная программа.

Тренировка: сломайте специально

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

1

Поставьте чекпоинт

/checkpoint перед тренировкой. Это ваша страховка на следующие пять минут.

2

Попросите что-нибудь заведомо рискованное

Например: «удали все неиспользуемые файлы и зависимости» или «переименуй все категории в базе на английский и обнови всё, что с этим связано».

3

Убедитесь, что сломалось

Откройте приложение. Если не сломалось — повезло, попросите что-нибудь ещё крупнее. Цель именно в поломке.

4

Откатитесь

/rollback, сломанное сохранить отдельно, выбрать точку «перед тренировкой». Обновить браузер.

Зачем это вообще

Страх ломает обучение сильнее, чем ошибки. Человек, который один раз откатился сам, перестаёт бояться и начинает пробовать. Один раз — и дальше спокойно.

Чек-лист выпуска

Отмечайте то, что сделали руками.

Функция выпуска: настройки категорий и экспорт

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

Настройки категорий, правила и экспорт вставить после /plan-feature
/plan-feature

Экран настроек:
- список категорий: переименование, выбор цвета, скрыть неиспользуемую;
- объединение двух категорий в одну, все операции переезжают, ничего не теряется;
- список правил «текст - категория», созданных при исправлениях,
  каждое можно удалить;
- кнопка «Выгрузить всё в CSV»: дата, сумма, категория, счёт, комментарий.

Не делать: импорт, вложенные категории, несколько пользователей.

Готово, когда я объединяю две категории и вижу, что сумма месяца не изменилась,
а операции переехали.

Проверка руками заняла минуту: переименовать «Прочее» в «Разное»; объединить «Рестораны» с «Кафе» и убедиться, что двенадцать операций переехали, а итог месяца не изменился; выгрузить файл и открыть его в таблице.

Ваши данные должны уметь уходить из приложения файлом

Любое приложение, которое так не умеет, — ловушка. Это касается и того, что вы делаете сами.

Если пошло не так

1

Агент говорит, что откатываться некуда

Значит, снимков нет. Скопируйте папку проекта в сторону и попросите: «сделай первый снимок текущего состояния». Дальше чекпоинты уже будут.

2

Откатился, но пропала работа, которую хотелось сохранить

Она не пропала, если вы согласились отложить изменения. Спросите: «где лежат отложенные изменения и как вернуть из них только [что именно]».

3

После отката приложение всё равно не работает

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

4

Команда /rollback не находится

Проверьте, что команды комплекта на месте: vibe skills, затем перезапустите агента. Если комплект старый — vibe update.

5

Страшно нажимать откат

Сделайте копию папки проекта рядом. Это грубо, зато понятно, и после первого успешного отката копировать перестанете.

Не помогло — напишите в Telegram, приложив имя последнего чекпоинта и то, что видите на экране.

Что дальше

В шестом выпуске обновляем Starter Kit, разбираем данные и пересобираем «Потрачено»: правила, четыре состояния экрана, общий набор элементов и вход по паролю. После этого можно перенести данные в PostgreSQL.

Откуда эти материалы

Страница к пятому выпуску серии «Vibe Coding с нуля». В нём я специально ломаю рабочее приложение одним невинным запросом, показываю настоящую ошибку на экране и возвращаю всё назад одной командой, а потом делаю ту же задачу правильно — и отказываюсь от неё, прочитав план.

Остальные выпуски: установка комплекта, первое приложение за 15 минут, как ставить задачу, из чего состоит приложение. Если нейросети для вас вообще впервые, есть бесплатная раздатка: как формулировать запросы и проверять ответы. По шагам это разбирается в курсе «ИИ для чайников», остальные курсы на витрине.

Пройти курс