Bisovka · разбор для выпускников
Меньше правил — умнее агент
Anthropic убрала больше 80% системного промпта Claude Code для моделей поколения Claude 5, и метрики на кодовых тестах не просели. Те же правила касаются твоих CLAUDE.md и скиллов: половина из них сегодня скорее мешает.
Сначала забери промпт
Он прогонит по твоим CLAUDE.md и скиллам тот же аудит, что описан ниже. Внутрь вшиты критерии из самой статьи, поэтому агент проверяет по первоисточнику, а не по пересказу. Скопируй, открой Claude Code в своём проекте и вставь. Работает и в Codex.
что случилось
Инструкций стало меньше, качество осталось
Правила в системном промпте писались под модели, которым нельзя было доверять решение. Чтобы Claude не удалил лишний файл и не завалил код комментариями, ему запрещали заранее и на всякий случай. Новое поколение справляется само, и жёсткие запреты начали стоить дороже, чем приносят: модель тратит рассуждение на то, чтобы примирить противоречащие друг другу указания.
Системный промпт Claude Code · сколько инструкций осталось
Убрали больше 80%. Измеримой потери на кодовых тестах Anthropic не увидела.
сдвиг первый
Правило проигрывает суждению
Классика прошлого подхода: запретить комментарии, потому что раньше модель писала их плохо. Но для части задач запрет просто неверен, у автора могут быть свои предпочтения, а сложный код иногда требует развёрнутого пояснения. Вместо запрета Anthropic оставила ориентир, по которому решение принимается на месте.
Было: запрет
↓ то же намерение, но решает модель
Стало: ориентир
Что сделать у себя. Найди в своих файлах слова «всегда», «никогда», «обязательно» и «запрещено». Для каждого спроси, есть ли задача, где это правило даст плохой результат. Если есть, замени правило на критерий.
сдвиг второй
Не грузи всё сразу, дай подтянуть по требованию
Живучий миф: клади в CLAUDE.md всё, что знаешь, иначе агент не найдёт. Он отлично находит сам, если оставить понятные указатели. Держи в CLAUDE.md короткий роутер и настоящие подводные камни, а подробности вынеси в отдельные файлы, которые читаются, только когда действительно нужны.
Горит то, что осталось в контексте каждой сессии. Это мой рабочий контракт после разбора: 9% объёма грузится всегда, остальное подтягивается под конкретную задачу. Ни один факт не выброшен, всё переехало в файлы рядом.
ещё четыре сдвига
Что поменялось в мелочах
Примеры уступили место интерфейсам. Раньше главным правилом было показать модели пример вызова инструмента. Теперь пример наоборот сужает ей пространство поиска. Лучше работает выразительное описание: понятные имена полей и перечисление допустимых значений сами подсказывают, как пользоваться.
Повторы больше не нужны. Раньше важное дублировали в начале и в конце, потому что модель хуже держала середину контекста. Теперь инструкция живёт там, где работает, внутри описания самого инструмента, без копии в системном промпте.
Спека может быть не текстом. План не обязан быть markdown-файлом. Claude тянет и более плотные источники. Ему годится HTML-артефакт, набор тестов, готовая функция из соседнего репозитория или рубрика для проверяющего агента. Код как референс объясняет замысел точнее, чем его описание словами.
Память переехала. Раньше факты о себе складывали в CLAUDE.md руками через решётку. Теперь Claude сам сохраняет то, что пригодится дальше, и достаёт при следующем запуске.
Было
Ты сам#
решаешь, что запомнить, и дописываешь в CLAUDE.md руками
Стало
Авто-памятьauto
агент сам сохраняет полезное и поднимает, когда оно к месту
живой пример
Что нашлось в моём сетапе
Я прогнал по этим правилам всё, что у меня накопилось: глобальный CLAUDE.md, контракты воркспейса, правила и 46 своих скиллов. Дороже всего обошлись расхождения. Два файла с одним и тем же содержимым я держал синхронными руками, и они успели разойтись: в одном стояло ограничение ответа 8000 токенов, в другом 2000. Агент читает оба и выбирает сам.
Дальше по списку: в одном скилле нашлось семь разных чисел про количество слайдов в презентации. Десять путей вели к пользователю, которого на этой машине давно нет. Ключ API лежал открытым текстом в правиле, которое вело к утилите, которая не установлена. А список из девяти запрещённых скиллов оказался лишним: они уже выключены в настройках, и агент читал запрет вхолостую.
Самое полезное наблюдение. Вредит ситуация, когда два места говорят разное. Дубликат, который надо обновлять руками, разойдётся всегда. Держи факт в одном месте и ставь на него ссылку.
дальше
Что делать с этим сейчас
Разбор занял один вечер, и половина находок оказалась не про объём, а про то, что два файла годами говорили разное. Начни с самого дорогого: открой свой корневой CLAUDE.md и посчитай, сколько символов он стоит тебе в каждой сессии.
Промпт для аудита лежит в начале страницы. Он найдёт файлы сам, сначала покажет таблицу находок, потом починит. Первоисточник: статья Anthropic и инженерный гайд.