Чек-лист
кодовое словоКэш

Задача нейросети без переделок

Содержание7 глав
  1. 0101. Перед тем как нажать Enter
  2. 0202. Сложная задача: сначала план
  3. 0303. Пока работа идёт
  4. 0404. Что остаётся за тобой
  5. 0505. Замена фраз
  6. 0606. Цифры, ради которых это всё
  7. 0707. Где посмотреть подробности

Модель останавливается там, где работа выглядит законченной. Не там, где она готова. Разница между этими двумя точками и есть всё время, которое ты потом тратишь на переделки. Ниже — то, что закрывает разницу.

01. Перед тем как нажать Enter

01
Назови критерий готовности.
Тест, который должен пройти. Сборка, которая должна собраться. Скриншот, с которым надо сравнить. Всё, что даёт машинный ответ «да» или «нет»
02
Скажи, что модель должна показать в конце.
Вывод теста, команду и её результат, скриншот. Читать доказательство быстрее, чем перепроверять руками
03
Укажи файлы и сценарий, а не тему.
Не «добавь тесты», а «напиши тест для такого-то файла на случай, когда пользователь разлогинен, без моков»
04
Покажи образец из своего проекта.
«Посмотри, как это сделано вот здесь, и повтори тем же способом» экономит два круга правок
05
Опиши симптом, а не диагноз.
«Вход перестаёт работать после истечения сессии, смотри обновление токена» вместо «почини баг со входом»

02. Сложная задача: сначала план

01
Раздели исследование и исполнение.
Режим планирования: модель читает код и предлагает план, но не правит исходники, пока ты план не утвердил
02
План нужен не всегда.
Если правку можно описать одним предложением — план только съедает время. Он окупается, когда меняется несколько файлов или код тебе незнаком
03
Дай себя расспросить.
На большой фиче попроси модель задать вопросы по реализации, краям и компромиссам, а ответы сложить в отдельный файл со спецификацией. Дальше — чистая сессия по этому файлу

03. Пока работа идёт

01
Правило двух правок.
Поправил дважды одно и то же и не помогло — не поправляй третий раз. Контекст уже забит неудачными попытками: чисти его и переписывай задачу с учётом того, что понял
02
Останавливай сразу, а не в конце.
Заметил, что идёт не туда — прерывай на этом же шаге. Короткая петля обратной связи дешевле любого разбора готового результата
03
Чисти контекст между несвязанными задачами.
Одна сессия — одна тема. Чужие файлы и старые логи в контексте роняют качество ответов
04
Исследование — отдельным подагентом.
Поиск по репозиторию читает десятки файлов. Пусть это происходит в отдельном контексте, а к тебе вернётся только вывод

04. Что остаётся за тобой

01
Архитектура и выбор подхода.
Модель хорошо исполняет и плохо угадывает намерение. Развилку выбираешь ты, кодит она
02
Постоянные правила — в файл проекта.
То, что ты объясняешь второй раз, переезжает в файл с инструкциями проекта: команды сборки, соглашения, подводные камни. Коротко и конкретно, ориентир — до двухсот строк
03
Проверка чужими глазами.
Ревью делает отдельная сессия или подагент: тот, кто писал код, — плохой рецензент собственного кода
04
Решение о выкате.
Если результат нечем проверить — он не едет дальше. Это правило без исключений

05. Замена фраз

«Делай как считаешь нужным»«Делай вариант с проверкой на сервере. Если увидишь причину сделать иначе — сначала скажи»
«Сделай нормально»«Готово = тесты зелёные и сборка проходит. Покажи вывод»
«Почини баг»«Воспроизведи падающим тестом, потом чини. Причину, а не симптом»
«Улучши этот экран»«Сравни со скриншотом, выпиши отличия списком, потом исправь»
«Разберись с проектом»«Прочитай такую-то папку и объясни, как устроен вход и где хранятся секреты»
слева — вместо этого, справа — скажи так

06. Цифры, ради которых это всё

Рандомизированный замер: 16 опытных разработчиков, 246 реальных задач в репозиториях, с которыми они работали в среднем по пять лет. С AI-инструментами задачи заняли на 19% больше времени — при том что до старта участники ждали ускорения на 24%, а после эксперимента оценивали, что стали примерно на 20% быстрее. Полный отчёт

66% разработчиков называют главной болью решения, которые «почти правильные, но не совсем»; 45% говорят, что отладка сгенерированного кода занимает больше времени. При этом инструментами пользуются или собираются 84%, а точности вывода сильно доверяют 3%. Данные опроса

07. Где посмотреть подробности

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

Держи под рукой первую неделю. Дальше это становится привычкой и лист не нужен.