Главное в двух строках
Сломает. Обязательно и не один раз. Вопрос не в том, случится ли это, а в том, сколько это будет стоить: три минуты или вечер.
Разница ровно одна — есть ли точка, к которой можно вернуться. Делать такую точку пять секунд, возврат к ней — одна команда.
Не читайте страницу с начала. Идите сразу в раздел «Сломалось. Что делать по шагам».
Сломалось. Что делать по шагам
Не паникуйте и не чините
Главная ошибка — начать просить агента «исправь ошибку» поверх сломанного. Так ломается ещё сильнее. Сначала вернуться, потом разбираться.
Не читайте текст ошибки
Вам он не нужен. Серьёзно: понимать, что именно развалилось, — работа, которую вы не обязаны делать.
Напишите агенту /rollback
Он не бросится ничего откатывать: сначала покажет список сохранённых состояний человеческими словами.
Согласитесь сохранить сломанное отдельно
Агент спросит, отложить ли текущие изменения на всякий случай. Соглашайтесь: даже в сломанном состоянии могла быть одна полезная строчка.
Выберите последнюю точку, где всё работало
Не «на шаг назад», а именно ту, про которую вы помните, что проверяли её руками. Обновите браузер: приложение должно работать.
Поставьте чекпоинт и подумайте, нужна ли была эта задача
Половина поломок — от задач, которые не стоило начинать. Об этом ниже.
Тогда откатываться некуда, и это главный повод прочитать остальную страницу.
Что делать сейчас: скопируйте всю папку проекта куда-нибудь в сторону (чтобы
не стало хуже), потом попросите агента «найди, что перестало работать после
последнего изменения, и верни только это». Получится дольше и не всегда. Первый же
рабочий результат после этого — сразу /checkpoint.
Две команды, которые закрывают тему
Сохранить рабочее состояние
когда проверили руками и всё хорошо/checkpoint настройки категорий
Вернуться назад
когда перестало работать/rollback
Имя чекпоинта пишите человеческими словами и про смысл, а не про файлы: через неделю вы будете выбирать из списка по этим именам. «Бюджеты и умный ввод» — хорошо, «правки» — плохо.
Когда жать чекпоинт
Четыре момента. Больше ничего запоминать не нужно.
Когда функция заработала и вы её проверили
Не «кажется, готово», а проверили руками. Чекпоинт фиксирует хорошее, а не любое.Перед запросом, который трогает хранилище данных
Всё, где есть слова «схема», «миграция», «перенести данные», «поменять формат».Перед любым «обнови всё, что с этим связано»
Эта формулировка должна включать лампочку: вы только что разрешили агенту трогать что угодно.Перед тем, как уйти от компьютера
Вернётесь и будете знать, где была последняя твёрдая земля.Пять секунд. Спасает час, а иногда вечер и настроение.
Запросы, которые ломают
Невинный с виду запрос из выпуска. Так пишут все, и я тоже.
Так делать не надо пример опасного запроса
Перепиши хранение операций, чтобы суммы были в рублях с копейками, и обнови всё, что с этим связано.
Агент тронул четырнадцать файлов: схему хранилища, миграцию базы, расчёт бюджета, экран обзора, импорт. Приложение перестало открываться, а суммы там, где они были видны, стали в сто раз больше.
Слова-триггеры в вашем запросе
- «обнови всё, что с этим связано»
- «везде», «во всём проекте», «заодно»
- «перепиши», «переделай по-нормальному»
- «удали неиспользуемое»
- «поменяй формат хранения»
Признаки в ответе агента
- в плане больше десяти файлов
- слова «миграция», «схема», «пересчитать старые данные»
- он сам пишет «это рискованно»
- задача оказалась больше, чем вы ожидали
- трогается то, что вы не просили
Чем больше файлов трогает один запрос, тем выше шанс, что что-то развалится
Это не про нейросети. Живой разработчик, который правит четырнадцать файлов разом, ошибётся так же. Просто он потратит на это три дня, а не три минуты.Как надо было
Тот же самый запрос, но по-человечески: сначала чекпоинт, потом план, и только потом решение — делать или не делать.
Безопасный заход на рискованную задачу подставьте свою задачу
/plan-feature [ваша задача] Отдельно скажи: - сколько файлов будет затронуто; - нужна ли миграция базы и что станет со старыми данными; - что перестанет работать, если план выполнить неудачно; - можно ли сделать то же самое меньшими изменениями. Ничего не меняй, пока я не подтвержу.
План сразу сказал то, чего я не знал: четырнадцать файлов, нужна миграция, старые данные придётся пересчитывать. И тут возник вопрос, которого не было в первый раз: а зачем мне вообще эти копейки? Приложение и так считает в копейках внутри и показывает рубли снаружи. Менять не нужно ничего.
Половина поломок — от задач, которые не нужно было начинать
План помогает это увидеть до того, как что-то сломается, а не после.Что это такое: Git без Git
Под капотом чекпоинты и откат работают через Git — ту самую систему, которую мы молча поставили в первом выпуске. Для работы достаточно понимать три вещи.
Посмотреть список снимков своими глазами можно одной командой в терминале, в папке
проекта. Это те самые имена, которые вы давали командой /checkpoint.
Показать список снимков
в терминале, в папке проектаgit log --oneline
Больше про Git знать не нужно, чтобы делать приложения. Захотите разобраться по-настоящему — будет отдельный ролик, он появится в разделе материалов к видео. Это не обязательная программа.
Тренировка: сломайте специально
Самое полезное упражнение серии, и оно стоит ноль. Пока это тренировка, вы ничего не теряете. Когда сломается по-настоящему, руки уже будут знать, что делать.
Поставьте чекпоинт
/checkpoint перед тренировкой. Это ваша страховка на следующие
пять минут.
Попросите что-нибудь заведомо рискованное
Например: «удали все неиспользуемые файлы и зависимости» или «переименуй все категории в базе на английский и обнови всё, что с этим связано».
Убедитесь, что сломалось
Откройте приложение. Если не сломалось — повезло, попросите что-нибудь ещё крупнее. Цель именно в поломке.
Откатитесь
/rollback, сломанное сохранить отдельно, выбрать точку «перед
тренировкой». Обновить браузер.
Страх ломает обучение сильнее, чем ошибки. Человек, который один раз откатился сам, перестаёт бояться и начинает пробовать. Один раз — и дальше спокойно.
Чек-лист выпуска
Отмечайте то, что сделали руками.
Функция выпуска: настройки категорий и экспорт
До поломки мы сделали обычную функцию по схеме из третьего выпуска. Текст постановки целиком, если повторяете приложение.
Настройки категорий, правила и экспорт вставить после /plan-feature
/plan-feature Экран настроек: - список категорий: переименование, выбор цвета, скрыть неиспользуемую; - объединение двух категорий в одну, все операции переезжают, ничего не теряется; - список правил «текст - категория», созданных при исправлениях, каждое можно удалить; - кнопка «Выгрузить всё в CSV»: дата, сумма, категория, счёт, комментарий. Не делать: импорт, вложенные категории, несколько пользователей. Готово, когда я объединяю две категории и вижу, что сумма месяца не изменилась, а операции переехали.
Проверка руками заняла минуту: переименовать «Прочее» в «Разное»; объединить «Рестораны» с «Кафе» и убедиться, что двенадцать операций переехали, а итог месяца не изменился; выгрузить файл и открыть его в таблице.
Ваши данные должны уметь уходить из приложения файлом
Любое приложение, которое так не умеет, — ловушка. Это касается и того, что вы делаете сами.Если пошло не так
Агент говорит, что откатываться некуда
Значит, снимков нет. Скопируйте папку проекта в сторону и попросите: «сделай первый снимок текущего состояния». Дальше чекпоинты уже будут.
Откатился, но пропала работа, которую хотелось сохранить
Она не пропала, если вы согласились отложить изменения. Спросите: «где лежат отложенные изменения и как вернуть из них только [что именно]».
После отката приложение всё равно не работает
Чаще всего дело в базе: откат вернул код, но не данные. Попросите агента «приведи базу в соответствие с текущим кодом» и объясните, что данные можно пересоздать из тестовых.
Команда /rollback не находится
Проверьте, что команды комплекта на месте: vibe skills,
затем перезапустите агента. Если комплект старый — vibe update.
Страшно нажимать откат
Сделайте копию папки проекта рядом. Это грубо, зато понятно, и после первого успешного отката копировать перестанете.
Не помогло — напишите в Telegram, приложив имя последнего чекпоинта и то, что видите на экране.
Что дальше
В шестом выпуске обновляем Starter Kit, разбираем данные и пересобираем «Потрачено»: правила, четыре состояния экрана, общий набор элементов и вход по паролю. После этого можно перенести данные в PostgreSQL.
Откуда эти материалы
Страница к пятому выпуску серии «Vibe Coding с нуля». В нём я специально ломаю рабочее приложение одним невинным запросом, показываю настоящую ошибку на экране и возвращаю всё назад одной командой, а потом делаю ту же задачу правильно — и отказываюсь от неё, прочитав план.
Остальные выпуски: установка комплекта, первое приложение за 15 минут, как ставить задачу, из чего состоит приложение. Если нейросети для вас вообще впервые, есть бесплатная раздатка: как формулировать запросы и проверять ответы. По шагам это разбирается в курсе «ИИ для чайников», остальные курсы на витрине.