Файл инструкций проекта читается в начале каждой сессии, а значит, каждая его строка оплачивается на каждом запросе, пока файл существует. Один этот факт решает, что в него входит, а что нет. Всё, что обнаруживается чтением кода — язык, фреймворк, структура каталогов, — пересказывается читателю, который это и так видит. Место оправдывает обратное: тестовая команда, которой нужен флаг; версия Node, ломающая сборку; соглашение, о котором новичок догадается неверно; то, что уже стоило кому-то половины дня. Конструктор построен вокруг этих категорий, оценивает стоимость файла и отмечает строки, которые рассказывают репозиторию о нём самом.
Возможности
Разделы, подсказанные их содержанием, а не чистым листом
Постоянная оценка токенов — стоимость на каждом запросе, а не единожды
Отмечает строки, повторяющие то, что код и так показывает
Отмечает пустые призывы, которые ничего не меняют
Предупреждает, когда файл дорос до размера, при котором его просматривают по диагонали
Замечает отсутствие заголовков, по которым можно прореживать
Пустые разделы опускаются, а не пишутся пустыми
Скачивается как CLAUDE.md
Как использовать Инструкции проекта
Назовите проект
Заполняйте только те разделы, где есть что сказать неочевидного
Следите за оценкой токенов по мере роста
Прочтите предупреждения и скачайте файл
Пример
Ввод
This project is a React app.
Результат
Warning: the language and framework are visible from the manifest
Проверка каждой строки: найдёт ли читатель это сам за десять секунд?
Частые ошибки и устранение неполадок
Файл помечен как слишком большой. — Перенесите всё, что нужно лишь иногда, в отдельный документ, который сессия прочтёт по необходимости. Файл инструкций — для того, что верно всегда.
Нужную мне строку пометили как обнаружимую. — Игнорируйте предупреждение, если строка действительно работает. Проверка — повод спросить себя, найдёт ли читатель это и так, а не правило.
Добавляю инструкции — ничего не меняется. — Конкретные и проверяемые инструкции работают куда лучше общих. «Используй примитивы из components/ui» лучше, чем «пиши чистый код».
Назвать это CLAUDE.md или иначе? — Содержание одно и то же. Сохраните под тем именем, которое читает ваш инструмент; структура и дисциплина не меняются.
Часто задаваемые вопросы
Что действительно уместно в файле инструкций?
То, что не обнаруживается в коде и иначе будет понято неверно: команда, которой нужен флаг; версия, ломающая сборку; соглашение, невидимое ни в одном отдельном файле; и явные запреты. Остальное — пересказ читателю, который и так умеет читать.
Какой длины он должен быть?
Достаточно коротким, чтобы его ещё читали. Оценка показывается по мере ввода; за парой тысяч токенов стоит спросить, какие строки действительно верны всегда, — остальное может жить в документе, читаемом по требованию.
Почему отмечается «пиши чистый код»?
Потому что это ничего не меняет. Общий призыв тратит токены на каждом запросе и не даёт основания для решения; конкретное соглашение — где лежит логика, какие примитивы использовать — даёт.
Важно ли, что это оплачивается на каждом запросе?
Именно поэтому файл и нужно прореживать. Страница инструкций — мелочь один раз и заметная сумма на тысячах запросов, поэтому оценка стоит рядом с текстом, а не спрятана.
Можно ли класть туда секреты?
Нет — файл читается в контекст каждой сессии и обычно попадает в репозиторий. Держите учётные данные в окружении и ссылайтесь на них по имени, если инструкции обязаны их упомянуть.
Связанные инструменты
Конструктор навыков — Напишите SKILL.md — frontmatter проверяется по ходу ввода.
Конструктор субагентов — Соберите файл определения субагента с его инструментами и моделью.