Как правильно написать CLAUDE.md для проекта?

CLAUDE.md — минимальная точка входа, а не энциклопедия проекта. Указатель, не контейнер.

Обязательные секции

• Название + описание — одна строка: что это за проект
• Ссылка на документацию — docs/project-knowledge/
• Ветка по умолчанию — main
• Ключевые правила — 5-7 строк максимум (язык, стиль, ограничения)
• ПРОГРЕСС — что сделано, что следующее (обновляется каждую сессию)

Чего НЕ должно быть

• Код — устаревает, раздувает контекст
• Детальная архитектура — выноси в architecture.md
• Список всех файлов — Claude сам найдёт через glob/grep
• Общие знания — «что такое REST API» не нужно

Паттерн ПРОГРЕСС

Секция ПРОГРЕСС — ключ к непрерывности между сессиями. После каждого блока задач Claude обновляет: что сделано (чекбоксы), что следующее, принятые решения. При новой сессии Claude читает ПРОГРЕСС и знает откуда продолжать.

Размер

Идеальный CLAUDE.md — 30-50 строк (без ПРОГРЕСС). Если больше 100 — выноси в rules/ и docs/. CLAUDE.md всегда в контексте, каждая лишняя строка тратит токены.