AGENTS.md
и CLAUDE.md
Это файлы-инструкции для ИИ-агента кодинга: постоянные правила и память проекта. Агент читает их в начале работы и держит как контекст - что за проект, как собирать и тестировать, какой стиль кода, что можно и чего делать нельзя. Гайд объясняет, где такой файл лежит, как агент его читает, что писать внутри и чем AGENTS.md отличается от CLAUDE.md.
Один файл - меньше косяков. Не нужно повторять агенту одно и то же в каждой сессии: он сразу знает проект и работает по вашим правилам.
что внутри
главы гайда
Что такое файл инструкций агента
AGENTS.md и CLAUDE.md - постоянные правила и память проекта для ИИ-агента. Зачем нужны и как связаны со скиллами и правами агента.
Как агент это читает
Где лежит файл (корень репо, вложенные папки, глобальный в ~/), иерархия и перекрытие, когда читается и почему это часть контекста.
Что писать внутри
Команды сборки/тестов/линта, стиль и соглашения, структура проекта, ограничения и грабли, как проверять результат. Коротко и по делу.
AGENTS.md против CLAUDE.md
CLAUDE.md - формат Claude Code. AGENTS.md - открытый стандарт (Codex, Cursor, Gemini CLI). По сути одно и то же; приём с симлинком, чтобы один файл работал везде.
Пример: CLAUDE.md по Карпатому
Разбор популярного короткого CLAUDE.md из 4 правил против типичных ошибок ИИ в коде: think before coding, simplicity first, surgical changes, goal-driven execution.
Шаблон и шпаргалка
Готовый стартовый AGENTS.md, чек-лист хорошего файла инструкций и словарь терминов на одной странице.