Агент редактирует не тот модуль: какой контекст дать
Дайте агенту путь от пользовательского действия до нужного обработчика, а не весь репозиторий сразу. Сначала попросите подтвердить найденную точку изменения на конкретных файлах и вызовах.
Где появляется ошибка
В монорепозитории есть старый кабинет администратора и новый клиентский интерфейс. Кнопка «Скачать отчёт» встречается в обоих местах. Агент находит первое совпадение по тексту и исправляет заброшенный компонент. Сборка проходит, но пользователь продолжает видеть ошибку. Проблема не в длине промпта: отсутствует связь между нужным экраном, маршрутом и реально используемым компонентом.
Рабочее решение
Приложите URL экрана, название пакета, пример входных данных и текущий симптом. Попросите проследить обработчик клика до запроса и сервиса; находки должны содержать пути. Полезно отдельно указать, что каталог legacy сохраняется для истории. После карты исполнения разрешайте изменение. Если маршрутизация генерируется, проверяйте собранную конфигурацию, а не только совпадения строк. Поисковые гипотезы агент может менять, но итоговая точка вмешательства требует доказательства.
Контрольные случаи
| Проверка | Ожидаемое поведение |
|---|---|
| Нажать кнопку на нужном маршруте | В сетевом журнале виден именно тот запрос, который анализировал агент. |
| Открыть похожую кнопку старого кабинета | Её поведение не изменилось случайно; использование старого модуля подтверждено отдельно. |
| Удалить предположение о названии файла | Карта исполнения всё ещё объясняет, как данные проходят через реальные зависимости. |
Для сгенерированных маршрутов сохраните пример итогового адреса и способ его получения. Объяснение «похожий компонент находится рядом» недостаточно: проверяющий должен суметь повторить путь от экрана до изменённого обработчика.
Путь из стека ошибки тоже может указывать на общий компонент, а не источник неверных данных. Контекст должен включать вызывающую сторону и условия, при которых проблема проявляется.
Работа с контекстом особенно важна, когда AI встраивается в существующую кодовую базу, а не создаёт демонстрацию с нуля. В платном курсе Vibecoding: Claude Code, Codex, Cursor и agentic development можно продолжить изучение соответствующего инженерного направления. Перед покупкой сравните программу и открытые материалы со своей задачей.
Документация для проверки технических деталей: Практики Claude Code.
Следующий шаг: AI-разработка: разборы ошибок, изменений и проверки кода. По смежным вопросам: Как дать AI-агенту плавающий баг, который не воспроизводится, AI-агент меняет слишком много файлов: как сузить diff.
