Тактический план и контекст: почему агенту нужна спецификация
Тренер заходит в раздевалку перед дерби, хлопает в ладоши и кричит: «Выходим, прессингуем и забиваем быстрый гол! Погнали!».
Команда выбегает на поле. Через двадцать минут начинается бардак: крайний защитник убежал в атаку и застрял, полузащитники врезаются друг в друга в центре, а нападающий мечется между защитниками и задыхается без мяча.
Желание победить было, плана не было.
В чемпионских клубах разговор строят иначе. Тренер включает проектор: «Они играют в три защитника, правый край проваливается при смещении. Наша схема: перегружаем левый фланг, вытягиваем опорника, форвард врывается в полуфланг под передачу».
Каждый шаг расписан до выхода на газон.
В разработке с агентами происходит ровно то же самое. Если вы бросите модели запрос: «Сделай интеграцию платежки через Stripe», агент наломает дров за десять минут.
Реальность
Когда разработчик дает агенту большую задачу одним промптом, модель начинает писать код вслепую.
Она генерирует файлы, ломает зависимости, пытается чинить их на лету и забивает историю сессии сотнями сообщений.
Инженерный подход к управлению контекстом строится на дисциплине спецификации (RePPIT):
- Исследование (Research): агент изучает кодовую базу, находит связанные модули и выписывает зависимости.
- Предложение (Propose): агент формирует черновик архитектурного решения.
- План (Plan): решение разбивается на шаги с понятными критериями приемки.
- Реализация (Implement): агент правит код строго по шагам.
- Тестирование (Test): каждый шаг проверяется тестами до перехода к следующему.
Пока план не утвержден человеком, модель не прикасается к коду. Это экономит часы ручного отката правок.
Почему это важно
Вторая скрытая проблема — налог на контекст (The Context Tax).
Исследования на тысячах агентских сессий показывают: чем длиннее становится диалог с моделью, тем хуже она соображает. Когда окно контекста раздувается до пятидесяти тысяч токенов, внимание рассеивается. Модель пропускает прямые запреты из системного промпта и теряет логику задачи («эффект потерянного в середине»). При этом каждый следующий шаг стоит в разы дороже.
Поэтому агенту нужен перерыв на отдых — компактификация (Compaction).
В перерыве матча тренер не пересказывает игрокам все сорок пять минут беготни с мячом. Он стирает лишний шум и оставляет на доске три пункта: счет, ошибки в обороне и задачу на второй тайм.
Точно так же работает сжатие сессии: фреймворк агента выбрасывает километры промежуточных логов и черновиков, сохраняя только текущее состояние репозитория и список оставшихся задач.
В чем подвох?
Эргономика инструментов.
Даже идеальный план развалится, если инструменты возвращают тонны мусора. Если вызов функции через протокол MCP возвращает стек-трейс на три страницы вместо короткой ошибки «Превышен лимит запросов, повтори через сорок секунд», контекст забивается мусором за один вызов. Инструменты обязаны возвращать компактный, структурированный ответ.
Главная мысль
Спецификация экономит токены и нервы: агент должен договориться о плане на доске до того, как сделает первое касание в кодовой базе.
Специалисты по ИИ называют это: Разработка через спецификацию (Spec-Driven Development) / Налог на контекст (Context Tax) / Компактификация контекста (Context Compaction)
При длительных сессиях увеличение объема входящих токенов снижает точность следования инструкциям модели из-за эффекта «Lost in the Middle» и квадратично увеличивает вычислительные затраты. Компактификация сжимает историю диалога в структурированное состояние (State Summary), отсекая промежуточные логи инструментов. Подход RePPIT (Research, Propose, Plan, Implement, Test) гарантирует разделение фаз планирования и кодогенерации.
💬 Случалось ли вам отдавать агенту крупную задачу одной фразой, а потом полчаса разгребать десяток ненужных файлов, которые он успел создать?
Часть 2 из 10 | #CodingAgentsForHumans