Как улучшить CLAUDE.md с помощью самого Claude

Файл CLAUDE.md — это инструкция для Claude Code, которая задаёт контекст проекта, стек, соглашения по коду и рабочий процесс. Создать начальную версию несложно, но сделать её по-настоящему полезной — отдельная задача. Джонни Грабер (Improve & Repeat) описывает пять подходов к улучшению CLAUDE.md с помощью самого Claude.

Генерация из текущей сессии Claude Code

Если вы работаете в Claude Code над задачей и чувствуете, что накопили достаточно контекста, попросите Claude проанализировать сессию и сгенерировать CLAUDE.md:

Analyse the current session and then write a CLAUDE.md file so that I can come
back later and ask for other examples without the need to repeat everything
about the blog and how I want the examples to be.

Результат — файл с описанием стека, соглашениями по именованию файлов, настройками LLM, конвенциями кода и правилами проекта. Всё извлечено из реальной работы, а не выдумано.

Шаблоны через Claude Desktop

Claude Desktop удобен для создания шаблонов CLAUDE.md под определённый тип проектов. Пример промпта:

I need a good starting template for `CLAUDE.md` that I can use with my Python
projects. It should follow the best practices as of May 2026 and follow my
workflow. For example, I want to use uv for the package management, pytest
for testing and ruff to fix formatting.
Can you guide me through all the necessary questions I may have forgotten?
/ultrathink /brutal

Ключевой элемент — /brutal: Claude честно укажет на проблемные решения и предложит альтернативы. Например, может предупредить, что Jupyter-ноутбуки без nbstripout приведут к конфликтам при слиянии.

Полученный шаблон покрывает: стек, команды, структуру проекта, Git-процесс, конфигурацию, работу с данными и ноутбуки.

Периодический пересмотр

Claude Code быстро развивается, и определение «хорошего» CLAUDE.md меняется со временем. Рекомендуется пересматривать файл каждые несколько месяцев, используя Claude для проверки актуальности.

Ссылки на внешние инструкции

В CLAUDE.md можно ссылаться на дополнительные файлы с детальными инструкциями:

For the user interface, use the components described in @./UI_CONTROLS.md.

Claude Code загружает содержимое файла UI_CONTROLS.md только когда оно нужно. Это позволяет держать основной файл компактным, не теряя в полноте инструкций.

Итеративная доработка

CLAUDE.md — это не статичный документ. Храните его в Git, меняйте при разработке новых фичей и оставляйте только те изменения, которые реально помогают. Если после обновления файла вы реже поправляете Claude и меньше повторяете одно и то же — вы на правильном пути.

Итог

Главный принцип: CLAUDE.md должен работать на вас. Если он не уменьшает количество повторений и поправок — экспериментируйте дальше.