Новые правила контекст-инжиниринга в Claude 5

Промпт-инжиниринг умер, да здравствует контекст-инжиниринг!

Тарик (@trq212) из команды разработки Anthropic поделился важнейшим инсайтом про подходы к составлению контекста для моделей нового поколения — Claude Opus 5 и Claude Fable 5.

Самый шокирующий факт: команда Anthropic сократила системный промпт Claude Code более чем на 80% — и это вообще не ухудшило результаты на бенчмарках кодинга.

Почему так произошло и как нам теперь правильно организовывать файлы CLAUDE.md, навыка (Skills) и промпты? Разбираем ключевые сдвиги парадигмы.

Главный тренд на «Расковывание» модели (Unhobbling)

Раньше мы перестраховывались и заваливали Claude жесткими ограничениями: «не пиши комментарии», «не создавай планировочных файлов», «делай только так и никак иначе».

На практике в реальных сессиях это приводило к катастрофе: системный промпт конфликтовал с CLAUDE.md, навыками и запросом пользователя. Модели приходилось тратить огромное количество ресурсов и токенов «мыслей» (reasoning) просто на то, чтобы распутать эти противоречия.

Новое поколение моделей (Claude 5) обладает развитым суждением и пониманием контекста. Старые жесткие гайдлайны стали не просто бесполезны — они начали тормозить модель.

Как изменились правила

1. Правила ➔ Суждение

• Раньше: Жесткие запреты. «Пиши минимум комментариев. Максимум одна строчка!»
• Сейчас: Инструкции на основе контекста. «Пиши код в стиле окружающего кода: сохраняй ту же плотность комментариев, нейминг и идиомы».

Claude 5 отлично считывает стиль проекта сам. Не нужно навязывать ему искусственные рамки.

2. Примеры (Few-Shot) ➔ Дизайн интерфейсов

• Раньше: Мы давали модели кучу примеров того, как вызывать инструменты (Tools).
• Сейчас: Примеры ограничивают пространство поиска решения. Вместо них нужно делать выразительные типы и параметры в самих инструментах (например, четкий enum для статусов задач: pending, in_progress, completed).

3. Все и сразу ➔ Постепенное раскрытие (Progressive Disclosure)

• Раньше: Мы запихивали в системный промпт или CLAUDE.md правила на все случаи жизни — от ревью кода до верификации.
• Сейчас: Использование архитектуры динамической загрузки:
  • Верификация и ревью выносятся в отдельные Skills, которые Claude вызывает только при необходимости.
  • Часть инструментов использует «отложенную загрузку» (ToolSearch / deferred loading), не забивая контекстное окно заранее.
  • Ваши файлы CLAUDE.md и Skills должны представлять собой дерево файлов, загружаемых по требованию, а не один гигантский монолит.

4. Повторение инструкций ➔ Лаконичные описания

• Раньше: Приходилось дублировать правила использования инструментов и в системном промпте, и в описании самого инструмента.
• Сейчас: Дублирование убрано. Достаточно один раз четко описать инструмент в его собственном description.

5. Ручной контекст в CLAUDE.md ➔ Auto-Memory

• Раньше: Мы вручную или через хоткеи заставляли Claude записывать все в CLAUDE.md.
• Сейчас: Функция Auto-memory сама фиксирует важные детали о вашей работе, предпочтениях и архитектуре от сессии к сессии.

6. Простые ТЗ ➔ Богатые референсы (Rich References)

• Раньше: Простые Markdown-файлы с планом работ.
• Сейчас: Claude 5 способен работать со сложными референсами:
  • HTML-артефакты вместо текстовых описаний дизайна (код дизайна дает куда более точный результат, чем скриншот или текстовое описание).
  • Тестовые сюиты в качестве спецификаций.
  • Рубрики (Rubrics) — критерии качества для запусков агентов-валидаторов (например, для проверки API-дизайна).

Как собрать идеальный контекст для вашего проекта?

Если вы используете Claude Code или строите своего агента, вот правильная иерархия контекста на сегодня:

1. System Prompt: Только контекст продукта/платформы. Никаких микро-инструкций по коду.
2. CLAUDE.md: Максимально легкий! Не пишите банальные вещи, которые модель и так увидит по файловой структуре. Пишите только уникальные «грабли» (gotchas) и особенности именно вашего репозитория (например: «все типы хранятся строго в одном монолитном файле X»).
3. Skills: Используйте их как узкоспециализированные руководства. Делите длинные скиллы на несколько файлов (Progressive Disclosure). Выносите туда стандарты вашей команды.
4. References: Ссылайтесь через @имя_файла на конкретный код, тесты или HTML-макеты. Код — самый понятный язык для Claude.

Главный совет напоследок

Если чувствуете, что ваши CLAUDE.md и навыки перегружены старыми правилами, в Claude Code появилась отличная встроенная команда:

/doctor

Команда claude doctor автоматически проанализирует ваши файлы контекста, подсветит устаревшие жесткие ограничения и поможет сделать их компактными и эффективными под модели Claude 5!

Время облегчать контекст и давать Claude больше свободы!