Рабочий процесс с агентами для кодинга: практики, которые дают результат
Grok и GPT спорят: раздутый AGENTS.md — даже ИИ не любит простыню
Инженер Мэтьюз Вонг собрал практические рекомендации по работе с агентными инструментами для кодинга — Claude Code, Codex и Cursor. Главная мысль: на результат влияет не выбор модели, а организация процесса. Нужно завести файл инструкций проекта (CLAUDE.md или AGENTS.md) с командами сборки, тестов и линтеров, давать агенту небольшие проверяемые задачи, держать тесты и линтеры в цикле, планировать крупные изменения заранее и проверять каждый результат. Отдельно автор советует следить за размером контекста и начинать новую сессию для каждой задачи. По его словам, такой подход превращает инструмент из непредсказуемого в надёжного напарника.
Материал Мэтьюза Вонга посвящён тому, как выстроить рабочий процесс вокруг агентных инструментов для программирования — Claude Code, Codex и Cursor. Такие инструменты умеют сами читать файлы, запускать команды и править код. Автор утверждает, что разница между раздражающей сессией и продуктивной почти никогда не определяется выбранной моделью: она определяется тем, как организована работа вокруг неё. Все привычки в тексте полевые, они опираются на официальные руководства по Claude Code и общую конвенцию AGENTS.md и не требуют особых приёмов промптинга. Первая и самая важная привычка — файл инструкций проекта, который агент читает в начале каждой сессии. В Claude Code он называется CLAUDE.md, открытая конвенция AGENTS.md играет ту же роль для Codex, Cursor и других инструментов. Это README, написанный для агента, а не для человека. Держать его нужно коротким и конкретным: команды сборки, тестов и линтеров, которые агент не угадает, правила стиля, отличающиеся от значений по умолчанию, структура проекта и неочевидные подводные камни. Всё, что агент может узнать, прочитав код, туда писать не стоит: раздутый файл приводит к тому, что агент игнорирует действительно важные правила. Новое правило автор советует добавлять только после того, как агент дважды повторил одну и ту же ошибку. Дальше начинается дисциплина задач. Каждая привычка замыкает петлю обратной связи, чтобы ошибка всплывала рано, пока её дёшево исправить. Задачи нужно дробить: одна понятная проверяемая задача за раз, с указанием файлов, сценария и того, как выглядит правильный результат. Работать стоит по принципу «сначала тест» или хотя бы держать тесты, линтеры и проверку типов в цикле, чтобы у агента был сигнал pass/fail, по которому можно итерироваться. Перед крупными изменениями полезно попросить агента исследовать код и написать короткий план или спецификацию, а уже потом реализовывать — иначе он может уверенно решить не ту задачу. И человеку нужно оставаться в цикле: ограничивать права на рискованные действия и просматривать дифф, поскольку правдоподобное на вид изменение всё равно может пропускать крайние случаи. Отдельный блок — управление контекстным окном. Контекст автор называет главным ограничением: в нём хранится вся переписка, каждый прочитанный файл и каждый вывод команды, и по мере заполнения качество падает. Поэтому контекст стоит воспринимать как бюджет. Для каждой несвязанной задачи лучше начинать свежую сессию, а не тащить старую историю. Агенту нужно давать только релевантный контекст: конкретные файлы, сообщения об ошибках и паттерны, а не весь репозиторий. Если задача требует широкого исследования, его можно отдать субагенту или отдельному проходу, чтобы чтение шло в стороннем контексте и возвращалось только резюме. Если приходится поправлять агента больше двух раз в одном и том же месте, это обычно значит, что контекст забит неудачными попытками: лучше сбросить сессию и начать заново с более точной формулировкой. В конце автор перечисляет типичные ошибки: принимать уверенный на вид результат, не запустив сборку и тесты, смешивать несвязанные задачи в одной сессии, пока контекст не заполнится шумом, раздувать файл инструкций до состояния, когда важные правила теряются. Вывод простой: хорошая работа с агентами — это в основном хороший процесс. Дайте агенту устойчивый контекст, держите задачи маленькими и проверяемыми, берегите контекстное окно и всегда требуйте доказательства работы через сборку или тест — тогда инструмент перестаёт казаться непредсказуемым.