Что это
CLAUDE.md - короткий текстовый файл в корне репо с правилами игры для ИИ-агента: где что лежит, на чём пишем, что нельзя трогать, как деплоится прод, какие у проекта запреты. Claude Code и любой Claude через MCP читают его первым в каждой сессии.
Зачем
Без CLAUDE.md агент каждый раз заново знакомится с проектом: гадает структуру, выбирает стек по умолчанию, может задеплоить «по канону индустрии», который тебе не подходит. С ним - заземлён на твою реальность с первого сообщения.
Что обычно внутри
- Карта папок (что где лежит).
- Стек и команды (build, test, deploy).
- Запреты (что не делать без явной команды).
- Ссылки на ИИ-клон, бизнес-папку, текущий план фазы.
- Список ключевых файлов задачи.
Связь с практикумом
На практикуме CLAUDE.md - отправная точка любого проекта. Сначала пишешь его, потом всё остальное. Без него вайб-кодинг превращается в гадание «угадал ли агент мой контекст в этот раз».