Рабочий цикл с coding-агентом

Суть

Хороший сеанс строится вокруг проверяемого результата: задача → контекст → изменение → независимая проверка → фиксация. Название продукта меняет команды, но не этот контур.

Перед стартом

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

Мелкая локальная правка не требует церемонии. Чем шире последствия, тем явнее должны быть эти пять пунктов.

Цикл

  1. Ориентация. Проверить рабочую папку, инструкции, состояние git и связанные файлы.
  2. Понимание. Кратко сформулировать цель, ограничения и неизвестные.
  3. Изменение. Делать небольшими логическими блоками, сохраняя чужую незавершённую работу.
  4. Проверка. Просмотреть diff, выполнить релевантные tests/lint/build и негативный сценарий.
  5. Сверка с целью. Тесты могут пройти, а задача остаться нерешённой.
  6. Фиксация. Commit, краткая документация и только затем разрешённые внешние действия.

Что автоматизировать

  • повторяемые build/test/lint-команды — в scripts и CI;
  • устойчивые правила проекта — в AGENTS.md, CLAUDE.md или аналоге;
  • повторяемую процедуру с ресурсами — в skill;
  • подключение внешней системы — через ограниченный tool или MCP;
  • одноразовый контекст задачи — в сообщении, issue или плане, а не в постоянной инструкции.

Review результата

  • staged diff содержит только нужные файлы;
  • новая зависимость или сеть действительно необходимы;
  • ошибки, timeout и повторный запуск учтены;
  • секреты и персональные данные не попали в prompt, logs или git;
  • команды проверки реально выполнялись, а не были только предложены;
  • необратимое или публичное действие подтверждено отдельно.

Антипаттерны

  • просьба «сделай хорошо» без критерия готовности;
  • огромный обязательный план для опечатки;
  • автоматический trust к выводу агента о собственных тестах;
  • постоянные инструкции, состоящие из случайных запретов;
  • второй агент как единственное доказательство корректности первого;
  • commit всего dirty worktree вместо выбранных файлов.

Связанные заметки