Перейти к содержимому

Дайджест: новые правила контекст-инжиниринга для моделей поколения Claude 5

Anthropic выбросила больше 80% системного промпта Claude Code для Opus 5 и Fable 5 и не увидела просадки на своих тестах по коду. Цифра заслуживает того, чтобы дочитать разбор целиком: она означает, что инструкции, которые команды кропотливо писали агентам последние пару лет, устарели не потому, что были неверными, а потому что модель переросла нужду в них.

Старая инструкция про комментарии звучала так: «никогда не пиши многострочные докстринги и блоки комментариев, максимум одна короткая строка». Новая описывает намерение: «пиши код, который читается как окружающий: та же плотность комментариев, те же имена, та же идиома».

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

Второй пласт изменений адресован тем, кто делает агенту инструменты. Примеры вызовов из описаний предлагают убрать: они сужают поиск, и модель начинает воспроизводить показанный сценарий вместо подходящего. Подсказку переносят в сам интерфейс, в имена параметров и в перечисления вроде pending, in_progress, completed, по которым назначение читается без пояснений.

Оттуда же ушли повторы. Одно и то же правило раньше дублировалось в системном промпте и в описании инструмента; теперь оно живёт в одном месте, там, где применяется.

Развёрнутые инструкции по проверке и код-ревью переехали из системного промпта в скилы. Описания инструментов тоже больше не висят в контексте с самого начала: агент находит нужное поиском по каталогу, когда до него доходит дело.

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

Раньше факт попадал в память проекта по явной команде: вы говорили «запомни», агент дописывал строку. Теперь Claude сохраняет заметки сам, по ходу работы, а CLAUDE.md рекомендуют держать лёгким и складывать туда особенности конкретного репозитория, а не общеизвестные вещи.

У этого есть неприятная сторона. Файл, который правит не только человек, нужно читать наравне с кодом, иначе в нём заведётся правило, которого никто не писал. Про гигиену памяти подробно рассказано на странице Память.

Markdown-описания задачи уже мало. В качестве опоры предлагают прикладывать примеры кода, наборы тестов и рубрики для проверки, а из задачи на них ссылаться. Разница простая: тест либо проходит, либо нет, а формулировка «сделай хорошо и по нашим стандартам» проверяется спором.

  • Откройте свой CLAUDE.md или AGENTS.md и посчитайте механические запреты. Часть из них сворачивается в одну фразу про намерение, и файл худеет на треть без потери смысла. Ориентиры по объёму собраны на странице Память.
  • Длинные регламенты держите в скилах. Правило «факт, нужный всегда, в память; процедура, нужная иногда, в скил» от статьи не пострадало, скорее укрепилось.
  • Подключённые «на всякий случай» MCP-серверы по-прежнему стоят токенов, но отложенная подгрузка снимает часть налога. Подробности в Контекст-инжиниринге.
  • Оценить, насколько разрослись скилы и файлы памяти, помогает команда /doctor в Claude Code.

Автор учебника: Шахматов Алексей