AGENTS.md — это текст, который дописывается к каждому вашему промпту при старте сессии. Отсюда главное правило: кладите туда только то, что полезно агенту при каждой операции. Структура проекта, инструкции по запуску тестов, конвенции именования — лишнее: агент сам найдёт package.json, pom.xml или Makefile. Добавляйте только то, что он с большой вероятностью не найдёт сам.
CLAUDE.md идёт дальше: поддерживает @-импорты других файлов (ленивая подгрузка), читает и CLAUDE.md, и CLAUDE.local.md одновременно, а .claude/rules/ позволяет грузить инструкции по маске файла — например, отдельные правила только для *.sql или только для определённой директории. Это держит корневой CLAUDE.md коротким. GEMINI.md импорты поддерживает, но local/override — нет.
Файл не должен быть статичным: если вы начали добавлять одну и ту же фразу в каждый промпт вручную — значит, пора внести её в файл. И наоборот: каждый раз, добавляя новое правило, перечитайте файл целиком и удалите устаревшее.
Видео канала letsCode, 10 минут.
#ai #claudecode #agents #llm #devtools