Поэзия агентной разработки, или Как теперь писать код и не утонуть в легаси

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

Зачем вам этот подход и что получите на выходе?

Русскоязычный разработчик, полтора года ежедневно писавший код с ИИ-агентами, опубликовал на Хабре подробный разбор того, что сам назвал поэзией агентной разработки. Автор начинал карьеру в Яндексе, где столкнулся с легаси (старым, запутанным кодом, который больно менять) и с тех пор изучал Clojure, читал SICP (классический учебник по структуре программ), разбирал открытые кодовые базы.

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

Статья разделяет два уровня: «подход сверху» (ценности и принципы, по которым вы решаете, что агенту поручить) и «подход снизу» (конкретные правила для ежедневной работы). Ниже я вытащил практическую часть и адаптировал её для тех, кто не пишет на Clojure, но уже пользуется Cursor, Copilot или Claude Code.

Что понадобится

• Любой агентный инструмент для кода: Cursor, GitHub Copilot, Claude Code, Windsurf или аналог
• Базовое понимание, что такое промпт (текстовая инструкция для ИИ) и как его редактировать
• Проект, в котором вы уже работаете, идеально с историей коммитов
• 30 минут на первую настройку системного промпта (постоянной инструкции, которая задаёт агенту рамки поведения)

Пошаговая инструкция

1. Разделите «легко» и «просто» до запуска агента. Прежде чем давать задачу, спросите себя: результат будет односложным (одна ответственность, минимум связей) или многосложным (затрагивает три модуля и базу)? Если многосложным, разбейте задачу на части вручную. Агент хорош в генерации, но не в декомпозиции архитектуры.

2. Напишите системный промпт проекта. Создайте файл с правилами, которые агент обязан соблюдать. Пример минимального набора:

## Правила для агента

- Не создавай новых абстракций без явного запроса.
- Каждый файл решает ровно одну задачу.
- Не дублируй логику; если нашёл похожий код, спроси перед копированием.
- Пиши тесты на каждый публичный метод.
- Комментируй «почему», а не «что».

1. Давайте агенту задачу в формате «контекст, ограничение, результат». Не просто «сделай авторизацию», а конкретно:

Контекст: у нас REST API на FastAPI, база PostgreSQL, ORM — SQLAlchemy.
Ограничение: не трогай модуль payments, не добавляй новых зависимостей.
Результат: эндпоинт POST /auth/login, который принимает email и пароль,
возвращает JWT-токен (стандарт подписи для аутентификации). Тест на pytest.

1. Проверяйте каждый PR агента по трём критериям. Автор статьи формулирует два ключевых показателя: TTM (time to market, время от идеи до релиза) и SLA (обязательства по стабильности сервиса). Добавьте третий: читаемость для человека, который откроет этот код через полгода. Если хотя бы один критерий проседает, откатывайте и переформулируйте промпт.

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

3. Ведите лог решений, а не лог кода. После каждой сессии с агентом фиксируйте: какую задачу ставили, что агент предложил, что вы изменили и почему. Это ваша страховка от накопления случайной сложности (accidental complexity, усложнения, которого можно было избежать).

Что делать с этим прямо сейчас?

Разработчику или автору, который пишет код для своих проектов на Дзене. Заведите файл правил для агента в корне проекта. Даже пять строк ограничений сэкономят часы отладки. Попробуйте формат «контекст, ограничение, результат» из шага 3 вместо свободного промпта.

Маркетологу или менеджеру, который заказывает разработку. Спрашивайте у подрядчика не «сколько строк агент написал», а «сколько связей между модулями добавилось». Поэзия агентной разработки, или как теперь писать код, это вопрос не скорости, а управляемости того, что получается на выходе.

Предпринимателю в РФ и СНГ. Все инструменты из списка (Cursor, Copilot, Claude Code) доступны, хотя некоторые требуют VPN или оплаты через зарубежные карты. Из отечественных аналогов: в GigaChat и YandexGPT можно генерировать фрагменты кода, но полноценных агентных IDE на российском рынке пока нет. Подход из статьи работает с любым агентом, потому что он про дисциплину, а не про конкретный продукт.

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