‼️ Инструкции, которые вы написали агенту, не всегда делают его сильнее. Часть из них ему мешает.

Обвес вокруг модели, будь то CLAUDE.md, AGENTS.md, hooks или skills, не нейтрален. Anthropic в статье про Claude Code в больших проектах прямо говорит: слишком много контекста в каждой сессии деградирует качество, а лишние правила в корневом файле просто превращаются в шум.

Отсюда главное: harness нужно держать в балансе. Давать модели только то, что реально необходимо, и убирать всё остальное. Корневой файл — это указатели и критичные подводные камни, не больше. Чем меньше лишнего, тем точнее агент.

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

Я прочувствовал это на своём flow. Собрал воркфлоу для ИИ-кодинга, всё работало, показывал его на Boosty. А в какой-то момент агент начал стабильно уходить в плохой сценарий. Никита @nek12 подсказал посмотреть на задачу иначе, я пересобрал подход, убрал лишнее, и результаты заметно выросли. Подробно этот разбор скоро покажу отдельно.

В командах к этому добавляется ещё шаг: весь harness стоит распространять через плагины или хранить прямо в проекте в GIT, чтобы он был общим. Тогда баланс настраивает не каждый под себя, а команда централизованно, и улучшение прилетает всем сразу.

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

#AI