ФАЗА 22. AI-АГЕНТЫ Продуктивная сессия

Базовый цикл работы с кодовым агентом

Goal · Slice · Verify · Commit

Задача идёт маленькими проверяемыми шагами, а рабочее дерево остаётся понятным для отката.

1. Сессия начинается с чистого состояния

1 / 5

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

  • git status понятен до начала.
  • Тесты исходного состояния известны.
  • Несвязанные файлы не трогаются.
Clean treeknown baselineeasy rollbackOne goalSmall changeeasy review

2. Цель содержит критерий результата

2 / 5

Контекст отвечает, что менять и зачем, а критерий позволяет проверить завершение. Ограничения называются до кода.

  • Нужное поведение описано примером.
  • Тест или наблюдение доступны.
  • Запреты и границы явные.
Goaluser outcomeContextfiles + constraintsDone whentest + observable result

3. Вертикальный срез даёт рабочий результат

3 / 5

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

  • Сначала минимальный сценарий.
  • Каждый шаг оставляет запуск возможным.
  • Следующий срез добавляется после проверки.
API contractUse caseAdapter + storageVerified user behavior

4. Проверка идёт после каждого шага

4 / 5

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

  • Красный тест воспроизводит требование.
  • Зелёный подтверждает реализацию.
  • Итог проверяется на самом diff.
RedImplementGreenFull suite

5. Маленький коммит сохраняет понятную историю

5 / 5

Diff читается перед сохранением, временные файлы удаляются, сообщение описывает результат. Следующая задача начинается с новой целью.

  • Секреты и логи не попадают в коммит.
  • Сообщение отвечает что изменилось.
  • Длинная сессия не продолжается из привычки.
Review diffClean tempCommitNew goal

Работа с агентами: базовый цикл продуктивной сессии

Кодовый агент (Claude Code, Cursor, Copilot и подобные) — это агент, заточенный под работу с вашим проектом: он читает файлы, пишет код, запускает тесты, ходит по репозиторию. Разница между теми, у кого он ускоряет работу в разы, и теми, у кого он «пишет ерунду», — не в модели, а в том, как с ним работают. Это навык, и у него есть базовый цикл.

цель и контекст маленький шаг проверка закрепление следующий шаг

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

Дать контекст и цель, а не приказ

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

  • Цель — что должно получиться и как понять, что готово. «Добавь эндпоинт отмены заказа; после него статус в базе — cancelled, тест проходит».
  • Контекст — какие файлы, правила, ограничения относятся к задаче. Не «весь проект», а релевантное.
  • Границы — что не трогать, каким стилем писать, какие подходы запрещены.

Чем яснее вход, тем лучше выход. Это прямое следствие того, как устроены модели: расплывчатый запрос → расплывчатый результат.

Работать итерациями, а не одним махом

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

  1. Разбейте задачу на куски, каждый из которых можно проверить (собрать, запустить тест).
  2. Сделайте один кусок → проверьте → закрепите → следующий.
  3. Если пошло не туда — откатитесь на последний хороший шаг, а не чините снежный ком.

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

Держать шаги проверяемыми

Агент силён, когда у него есть objective-критерий: тест, компиляция, запуск. Дайте ему то, обо что он сам проверится, — тесты, которые должны пройти, команду сборки, ожидаемый результат. Тогда агент видит свою ошибку и правит сам, а вы получаете результат, про который уже что-то известно.

Без проверяемого критерия агент «думает, что готово», а на деле — правдоподобно, но неверно.

Не отпускать контроль

Агент — усилитель, а не замена суждения. Вы остаётесь тем, кто:

  • читает диф, а не принимает его вслепую — особенно на стыках, в крайних случаях, в удалениях;
  • решает архитектурные развилки сам, а не спрашивает «как лучше?» у модели, которая ответит правдоподобно;
  • проверяет результат (приёмка выхода ИИ) прежде, чем он идёт в дело.

Скорость от агента реальна, но она превращается в долги, если принимать всё не глядя.

Коротко

  • Агент работает ровно с тем, что у него в контексте: сессия начинается с цели с критерием готовности, релевантных файлов и границ, а не с короткой команды.
  • Крупная задача одним ходом даёт результат, который проще выкинуть; рабочий шаг это кусок, который можно собрать и проверить, закрепить и только потом идти дальше.
  • Пошло не туда: откат на последний хороший шаг, а не починка снежного кома; ошибки агента накапливаются с длиной бесконтрольной серии.
  • Проверяемый критерий (тест, сборка, запуск) агент прогоняет сам и правит свои ошибки; без него «готово» значит «правдоподобно».
  • Диф читает человек: стыки, крайние случаи, удаления; архитектурные развилки решает сам, а не спрашивает у модели.
  • Скорость от агента настоящая, но принятое не глядя превращается в долг.

Что почитать дальше