Shopify против Claude Code: спор из-за AGENTS.md оказался вопросом совместимости

Это не спор о названии одного Markdown-файла. Для Shopify речь идёт о том, как крупной инженерной организации управлять несколькими ИИ-агентами в одном кодовом репозитории.

CEO Shopify Тоби Лютке заявил, что рассматривает возможность запретить Claude Code в компании, пока Anthropic не изменит подход и не добавит поддержку AGENTS.md, .agents/skills и других общих соглашений. По его словам, требование Claude Code использовать только CLAUDE.md иногда приводит к «раздвоению» правил: разные сотрудники работают с разными инструментами, а агенты получают неодинаковый контекст. 415

Что такое AGENTS.md

AGENTS.md — обычный файл в формате Markdown, который хранится вместе с исходным кодом. В нём можно описать команды сборки и тестирования, правила оформления кода, ограничения для отдельных каталогов и требования к внесению изменений. Благодаря этому инструкции становятся частью самого репозитория, а не настройкой конкретного разработчика или поставщика инструмента. 2931

Формат возник в экосистеме OpenAI Codex в рамках более широкой отраслевой работы с участием Google, OpenAI, Sourcegraph, Factory и Cursor. 9 декабря 2025 года OpenAI и Anthropic передали AGENTS.md в Agentic AI Foundation — фонд под эгидой Linux Foundation, призванный поддерживать открытые и совместимые технологии для ИИ-агентов. 192829

По данным Linux Foundation, AGENTS.md уже приняли более 60 000 open-source проектов и агентских фреймворков. Среди поддерживающих его инструментов называются Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules и VS Code. 31

Это ещё не делает формат обязательным техническим стандартом. Но на практике он превращается в общий переносимый слой: команда может один раз записать базовые правила проекта и рассчитывать, что их прочитают разные инструменты.

Почему Claude Code стал проблемой для монорепозитория

Claude Code использует собственную систему контекста проекта: CLAUDE.md, .claude/rules, project skills, hooks и настройки. Документация Anthropic описывает рекурсивный поиск таких файлов в текущем каталоге и родительских директориях вплоть до корня репозитория. 2

Для одного разработчика это может быть вполне приемлемо. Но в большом монорепозитории, где параллельно работают Claude Code, Codex, Cursor, Gemini CLI или GitHub Copilot, появляются менее удобные варианты:

• хранить одновременно AGENTS.md и CLAUDE.md в корне проекта;
• дублировать их в нужных подкаталогах;
• постоянно синхронизировать две иерархии инструкций;
• добавлять проверки, которые выявляют расхождения между файлами.

Если обновить только один файл, последствия могут быть не только косметическими. Один агент начнёт использовать новую команду для тестов, а другой — устаревшую. Один увидит запрет на изменение определённого каталога, а другой — нет. В результате меняются не только подсказки, но и сами правки, результаты проверки кода и ожидания команды. Именно это Лютке называет проблемой «раздвоения сознания» — split brain. 47

Публичная заявка на поддержку AGENTS.md в репозитории Claude Code описывала ту же проблему: если разработчик клонирует проект с уже существующим AGENTS.md, Claude Code может проигнорировать этот контекст, вынуждая вручную создавать CLAUDE.md и копировать инструкции. 12

Какие обходные пути предлагает Claude Code

Существующие способы интеграции переносят общие инструкции в нативную конфигурацию Claude Code. Например, в CLAUDE.md можно добавить ссылку на содержимое AGENTS.md. Также применяются символические ссылки и другие конфигурационные «мосты». 69

Для локального проекта этого может быть достаточно, однако для компании такой подход не равнозначен нативной поддержке. Он требует дополнительной настройки каждого репозитория и оставляет команде вопросы о порядке импорта, приоритетах, области действия инструкций и синхронизации изменений.

Символические ссылки также могут по-разному вести себя в Windows, Git, IDE, контейнерах и корпоративных системах безопасности. В итоге интеграционная работа ложится на саму организацию, а не на разработчика инструмента.

Представитель Anthropic Тарик Шакир сообщил, что компания работает над тем, чтобы сделать Claude Code более гибким: в частности, упростить использование AGENTS.md и изменение других параметров системного промпта. 15 При этом доступные материалы не дают однозначного публичного объяснения, почему нативная поддержка пока не добавлена, поэтому любые утверждения о мотивах Anthropic остаются предположениями.

Почему позиция Anthropic выглядит противоречиво

Ситуация особенно примечательна тем, что Anthropic участвует в экосистеме Agentic AI Foundation, где AGENTS.md развивается под нейтральным управлением Linux Foundation. Одновременно документация Claude Code по-прежнему строится вокруг файлов Anthropic — CLAUDE.md и .claude. 22829

Это не обязательно означает, что Anthropic выступает против открытых стандартов. Компания может поддерживать общий базовый формат и одновременно сохранять собственные расширения для функций, связанных с её моделями и продуктом. Но для корпоративного заказчика разница невелика, если общие инструкции всё равно приходится переписывать или подключать через обходные решения.

Что спор может изменить на рынке ИИ-инструментов для разработчиков

«Налог» на конфигурацию

Каждый отдельный формат означает дополнительную работу: дублирование файлов, проверки синхронизации, скрипты миграции и тестирование. Чем больше ИИ-агентов использует компания, тем выше стоимость поддержки нескольких деревьев инструкций.

Давление на вендорную зависимость

Файлы с правилами часто содержат не только команды сборки, но и внутренние процессы, требования безопасности и накопленные инженерные знания. Если всё это лучше всего работает в формате одного поставщика, переход на другой инструмент или параллельное использование нескольких решений становится дороже.

Общий формат снижает стоимость смены поставщика и даёт крупным компаниям больше влияния при выборе корпоративных инструментов.

Вероятный двухуровневый подход

Наиболее практичным решением может стать не отказ от всех фирменных форматов, а разделение их ролей. AGENTS.md может содержать переносимые правила проекта, а CLAUDE.md и аналогичные файлы — дополнительные функции конкретного продукта.

Такой подход оставляет поставщикам пространство для отличий, но не превращает базовый контекст проекта в закрытую систему.

Крупные заказчики становятся разработчиками стандартов

Заявление Лютке показывает, как требование одного крупного клиента может превратиться в продуктовый приоритет. Если компании вроде Shopify начнут включать поддержку общих форматов в условия внедрения, совместимость станет частью корпоративной готовности продукта, а не второстепенной функцией для сообщества.

Итог

Shopify угрожает запретить Claude Code не потому, что CLAUDE.md сам по себе хуже AGENTS.md. Проблема в другом: фирменный формат становится источником лишних расходов, когда тысячи инженеров используют несколько ИИ-агентов в одном кодовом пространстве.

Широкое распространение AGENTS.md, его передача под управление Linux Foundation и поддержка со стороны крупных инструментов делают формат убедительным кандидатом на роль общего слоя. 2931 Импорты и символические ссылки позволяют временно обойти несовместимость, но перекладывают интеграционные издержки на каждую компанию.

В конечном счёте спор ставит более широкий вопрос: станут ли ИИ-агенты частью совместимой инфраструктуры разработки — или превратятся в закрытые платформы, для которых знания о проекте придётся адаптировать отдельно под каждый инструмент.