Хватит писать запреты в CLAUDE.md: новые правила контекст-инжиниринга для Claude Code и /doctor

Я набивал CLAUDE.md запретами. "Никогда не делай X", "не смей писать Y", капсом, с восклицательными знаками - как будто ору на стажёра, который меня не слышит. А 24 июля 2026 Anthropic выкатил материал, где по сути говорит: ребят, вы делаете только хуже. Модели поумнели, а вы всё ещё держите их на коротком поводке из своих запретов. Ниже разберу, что поменялось в контекст-инжиниринге для Claude 5, почему описание стиля бьёт жёсткий запрет, и что за команда /doctor разгребает этот бардак.

Что за новые правила контекст-инжиниринга для Claude 5

Контекст-инжиниринг - это то, как ты собираешь контекст для модели: системный промпт, скиллы, CLAUDE.md, память, описания инструментов. 24 июля 2026 Тарик из Anthropic опубликовал новые правила этой сборки для моделей поколения Claude 5. Главный аргумент авторитетный: этими же принципами Anthropic сократил системный промпт самого Claude Code больше чем на 80% - без измеримого ухудшения на своём бенчмарке по кодингу.

Вдумайся в цифру. Больше 80% инструкций, которые люди годами считали необходимыми, оказались лишними. Не "чуть подрезали жирок", а выкинули четыре пятых - и модель не стала хуже кодить. Значит, весь этот объём был не помощью, а шумом, который модель и так продиралась, тратя токены и внимание.

Логика простая: старые модели действительно нуждались в подпорках, иначе в худшем случае писали дичь. Новые - соображают лучше и опираются на окружающий контекст сами. Костыли, которые спасали от худшего сценария, теперь просто мешают и конфликтуют между собой.

Почему жёсткие запреты в клод код работают хуже описания стиля

Жёсткий запрет говорит модели, чего не делать, но не даёт ориентира, что делать вместо. Описание желаемого стиля даёт. Классический пример из материала: раньше в промпт писали "никогда не пиши комментарии" (или "не пиши многострочные докстринги"). Теперь то же самое формулируют как "пиши код, который соответствует плотности комментариев и неймингу в окружающем коде".

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

Раньше без этих ограничителей комментарии Claude часто были неуместными, поэтому запреты имели смысл. Сейчас у модели достаточно суждения, чтобы решить самой по контексту. Поэтому правило простое: везде, где ты пишешь "не делай так", остановись и спроси - а могу ли я вместо запрета описать, как выглядит хорошо? Обычно можешь.

Каким должен быть CLAUDE.md по новым правилам Anthropic

CLAUDE.md должен содержать только подводные камни - то, обо что модель реально споткнётся, а не то, что она поймёт сама, поизучав репозиторий. Коротко опиши, зачем нужен проект, а основной бюджет токенов трать на грабли: неочевидные зависимости, странные соглашения, места, где "логично" сделать неправильно.

Всё, что модель выведет сама из кода, - лишнее. Она видит структуру папок, стек, стиль соседних файлов. Расписывать ей "у нас проект на Python, тесты в папке tests" - трата токенов на пересказ очевидного. Такой раздутый CLAUDE.md не помогает, а разбавляет действительно важные предупреждения водой.

Проверь себя вопросом по каждой строке файла: модель узнает это, просто открыв пару файлов? Если да - удаляй. Останется то, обо что она бы споткнулась вслепую. Вот это и есть полезный CLAUDE.md.

Не дублируйте правила в промпте и описании инструмента

Одно и то же правило, повторённое в системном промпте и в описании инструмента, - это чистая трата токенов и риск рассинхрона. Если правило про инструмент - его место в описании инструмента, и только там. В системный промпт его дублировать не нужно.

Это особенно важно, когда ты строишь своих агентов на Anthropic API, а не просто пользуешься Claude Code. Там ты сам автор и системного промпта, и описаний тулов - и легко в порыве надёжности написать одно и то же дважды. А потом правишь в одном месте, забываешь про второе, и модель получает два слегка разных указания. Она честно пытается угодить обоим и путается.

Вместо примеров использования, которые зажимают инструмент в узкий сценарий, лучше вложиться в сам дизайн: понятные выразительные параметры, внятные подсказки по значениям. Хорошо спроектированный инструмент объясняет себя сам, и городить вокруг него частокол примеров не нужно.

Как разбивать claude code skills на файлы

Длинный скилл надо разбивать на несколько файлов и подгружать только то, что нужно под конкретную задачу. Это называется прогрессивное раскрытие: модель не тащит весь мануал в контекст сразу, а достаёт нужный кусок по мере надобности. Специализированные инструкции выносятся в отдельные скиллы вместо того, чтобы всё грузить наперёд.

И ещё один пункт, который лично мне сломал шаблон: спецификация не обязана быть в Markdown. Часто мы садимся писать подробное текстовое ТЗ, хотя лучший бриф уже лежит рядом. Подойдёт тестовый набор, который показывает ожидаемое поведение. Подойдёт HTML-макет. Подойдёт функция из другой кодовой базы, на которую надо равняться. Иногда показать пример нагляднее, чем описать словами.

Что делает /doctor с раздутыми CLAUDE.md и скиллами

/doctor - это команда Claude Code, которая помогает привести в порядок ("rightsize") твои CLAUDE.md и скиллы: находит раздутое и предлагает сократить. По сути это ассистент по уборке накопленного мусора в контексте - тех самых устаревших запретов и дублей, о которых весь материал.

Запускаешь /doctor, смотришь предложенные упрощения и принимаешь те, с которыми согласен. Дальше руками: вынести многошаговые процедуры из CLAUDE.md в отдельные скиллы, заменить примеры-затычки на нормальную схему или интерфейс там, где это уместно.

Побочный, но приятный эффект - лимиты. Чем короче твой промпт и скиллы, тем меньше токенов уходит на каждый запрос, тем свободнее дышит контекстное окно. Люди, которые упираются в claude code лимиты, часто сами же и раздули контекст простынями инструкций. Уборка контекста - это заодно и экономия.

Что я с этим сделаю у себя

Скажу честно: у меня самого скиллы этого блог-пайплайна забиты запретами капсом. "НЕ выдумывай", "СТРОГО в формате", "НИКОГДА не дублируй" - я писал их, когда моделям это правда было нужно, и с тех пор ни разу не пересматривал. Материал Anthropic - хороший повод сесть и пройтись по каждому: половину запретов, подозреваю, можно заменить одной строчкой про желаемый стиль, а вторую половину просто удалить, потому что модель и так это понимает.

План на ближайший вечер простой. Прочитать первоисточник, запустить /doctor, принять разумные сокращения, а потом руками пройтись по CLAUDE.md и скиллам с одним вопросом к каждой строке: это подводный камень или я просто пересказываю очевидное? Всё очевидное - под нож. Похоже, это полезнее, чем накатить следующие десять модных скиллов.

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