раздел 03

AGENTS.md против CLAUDE.md

Это почти одно и то же - простой markdown с правилами для агента. Разница в том, какой инструмент какой файл ищет по умолчанию.

CLAUDE.md - формат Claude Code

Читает Claude Code (Anthropic). Глобальный ~/.claude/CLAUDE.md и проектный ./CLAUDE.md. Команда /init создаёт черновик.

AGENTS.md - открытый стандарт

Стандарт agents.md, который читают Codex (OpenAI), Cursor, Gemini CLI и многие другие. Один формат под разные инструменты.

По сути - одно и то же

Содержимое идентично: команды, стиль, структура, ограничения, проверка (см. предыдущий раздел). Меняется только имя файла, которое ищет конкретный инструмент.

Как покрыть всех одним файлом

Чтобы не вести два файла, делают основным AGENTS.md, а CLAUDE.md - символической ссылкой на него:

# в корне репозитория
ln -s AGENTS.md CLAUDE.md

Теперь правки в одном файле видят и Claude Code, и Codex, и Cursor. Если символические ссылки неудобны (например, проблемы на Windows), просто держите два файла с одинаковым содержимым или дублируйте при изменениях.