Dlaczego CEO Shopify grozi zakazem Claude Code z powodu AGENTS.md

Groźba zablokowania Claude Code w Shopify to nie kłótnia o rozszerzenie pliku. To spór o to, kto ma utrzymywać instrukcje dla agentów AI pracujących na tym samym kodzie.

CEO Shopify Tobi Lütke napisał 25 sierpnia 2026 r., że rozważa zakaz używania Claude Code w firmie, dopóki Anthropic nie zmieni podejścia i nie doda obsługi AGENTS.md, .agents/skills oraz powiązanych konwencji. Jego zdaniem trzymanie się wyłącznie CLAUDE.md prowadzi czasem do „split brain”, czyli sytuacji, w której różni członkowie zespołu korzystający z różnych narzędzi dostają odmienne instrukcje dotyczące tego samego projektu. 415

O co chodzi z AGENTS.md?

AGENTS.md to zwykły plik Markdown umieszczany w repozytorium. Może zawierać informacje o tym, jak zbudować i przetestować projekt, jakich konwencji przestrzegać, których katalogów nie modyfikować oraz jakie zasady obowiązują przy wprowadzaniu zmian. Dzięki temu instrukcje są przechowywane razem z kodem, a nie przypisane do konkretnego narzędzia lub komputera programisty. 2931

Konwencja wyrosła ze współpracy branżowej obejmującej m.in. Google, OpenAI, Sourcegraph, Factory i Cursor. 9 grudnia 2025 r. OpenAI i Anthropic przekazały AGENTS.md do Agentic AI Foundation — fundacji działającej pod auspicjami Linux Foundation, której celem jest neutralne zarządzanie otwartą infrastrukturą dla agentów AI. 192829

Nie oznacza to, że AGENTS.md jest obowiązkowym standardem technicznym. Jego znaczenie wynika jednak ze skali użycia. Linux Foundation podaje, że format przyjęło już ponad 60 tys. projektów open source i frameworków, a także narzędzia takie jak Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules i VS Code. 31

Dlaczego Shopify widzi w tym problem operacyjny?

Claude Code ma własny system kontekstu projektu oparty na CLAUDE.md, regułach w .claude/rules, skills, hookach i ustawieniach. Dokumentacja opisuje także wyszukiwanie tych plików w bieżącym katalogu oraz katalogach nadrzędnych, co tworzy hierarchiczny, rekurencyjny system instrukcji. 2

Dla jednej osoby pracującej nad małym projektem nie musi to być duży kłopot. W rozbudowanym monorepo, czyli wspólnym repozytorium zawierającym kod wielu zespołów, sytuacja wygląda inaczej. Programiści mogą równolegle używać Claude Code, Codex, Cursor, Gemini CLI czy GitHub Copilot. Jeśli część tych narzędzi odczytuje AGENTS.md, a Claude Code szuka przede wszystkim CLAUDE.md, ten sam katalog może przekazywać agentom różne zasady.

Firma korzystająca z wielu agentów ma wtedy kilka mało atrakcyjnych opcji:

• utrzymywać jednocześnie AGENTS.md i CLAUDE.md w katalogu głównym;
• powielać te pliki w odpowiednich podkatalogach;
• ręcznie synchronizować ich treść po każdej zmianie projektu;
• budować automatyczne kontrole wykrywające rozbieżności.

Błąd w synchronizacji to coś więcej niż bałagan w dokumentacji. Jeden agent może znać nową komendę testową, a drugi używać nieaktualnej. Jeden może wiedzieć, że określonego katalogu nie wolno modyfikować, podczas gdy drugi nie zobaczy takiego ograniczenia. Efektem są niespójne zmiany w kodzie, różne wyniki przeglądów i odmienne oczekiwania zespołu — właśnie „split brain”, o którym mówi Lütke. 47

Publiczne zgłoszenie funkcji w repozytorium Claude Code opisuje ten problem wprost: gdy sklonowane repozytorium zawiera AGENTS.md, Claude Code może pominąć jego kontekst, zmuszając programistę do utworzenia CLAUDE.md i skopiowania instrukcji. 12

Jakie obejścia proponuje Anthropic?

Najprostszym rozwiązaniem jest odwołanie do wspólnego pliku z poziomu CLAUDE.md, na przykład przez import AGENTS.md. Inną stosowaną metodą jest dowiązanie symboliczne lub inny most konfiguracyjny. 69

Takie rozwiązania mogą usunąć natychmiastowy problem, ale nie dają takiej wygody jak natywna obsługa. Każda organizacja musi sama ustalić, jak mają działać importy, kolejność instrukcji, zakres obowiązywania reguł i ich aktualizowanie. Dowiązania symboliczne mogą też zachowywać się różnie w zależności od systemu operacyjnego, ustawień Git, środowiska IDE, kontenerów i firmowych zasad bezpieczeństwa.

Thariq, pracownik Anthropic, napisał w publicznej dyskusji, że firma pracuje nad uczynieniem Claude Code bardziej konfigurowalnym. Ma to obejmować łatwiejsze korzystanie z AGENTS.md oraz modyfikowanie innych ustawień system promptu. 15 Dostępne materiały nie wyjaśniają jednoznacznie, dlaczego natywna obsługa nie została dotąd dodana, dlatego przypisywanie Anthropic konkretnej motywacji byłoby spekulacją.

Dlaczego sprawa jest niezręczna dla Anthropic?

Spór zwraca uwagę na pozorną sprzeczność. Anthropic współtworzy szerszy ekosystem Agentic AI Foundation, w którym AGENTS.md ma być zarządzany neutralnie pod egidą Linux Foundation. Jednocześnie dokumentacja Claude Code nadal koncentruje się na plikach i rozszerzeniach specyficznych dla Anthropic. 22829

Nie musi to oznaczać sprzeciwu firmy wobec otwartych standardów. Dostawca może wspierać wspólną bazę, a jednocześnie zachowywać własne rozszerzenia związane z konkretnymi modelami lub funkcjami produktu. Z perspektywy dużego klienta różnica jest jednak mniej istotna, jeśli podstawowe instrukcje trzeba najpierw przepisać albo połączyć specjalnym obejściem.

Co ten konflikt oznacza dla rynku narzędzi AI?

Stały „podatek konfiguracyjny”

Każdy dostawca z własnym drzewem instrukcji zwiększa koszty utrzymania: pojawiają się zduplikowane pliki, skrypty synchronizujące, testy i kontrole poprawności. Im więcej agentów wdraża organizacja, tym więcej takich kombinacji musi obsługiwać.

Większa presja na ograniczenie uzależnienia od dostawcy

Pliki z instrukcjami mogą zawierać firmowe zasady pracy, reguły bezpieczeństwa, procedury i wiedzę operacyjną. Jeśli najlepiej działają tylko w formacie jednego producenta, zmiana narzędzia lub korzystanie z kilku produktów naraz staje się droższe. Wspólny format obniża koszt zmiany dostawcy i wzmacnia pozycję działów technicznych podczas zakupów.

Najbardziej prawdopodobny model dwóch warstw

Nie jest konieczne, by jeden format całkowicie zastąpił wszystkie konwencje producentów. Bardziej praktyczny wydaje się model, w którym AGENTS.md przechowuje przenośne instrukcje dotyczące projektu, a CLAUDE.md i podobne pliki zawierają opcjonalne rozszerzenia specyficzne dla danego narzędzia.

Taki układ pozwala dostawcom zachować funkcje wyróżniające ich produkty, bez odbierania firmom jednego, wspólnego źródła podstawowego kontekstu repozytorium.

Duzi klienci mogą ustalać standardy

Reakcja Lütkego pokazuje, że pojedyncza prośba o kompatybilność może stać się wymaganiem na poziomie całego przedsiębiorstwa. Jeśli firmy wielkości Shopify zaczną uzależniać wdrożenia od obsługi wspólnych formatów, interoperacyjność przestanie być dodatkiem dla społeczności open source, a stanie się elementem gotowości produktu do pracy w środowisku korporacyjnym.

Wniosek

Shopify nie grozi zablokowaniem Claude Code dlatego, że CLAUDE.md jest z definicji gorszy od AGENTS.md. Problem polega na tym, że własny format Anthropic staje się kosztowny w organizacji, w której wielu programistów korzysta z kilku agentów na tej samej bazie kodu.

Szerokie wykorzystanie AGENTS.md, jego neutralne zarządzanie w ramach Linux Foundation oraz wsparcie wielu dużych narzędzi czynią z niego wiarygodną wspólną warstwę. 2931 Importy i dowiązania symboliczne mogą działać jako rozwiązanie tymczasowe, ale przenoszą ciężar integracji na każdą organizację.

W tle tego sporu kryje się większe pytanie: czy agenty programistyczne staną się interoperacyjną infrastrukturą, czy raczej zamkniętymi platformami, dla których wiedzę o projekcie trzeba będzie dostosowywać osobno do każdego narzędzia?