Как исправлять ошибки в проекте, который писал ИИ

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

В такой момент новичок обычно делает худшее из возможного: пишет новому агенту «почини всё». Иногда это срабатывает. Чаще — создаёт ещё один слой хаоса.

Ниже — рабочий порядок действий, который помогает искать и исправлять ошибки без паники.

Сначала не чините — сначала воспроизведите

Прежде чем просить агент что-то менять, убедитесь, что вы можете повторить ошибку.

Нужно понять:

где она возникает;
после какого действия;
всегда или иногда;
что вы ожидали увидеть;
что увидели вместо этого.

Пример хорошего описания:

На мобильной странице курса после отправки формы появляется зелёный статус, но не открывается блок оплаты. На десктопе всё работает.

Это гораздо полезнее, чем просто «не работает форма».

Соберите три вида фактов

1. Что видит пользователь

Сообщение об ошибке, белый экран, пропавшая кнопка, неправильный текст, сломанный блок.

2. Что поменялось недавно

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

3. Где проходит путь данных

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

поле формы;
JavaScript;
API;
база;
ответ на экране.

Даже простая цепочка уже сильно сужает поиск.

Как ставить задачу агенту на исправление ошибки

Плохой запрос:

Исправь баг.

Хороший запрос:

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

Здесь агент понимает, что ему не надо «переделывать форму целиком». Он ищет точку поломки.

Рабочий алгоритм поиска ошибки

Шаг 1. Найти симптом

Сначала фиксируете именно то, что видно снаружи.

Шаг 2. Найти участок кода, который отвечает за симптом

Если не открывается блок оплаты, смотрите:

форму;
обработчик submit;
код, который показывает скрытый блок;
разметку payment-секции.

Шаг 3. Проверить последнюю правку

Иногда ошибка — не в сложной логике, а в маленькой детали: неверный селектор, переименование класса, конфликт mobile-стилей.

Шаг 4. Вносить один фикс за раз

Если вы меняете и CSS, и HTML, и JS одновременно, вы почти всегда теряете точную причину.

Шаг 5. После фикса сразу перепроверять

Не откладывайте проверку на потом. Иначе следующая ошибка смешается с предыдущей.

Что особенно важно в проектах, которые писал ИИ

ИИ часто делает код, который:

выглядит правдоподобно;
работает в одном сценарии;
ломается на краях;
слабо объясняет свои скрытые допущения.

Поэтому при отладке важно искать не только «где упало», но и «на каком предположении всё держалось».

Примеры таких предположений:

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

Очень часто настоящая ошибка живёт именно в таком молчаливом допущении.

Когда надо остановиться и упростить

Есть хороший признак, что вы пошли не туда:

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

В этот момент лучше откатиться на шаг назад, сузить задачу и отдельно проверить основу.

Шаблон сообщения для исправления багов

Скопируйте и используйте:

Симптом: [что видит пользователь].

Где воспроизводится: [десктоп / мобильная версия / конкретная страница].

Что ожидалось: [ожидаемое поведение].

Что произошло: [фактическое поведение].

Последняя связанная правка: [что меняли недавно].

Ограничение: [что нельзя ломать при исправлении].

Порядок: сначала найди причину, потом предложи минимальный фикс.

Этот шаблон спасает намного чаще, чем очередная попытка «просто попросить умнее».

Вывод

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

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

Где следить дальше

Быстрые разборы, новые инструменты и свежие наблюдения я публикую в Telegram: t.me/il_chum

Источники

https://code.claude.com/docs/en/common-workflows
https://openai.com/business/guides-and-resources/how-openai-uses-codex/