Исправить ошибку в проекте и доказать, что она решена

Что это

Ты собираешь сайт, бота или сервис с ИИ-агентом, и что-то сломалось: кнопка не работает, форма не отправляется, бот молчит. Пишешь «почини» — агент что-то меняет, говорит «готово», а через час ломается соседнее. Или он прячет ошибку, чтобы она просто не показывалась.

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

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

Как использовать

1. Опиши симптом словами: что делаешь, что видишь, что ожидал. Приложи текст ошибки или скриншот.
2. Самое ценное поле — «Как воспроизвести». Шаги, после которых ошибка появляется всегда.
3. Перед запуском сохрани текущую версию проекта (коммит в git или копия папки) — чтобы можно было откатиться. 12 модов Claude Code для вайбкодера (490 ₽) добавят корзину вместо удаления и проверку работы агента.
4. Прочитай план исправления до того, как агент начнёт менять код. Если план — «перепишу всё», останови.
5. После отчёта сам пройди шаги воспроизведения и убедись, что ошибки нет.

Что написать агенту вместо «почини»

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

Почини форму, не работает.

Открываю страницу контактов, заполняю имя и телефон, жму «Отправить». Жду надпись «Заявка принята», а кнопка сереет и ничего не происходит. В консоли браузера ошибка 422. Вчера работало, потом мы добавили поле «Комментарий».

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

Больше всего времени обычно экономит последняя фраза, про то, что меняли накануне. Если не помнишь, попроси агента посмотреть историю изменений в git за последние дни.

Что дальше

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

Если собираешь продукт с агентом с нуля, система Первый экран ведёт по шагам от идеи до работающего экрана и учит возвращать ИИ в рамки, когда он делает не то, — 990 ₽.