CLAUDE.md и auto memory решают разные задачи, и путать их не стоит. CLAUDE.md - это инструкции, которые Claude Code добавляет в контекст сессии: reviewable источник истины команды, живущий в репозитории под контролем версий. Auto memory - заметки, которые Claude ведёт сам между сессиями: вспомогательное накопление опыта. Первое вы пишете и ревьюите сознательно, второе накапливается по ходу; смешивать их роли - значит либо засорять источник истины, либо ждать от заметок надёжности контракта.

Память устроена иерархически. Claude Code ищет managed-память, user-файл ~/.claude/CLAUDE.md, project CLAUDE.md или .claude/CLAUDE.md, вложенные файлы по мере работы и личный CLAUDE.local.md. Более конкретные инструкции применяются ближе к своему пути. Если организация уже использует AGENTS.md, Claude Code не считает его автоматически полным эквивалентом - его импортируют явно директивой @AGENTS.md; так же через @path подключают и другие файлы, рекурсивно до документированной глубины 4, но никогда - секреты.

Хороший CLAUDE.md - это контракт проекта, а не пересказ структуры. В нём назначение, команды проверки, границы ("не запускать production-миграции", "не трогать сгенерированное") и определение готовности. Держат основной файл примерно до 200 строк - это не жёсткий лимит парсера, а практическая рекомендация: длинные инструкции занимают контекст и теряют salience. Общие факты оставляют в корне, а path-специфичные требования переносят в rules.

Path-scoped rules - ключ к дешёвой и точной памяти. Правило в .claude/rules/*.md с frontmatter paths включается, только когда Claude работает с совпадающими файлами; правило без paths загружается всегда. Полезно один раз увидеть такое правило: ниже - rule для src/api с двумя требованиями. Это дешевле и точнее, чем огромная корневая память: релевантная инструкция подгружается к своему коду, а не висит в контексте на каждой задаче.

Команды /init и /memory помогают вести память осознанно. /init создаёт начальный CLAUDE.md - это draft, а не автоматически верная политика, и его сверяют с фактическими скриптами и CI. /memory показывает загруженные источники памяти и открывает управление ими. Регулярная ревизия важна: память легко зарастает дублями, пожеланиями и устаревшими фактами, которые не помогают, а занимают контекст и вводят агента в заблуждение.