Отладка бага с ИИ-агентом: сначала причина, потом патч

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

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

Что получишь

• Точные шаги воспроизведения — без них любое «исправил» нельзя проверить.
• Таблицу гипотез: причина, эксперимент, результат, подтверждена или нет.
• Минимальное исправление с объяснением, почему правка убирает причину.
• Проверку на регрессию: тест или ручные шаги, которые ловят этот баг, и список соседних мест, которые проверили.

Если логи у тебя в беспорядке, сначала приведи их в вид, понятный агенту, по гайду Из хаотичных логов в баг-репорты для AI-разработчика. Как доказать, что ошибка решена до конца, подробно разобрано в Исправить ошибку в проекте и доказать, что она решена.

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

1. 1Опиши баг тремя частями

   Что делаешь, что ожидаешь, что происходит вместо этого. Текст ошибки вставь целиком.

2. 2Запусти промпт в агенте

   Claude Code или Cursor в папке проекта. В чате тоже работает, но код придётся вставлять самому.

3. 3Веди по шагам

   После каждого шага агент останавливается. Читай отчёт и пиши «дальше» или поправляй.

4. 4Проверь сам

   Пройди шаги воспроизведения руками. Баг не повторяется, соседнее работает — тогда принимай.

Как сохранить: в конце агент выдаёт debug.md. Попроси его записать файл в docs/bugs/[короткое-название].md или скопируй сам. Когда похожий баг вернётся, дай агенту этот файл первым сообщением.

Рядом по теме: AGENTS.md: одни правила для всех ИИ-агентов проекта, Скилл Claude Code для безопасного рефакторинга, CLAUDE.md для любого проекта, статья «Как сделать Telegram-бота с ИИ» и 7 типов ИИ-агентов: шпаргалка (бесплатно).

Что дальше

• Как тестировать код, который написал агент — чтобы такие баги ловились до выкладки.
• Агент ушёл не туда: стоп-кран и честный аудит — если агент всё равно начал править наугад.