Современный мир программирования активно внедряет интеллектуальные ассистенты, которые помогают разработчикам писать код быстрее и эффективнее. С появлением таких инструментов, как Claude Code, Gemini CLI, OpenAI Codex и других, возникла потребность стандартизировать способ подключения контекстной информации к запросам, которые отправляются языковым моделям. Один из ключевых элементов этого процесса — контекстный файл, содержащий важные инструкции и информацию, усиливающую работу ассистента. Летом 2025 года сообщество агентного программирования сделало значительный шаг в сторону стандартизации — было принято решение использовать файл с именем AGENTS.md как универсальный контекстный файл для различных ассистентов.
Опыт и традиции воплотивших контекстные файлы инструментов легли в основу этого решения, позволяя оптимизировать рабочий процесс, улучшить взаимодействие и поднять качество автоматизации программирования. Идея создания контекстных файлов широко популяризировалась компанией Anthropic с запуском их ассистента Claude Code. Особенность этой системы заключается в том, что при запуске в директории Claude Code автоматически загружает файл CLAUDE.md и добавляет его содержимое к отправляемому запросу нейросети. Эта концепция оказалась чрезвычайно успешной и удобной — при правильной настройке контекстных файлов качество работы виртуального помощника значительно повышается.
Это создает позитивную обратную связь: чем эффективнее ассистент, тем чаще он используется, а значит, появляется больше возможностей для улучшения и доработки контекста. Кроме того, внимание к файлам с названием CLAUDE.md становилось своеобразной рекламой для самого Anthropic, поскольку их файлы распространялись в открытых проектах. Однако с увеличением числа агентных помощников подобный подход породил проблему: у каждого ассистента был свой формат имени файла и неверифицированные рекомендации по его содержанию. Разные системы использовали различные имена: AMP применял AGENT.
md без буквы «S», OpenAI Codex предпочитал AGENTS.md во множественном числе, Claude Code — CLAUDE.md, Gemini CLI — GEMINI.md, а другие ассистенты загружали контекст из специализированных папок с правилами, таких как .cursor/rules у Cursor и .
roorules/rules у Roo. Это многоголосие усложняло интеграцию и снижало удобство для разработчиков, поскольку одному проекту приходилось поддерживать разные контекстные файлы ради совместимости с различными помощниками. Учитывая этот разрыв, сообщество агентных кодировщиков столкнулось с задачей выработать совместный стандарт, который позволил бы использовать единый универсальный контекстный файл для всех ассистентов, желающих играть по общим правилам экосистемы. Кроме того, появление стандарта обеспечило бы возможность централизованно поддерживать и улучшать инструкции для моделей, применяя лучшие практики, которые работают для большинства инструментариев. Возникшие варианты — AGENT.
md и AGENTS.md — оказались наиболее очевидными кандидатами, ведь эти названия подходили под концепцию универсального контекста, без привязки к конкретному бренду. В мае 2025 года представитель AMP предложил выбрать AGENT.md как универсальное имя для файла, при этом на домене agent.md собирались публиковать рекомендации и гайды.
Тем не менее, вскоре OpenAI приобрели домен agents.md, чтобы предложить свою версию лучших практик. В ответ AMP согласился перейти к единообразному использованию AGENTS.md, предоставив перекрестные ссылки, что помогло устранить конкуренцию и разногласия. Уже в июле того же года Roo Code обновил свой софт, добавив поддержку AGENTS.
md, а AMP перенаправляет сайт agent.md на agents.md от OpenAI. Таким образом, AGENTS.md стал общепризнанным стандартом для хранения контекстной информации в проектной директории.
Для тех, кто по каким-либо причинам хочет сохранить проприетарные варианты, предлагается использовать символьные ссылки, которые создаются командой типа ln -s AGENTS.md CLAUDE.md или ln -s AGENTS.md GEMINI.md.
Таким образом, разные ассистенты смогут подхватывать одинаковый контекстный файл, несмотря на собственные предустановленные имена файлов. Преимущества использования AGENTS.md очевидны. Во-первых, это упрощает жизнь разработчикам, которые могут создать и поддерживать один файл с рекомендациями и поручениями для любыми доступными ассистентами. Во-вторых, единый контекстный файл облегчает совместную работу в командах, где участники используют разные средства для автоматизации кода.
В-третьих, совместный стандарт способствует развитию сообщества, где лучшие практики регулярно обсуждаются и обновляются с учетом новых возможностей и изменений в языковых моделях. Важный следующий шаг для сообщества — определить универсальные руководства и рекомендации для содержимого AGENTS.md. Формат файла — это только первый уровень стандартизации. Гораздо важнее понять, какой тип инструкций, ограничений и примеров следует в нем размещать, чтобы помочь ассистентам лучше понимать задачи и разработки проекта.
Такие рекомендации могут включать в себя описание архитектуры проекта, предпочтительные стили кодирования, ключевые зависимости и даже запреты на использование определенных библиотек или фреймворков. Создание единого набора правил и практик позволит обеспечить высочайшее качество взаимодействия с агентами, сделать их работу предсказуемой и полезной для большинства пользователей. В целом, выбор AGENTS.md как основного контекстного файла — важное событие для индустрии. Он упрощает интеграцию множества ассистентов, поддерживает открытость и готовность к совместной работе, что крайне важно в эпоху стремительного роста искусственного интеллекта.
Сейчас самое время разработчикам и организациям внедрять новый стандарт в свои рабочие процессы и активно участвовать в обсуждении лучших известных практик для написания содержимого AGENTS.md. Такой подход поможет сформировать общую культуру и продвинуть уровень программирования на качественно новый уровень, где агенты действительно станут надежными помощниками в повседневных задачах.
