Файл CLAUDE.md

О чём урок

CLAUDE.md предоставляет Claude контекст, необходимый новому сотруднику, охватывая соглашения, команды, архитектуру и ошибки, которые команда допускает чаще всего. Знания, которые раньше хранились в головах людей и на вики-страницах, становятся файлом, который агент читает в начале каждой сессии, поддерживаемым всей командой и обновляемым при каждой допущенной ошибке. Предварительные требования: Отсутствуют. Инфраструктура: Репозиторий (repo), установленный Claude Code и один инженер, хорошо знающий кодовую базу. Запустите /init в репозитории. Claude сгенерирует начальный файл CLAUDE.md на основе найденной информации. Сократите сгенерированный файл до того, что потребуется новому сотруднику в первый день. Сохраните команды build, test и lint, важные соглашения и моменты, в которых Claude постоянно ошибается. Зафиксируйте CLAUDE.md в Git в корне репозитория, чтобы вся команда использовала одну версию, а изменения просматривались как код. Здесь помогает следующее рабочее правило: когда Claude дважды допускает ошибку, исправление вносится в CLAUDE.md. Держите его в пределах одной страницы, поскольку Claude читает его целиком в начале каждой сессии, и любая устаревшая информация занимает контекст без пользы. CLAUDE.md: markdown CLAUDE.md находится под контролем версий, поэтому инструкции, по которым работает агент, подлежат проверке и аудиту. Командные соглашения применяются через этот файл, изменения в нем регистрируются в истории Git, а владельцы кода одобряют эти изменения при PR review. Опережающий индикатор: Как часто Claude повторяет ошибку, которую CLAUDE.md должен был предотвратить. Исправления или изменения в CLAUDE.md должны отслеживаться в истории Git. Запаздывающий индикатор: Время до первого объединенного PR для нового члена команды, исходя из истории PR.

План урока

1. Начало работы
2. Как это выполнить
3. Как это выглядит
4. Вопросы управления
5. Как это измерить