Как один файл сократил мои переговоры с AI-агентом в три раз Работаю с Claude Code уже несколько месяцев. Первое время каждый диалог начинался одинаково: объясняю контекст проекта, напоминаю про стек, прошу не трогать определённые файлы, уточняю код-стайл. Минут десять на разогрев, потом только к делу. Знакомо? А потом я нормально оформил файл CLAUDE.md. И всё изменилось. CLAUDE.md - это инструкция для агента, которая лежит в корне проекта. Агент читает её автоматически при старте и сразу понимает: что за проект, какие правила, чего делать нельзя. Как онбординг для нового сотрудника, только читается за секунду. Что изменилось после внедрения: Перестал повторять одно и то же. Раньше в каждом чате писал “у нас Spring Boot 3, Java 17, тесты на JUnit 5”. Теперь это в файле, агент знает по умолчанию. Меньше ошибок. Агент больше не пытается использовать устаревшие библиотеки или паттерны, которые у нас не приняты. Всё прописано. Консистентный код. Стиль именования, структура пакетов, формат логов - агент следует правилам проекта, а не своим представлениям о прекрасном. Несколько рекомендаций из практики: Начните с контекста проекта. Две-три строки: что это за система, для кого, какой стек. Агент лучше принимает решения, когда понимает картину целиком. Опишите структуру репозитория. Где лежат тесты, где конфиги, где миграции. Экономит кучу времени на вопросах “а куда положить новый файл”. Добавьте типичные команды. Как собрать проект, как запустить тесты, как поднять локально. Агент сможет проверять свою работу самостоятельно. Укажите, чего делать нельзя. “Не трогай файлы в /legacy”, “не меняй версии зависимостей без согласования”, “не удаляй комментарии TODO”. Это спасает от сюрпризов. Пропишите код-стайл. Если у вас есть соглашения по именованию, структуре классов, формату коммитов - опишите. Иначе агент будет делать по-своему, а вы потом переделывать. Добавьте частые ошибки и их решения. “Если видишь ошибку X, сначала проверь Y”. У каждого проекта свои грабли, и агенту полезно о них знать заранее. Файл не должен быть огромным. У меня около 50 строк, и этого хватает. Главное - актуальность. Если что-то изменилось в проекте, обновите и CLAUDE.md. По сути, это инвестиция часа времени, которая экономит часы каждую неделю. Плюс код получается более однородным, как будто его писал один человек, а не вы с агентом по очереди. Кто уже пробовал подобные инструкции для AI-агентов? Что включаете в свои файлы?