Как удержать ИИ-кодинг-агента в нужном русле: сначала исследуй, потом планируй, затем строй

Когда люди впервые пробуют агентный кодинг-инструмент вроде Claude Code или Cursor, они обычно набирают однострочный запрос и надеются. Иногда это срабатывает. Часто агент уверенно строит не то — решая проблему, о которой вы не спрашивали, трогая файлы, которых вы не ожидали, или пропуская граничный случай, который как раз и был важен.

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

Почему прыжок сразу в код проваливается

ИИ-агент работает внутри ограниченного контекстного окна — текущей записи вашего диалога плюс каждого файла, который он читает, и каждой команды, которую запускает. Две вещи идут не так, когда вы пропускаете планирование:

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

Отделение мышления от действия отлавливает неверное допущение, пока его ещё дёшево исправить — предложением правки вместо отката 12 файлов.

Шаг 1. Исследуйте в режиме только для чтения

У большинства серьёзных агентов теперь есть режим, в котором они могут читать и анализировать, но ничего не могут менять. В Claude Code это называется plan mode: состояние только для чтения, где агент читает файлы и отвечает на вопросы, не редактируя, не запуская команды, меняющие состояние, и не делая коммитов.

Начните с просьбы понять код, а не менять его:

Read /src/auth and explain how we handle sessions and login.
Also look at how we manage environment variables for secrets.

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

Шаг 2. Попросите план, затем надавите на него

Когда агент исследовал, попросите конкретный план до любого кода:

I want to add Google OAuth login. What files need to change?
What's the session flow? Write a step-by-step plan — don't write code yet.

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

• «Что произойдёт, если OAuth-callback упадёт на полпути?»
• «У нас уже есть хелпер refreshToken в src/auth/tokens.ts — переиспользуй его, а не пиши новый».
• «Ограничься только потоком входа. Не трогай существующий код сброса пароля».

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

Шаг 3. Стройте со способом проверки

Только теперь вы даёте агенту писать код — и даёте ему способ проверить собственную работу. Самое мощное единственное дополнение к любому промпту — шаг верификации, который агент может запустить сам:

Implement the OAuth flow from your plan. Write a test for the callback
handler covering the failure case, run the test suite, and fix any failures.

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

Шаг 4. Знайте, когда пропустить план

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

Страховочная сетка: корректируйте курс рано и используйте чекпойнты

Даже с хорошим планом агенты сбиваются. Две привычки удерживают вас у руля:

• Прерывайте в момент, когда он сходит с пути. Не ждите, пока агент завершит неверный подход. В Claude Code Esc останавливает его в середине действия с сохранением контекста, чтобы вы могли перенаправить.
• Используйте чекпойнты, чтобы экспериментировать свободно. Claude Code делает снимок ваших файлов перед каждым изменением, так что вы можете сказать агенту попробовать что-то рискованное, и если не выйдет — откатиться (Esc Esc или /rewind) и попробовать другой подход. (Чекпойнты отслеживают собственные правки агента, а не внешние процессы — это удобство, а не замена git.)

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

Вывод

Исследуй, планируй, строй, проверяй. Для первой задачи это кажется медленнее и окупается уже ко второй. Вы перестаёте получать уверенно-неверный код и начинаете получать агента, который строит именно то, что вы имели в виду.