Как разделить большой запрос на понятные шаги

Вы просите Claude: "Добавь список локалей, поиск, фильтр по стране и обнови оформление". Агент меняет несколько файлов, сообщает о готовности, и на первый взгляд страница выглядит хорошо. Но после ввода запроса нужная запись исчезает. Вы очищаете поле - запись не возвращается.

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

Чтобы не распутывать несколько изменений сразу, разделите запрос на небольшие проверяемые шаги. Сначала получите список и сверьте записи. Затем добавьте поиск и проверьте его на этом списке. После этого переходите к фильтру, а смену оформления оставьте отдельным шагом. Ошибки всё ещё возможны, зато у вас будет проверенное исходное состояние и понятный круг последних изменений. Разберём, как выбрать такие шаги и задать их агенту.

Слева собраны изменения, сделанные за один проход. Справа виден общий симптом, который ещё не указывает на конкретную причину. Если проверять части по очереди, будет проще сопоставить появление ошибки с последней правкой.

Выберите ближайший результат

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

Если список уже работает, делать его заново не нужно. Начните с ближайшего отсутствующего поведения. А если непонятно, работает ли он, сначала откройте страницу и посмотрите. Точка старта зависит от состояния проекта, а не от красивого плана.

Фраза "сначала напиши HTML, потом JavaScript" тоже делит работу, но не всегда помогает проверять результат. Для работающего поиска могут одновременно понадобиться поле ввода в HTML и обработчик в JavaScript. Это один понятный шаг, хотя файлов два.

Разделите просьбу по поведению

В учебном справочнике четыре записи. Код локали, язык и страна указаны ниже; эти данные будем использовать для проверки.

Теперь у каждого шага можно назвать результат и действие для проверки:

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

Назовите границы шага

Допустим, список готов. Попросите Claude добавить поиск и явно назовите то, что сейчас должно сохраниться. В примере данные и поведение страницы находятся в app.js, разметка в index.html. В своём проекте подставьте реальные пути.

Прочитай @index.html и @app.js.
Список из четырёх локалей уже работает.
Добавь поле поиска по коду локали или названию языка.

Исходные записи, их поля и оформление сохрани.
Можно добавить элементы, необходимые для поиска.
Фильтр по стране пока не делай.

Проверка: German и de-DE находят de-DE;
zzz не находит записей; пустой запрос возвращает все четыре.

Сначала объясни, что будешь менять. Файлы пока не меняй.

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

Не всякое дополнительное действие лишнее. Поле ввода необходимо для поиска. Полная смена цветов - уже отдельное пожелание. Удобный вопрос: без этой правки выбранный результат получится?

Если непонятно, с чего начать

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

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

Результат такого шага - найденные файлы и объяснение их роли. Сверьте ответ с указанными фрагментами. Число "два-три" здесь ориентир для начала, а не запрет читать необходимый код.

Проверьте перед следующим шагом

Сообщение "поиск готов" ещё не говорит, что именно проверили. Откройте страницу и выполните примеры из запроса: совпадение, отсутствие совпадений, очистку поля. Заодно убедитесь, что сохранились исходные записи и их поля.

Если после очистки видны только три строки, оставайтесь на поиске. Сообщите агенту действие, ожидаемый и фактический результат: "Очистил поле. Ожидал четыре записи, вижу три". Добавление фильтра сейчас усложнит поиск причины.

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

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

В связке с Claude Code

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

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