Сравните два запроса. «Добавь ретраи в клиент» оставляет агенту выбор реализации, даже если рядом уже есть подходящая. «В internal/client/http.go добавь ретраи для GET по образцу internal/queue/retry.go, только для 502/503/504 и таймаутов, максимум три попытки всего; конфиг не расширяй» задаёт файл, образец и ограничения. Повтор неидемпотентной операции после таймаута требует отдельного контракта: сервер мог выполнить её до обрыва связи.

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

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

Все блоки text ниже — примеры запросов, не исполняемые программы и не обещание результата. Пути и стек условные; подставляйте реальные файлы и проверки своего проекта.

Что говорят данные

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

Первое — препринт 2025 года на данных DevGPT. Авторы по ключевым словам размечали семь паттернов в диалогах, связанных с закрытыми PR и issue; после фильтрации осталось 3 515 PR и 5 261 issue. Их effectiveness score складывается из длины ответа, отношения числа токенов ответа к запросу и тональности текста. Это не проверка качества кода, а закрытый issue не обязательно означает, что решение принято.

В таблице V среднее число запросов для Recipe равно 7,07 против 8,02 для Question в выборке PR. Значение 11,16 для Question относится к другой выборке, issue; сравнивать его с 7,07 как результат одного эксперимента нельзя. Указанная в работе статистическая значимость относится к различиям effectiveness score, а не доказывает причинного сокращения числа запросов или времени работы.

Второе — работа EASE 2025, тоже использующая DevGPT, но с другой фильтрацией и разметкой. Авторы исследовали zero-shot, few-shot, chain-of-thought, personas и их сочетания. SonarQube не выявил статистически значимых различий по числу замечаний сопровождаемости, надёжности и безопасности. Файлы, не прошедшие компиляцию или анализ, исключались; функциональную корректность этой проверкой не измеряли.

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

Паттерн 1. Контекст, потом инструкция

Сначала задайте контекст: где менять код, на каком стеке, что уже есть и что нельзя ломать. Затем укажите конкретное действие.

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

Было:

Почини баг с логином

Стало:

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

Второй запрос уточняет, где искать, что считать багом, с чего начать и как проверить готовность.

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

Паттерн 2. Критерий, который агент проверит сам

Без проверки агент может остановиться на внешне правдоподобном результате. В запросе нужно задать, чем подтвердить готовность.

Укажите тесты, сборку, линтер, сравнение вывода с эталоном или проверку скриншота по макету. Тогда у агента будет обратная связь: внести изменение, запустить проверку, прочитать результат и исправить найденное.

Было:

Напиши функцию валидации email

Стало:

Напиши validateEmail. Примеры: user@example.com — true,
invalid — false, user@.com — false.
После реализации прогони тесты и покажи вывод.

Три примера не определяют все допустимые адреса: уточните требования продукта, например поддержку Unicode, пробелов и пустого ввода. Синтаксическая проверка не подтверждает существование почтового ящика. Запрашивайте вывод проверки вместе с патчем; это не отменяет независимой приёмки.

Когда не нужно: если автоматической проверки нет, задайте ручной способ приёмки. Результат без критерия нельзя принять только по ответу модели.

Паттерн 3. Опора на существующий код

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

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

Было:

Добавь виджет календаря

Стало:

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

Постоянную часть таких указаний — где лежит общий код, какие библиотеки под запретом, что нельзя трогать — незачем повторять в каждом промпте. Она выносится в файл правил проекта: AGENTS.md, CLAUDE.md или .cursor/rules. Промпт тогда занимается только текущей задачей.

Паттерн 4. Разведка, план, потом код

До реализации проверьте, ту ли задачу описывает запрос. Ошибку в требованиях дешевле исправить в плане, чем в готовом патче.

Для задачи с неизвестной реализацией используйте цикл: разведка, план, реализация, проверка. Сначала модель читает код и отвечает на вопросы без изменений. Затем составляет план, который можно проверить до правок по файлам. Коммит — отдельное действие по правилам проекта, а не обязательная часть любого запроса.

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

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

Паттерн 5. Рецепт вместо цели

В выборке PR исследования DevGPT у Recipe было меньше запросов, чем у Question; переносить это на скорость любой задачи нельзя. Рецепт уместен, когда вы уже знаете и проверили последовательность шагов, а модели остаётся её исполнить.

Было:

Перенеси проект на новую версию линтера

Стало:

1. Для перехода с ESLint 8.x на 9.x сначала проверь совместимость Node.js,
   плагинов и общего конфига с целевой версией; при конфликте остановись.
2. Обнови ESLint до выбранной версии 9.x и перенеси настройки в flat config,
   сохрани правила и исключения; после переноса удали старый .eslintrc.
3. Прогони линтер, выпиши категории ошибок, не правя их.
4. Останови работу и покажи список.

Последний шаг задаёт контрольную точку перед массовыми правками. Сначала разработчик проверяет категории ошибок, затем решает, какие изменения разрешить. Это пример миграции 8.x → 9.x, а не команда обновиться на самую новую версию; фактические версии пакетов нужно выбрать по совместимости.

Когда не нужно: если шагов вы не знаете. Тогда сначала паттерн 4 — пусть шаги предложит модель, а вы их отредактируете.

Паттерн 6. Ограничитель

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

Рабочая формулировка ограничителя состоит из четырёх запретов:

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

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

Как это собирается в один запрос

В одном запросе можно соединить контекст, задачу, образец, границы и проверку:

Пример предполагает, что в проекте уже есть API фоновых заданий, хранение их статусов и результатов. Если их нет, ограничения на схему и API нужно пересмотреть до реализации.

[контекст] Сервис на Go, Fiber + GORM. Экспорт отчётов лежит в
internal/service/report.go, сейчас выполняется только синхронно.

[задача] Добавь фоновый экспорт через существующий API заданий со статусом по job id.

[образец] Очередь уже есть — internal/queue, посмотри, как в ней сделан
воркер импорта, и сделай так же.

[границы] Схему БД не трогай, новых зависимостей не добавляй.
Синхронную ручку сохрани без изменений; используй существующий контракт API заданий.

[проверка] Напиши тест на два случая: успех и падение воркера с ретраем.
Прогони go test ./internal/... и покажи вывод.

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

Чего паттерны не чинят

  • Качество кода. В EASE 2025 не нашли значимой разницы по выбранным метрикам SonarQube. Это не доказывает, что паттерны никогда не влияют на качество, и не заменяет проверку поведения.
  • Перегруженный контекст. При повторных неудачах соберите требования и проверенные ограничения в новый запрос. Не переносите длинную переписку без разбора.
  • Незнание проекта. Чтобы сослаться на образец, его нужно найти и проверить на соответствие задаче.
  • Неверную задачу. Подробный запрос не подтверждает, что функция нужна пользователю. Это нужно решить до реализации.

С чего начать на этой неделе

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

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

Примеры применения — в разборе вайбкодинга на практике, критерии выбора инструмента — в сравнении Cursor, Claude Code и Windsurf. На встречу сообщества можно принести промпт, получившийся дифф и критерии проверки: ближайшие темы.