CLAUDE.md, который агент правда читает

Что это

CLAUDE.md (в Codex — AGENTS.md) — файл с правилами, который агент читает в начале каждой сессии. Обычно его либо нет, либо он раздут на 300 строк «пиши чистый код» и «будь внимателен». Такой файл съедает контекст и токены в каждом сообщении, а пользы почти не даёт: агент всё это и так знает.

Рабочий CLAUDE.md — как чек-лист для нового сотрудника. В нём три вещи:

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

Промпт заставляет агента собрать такой файл (или почистить существующий) и завести журнал rule-candidates.md: туда пишутся ошибки, и правило появляется, только когда ошибка повторилась.

Как использовать

1. Открой папку проекта в Claude Code или Codex. Папка пустая и проект только начинается — сначала создай стартовые файлы проекта; проект достался от другого человека — сперва разберись в чужом проекте.
2. Отправь Шаг 1. Агент изучит проект и спросит, что уже ломалось. Отвечай примерами: «дважды переписал мои тексты в блоке "Обо мне"», «удалил картинки без спроса».
3. Прочитай предложенный текст и ответь «да» или поправь. Агент записывает файл только после твоего согласия.
4. Шаг 2 отправь один раз — он заводит журнал ошибок. Дальше, когда агент снова ошибается, просто пиши «запиши в кандидаты».
5. Раз в пару недель повторяй Шаг 1 — он покажет, что убрать и что добавить.

Рядом по теме: CLAUDE.md для любого проекта, AGENTS.md: одни правила для всех ИИ-агентов проекта, CLAUDE.md для контент-платформы, статья «Cursor или Claude Code» и 12 модов Claude Code для вайбкодера (490 ₽).

Что дальше

Когда в правилах появятся инструкции, которые ты повторяешь из раза в раз, вынеси их в отдельный скилл — промпт Хватит повторять одно и то же: сделай скилл. Чтобы агент помнил решения между проектами и сессиями, собери Память агента, которая не теряется. А техническую защиту вместо очередной строки правил дают 12 модов Claude Code для вайбкодера (490 ₽): проверка работы, корзина вместо удаления, защита ключей.