Proč chce šéf Shopify zakázat Claude Code kvůli souboru AGENTS.md

Shopify neřeší zákaz Claude Code kvůli tomu, že by soubor CLAUDE.md byl sám o sobě špatný. Problém je provozní: ve velké firmě mohou různé AI nástroje pracovat nad stejným repozitářem, ale řídit se odlišnými instrukcemi. CEO Shopify Tobi Lütke to označil za problém „rozdvojeného mozku“ a uvedl, že zvažuje zákaz Claude Code, dokud Anthropic nepřidá podporu AGENTS.md a .agents/skills. 415

Co je AGENTS.md

AGENTS.md je obyčejný soubor ve formátu Markdown, který AI programovacím agentům předává kontext konkrétního projektu. Může obsahovat například příkazy pro sestavení a testování kódu, pravidla pro jeho úpravy, týmové konvence nebo seznam adresářů, do kterých agent nemá zasahovat. Protože je uložený přímo v repozitáři, cestuje spolu s kódem a není svázaný s jedním konkrétním nástrojem. 2931

Konvence vznikla v širší spolupráci firem včetně Googlu, OpenAI, Sourcegraph, Factory a Cursoru. Dne 9. prosince 2025 OpenAI a Anthropic přispěly AGENTS.md spolu s další infrastrukturou do Agentic AI Foundation, organizace zastřešené Linux Foundation. Jejím cílem je neutrální správa otevřených a interoperabilních technologií pro AI agenty. 192829

AGENTS.md sice není povinným technickým standardem. Jeho rozšíření mu ale dává praktickou váhu: Linux Foundation uvádí, že byl přijat ve více než 60 000 open source projektech a agentních frameworkách, včetně Codexu, Cursoru, Devin, Factory, Gemini CLI, GitHub Copilotu, Jules a VS Code. 31

V čem Shopify vidí problém

Claude Code má podle vlastní dokumentace systém projektového kontextu založený především na souboru CLAUDE.md, adresáři .claude/rules, projektových dovednostech, hookách a nastavení. Tyto soubory může vyhledávat v aktuálním adresáři i v nadřazených adresářích, takže vytvářejí vlastní hierarchii instrukcí. 2

Pro jednotlivce to nemusí být zásadní komplikace. Ve velkém monorepozitáři, kde vedle sebe pracují Claude Code, Codex, Cursor, Gemini CLI nebo GitHub Copilot, je situace jiná. Pokud jeden nástroj načítá AGENTS.md a Claude Code očekává CLAUDE.md, může stejná složka nabídnout různým agentům jiné informace o:

• příkazech pro build a testy;
• týmových pravidlech pro psaní kódu;
• povolených pracovních postupech; nebo
• adresářích a souborech, kterých se agent nesmí dotýkat.

Výsledkem nemusí být jen duplicitní dokumentace. Jeden agent může použít nový příkaz pro testování, zatímco druhý sáhne po zastaralém. Jeden si všimne bezpečnostního omezení, druhý nikoli. Rozdíly se pak mohou projevit v úpravách kódu, code review i očekáváních vývojářů — právě v tom spočívá Lütkeho „split brain“ problém. 47

Proč dvě kopie instrukcí rychle přerostou v provozní náklad

Firma používající více agentů má v zásadě několik nepříliš pohodlných možností:

• udržovat současně AGENTS.md i CLAUDE.md v kořeni repozitáře;
• kopírovat odpovídající instrukce do relevantních podadresářů;
• hlídat, aby se obě hierarchie průběžně synchronizovaly; a
• vytvořit automatické kontroly, které odhalí jejich rozdíly.

V monorepozitáři se přitom pravidla mohou dědit z více úrovní. Jediná zapomenutá změna tak může způsobit, že různé týmy a nástroje dostanou rozdílný kontext. Shopify tento opakovaný náklad vnímá jako zbytečnou „daň za složitost“.

Ve veřejném požadavku na podporu AGENTS.md se popisuje konkrétní třecí plocha: pokud vývojář naklonuje repozitář obsahující AGENTS.md, Claude Code tento kontext ignoruje a uživatel musí vytvořit CLAUDE.md a instrukce do něj zkopírovat. 12

Jaké řešení nabízí Claude Code

Anthropic podle dostupných informací nabízí způsoby, jak společné instrukce do Claude Code dostat nepřímo. Jednou možností je odkázat na AGENTS.md uvnitř souboru CLAUDE.md; další variantou může být symbolický odkaz nebo jiný konfigurační most. 69

To může vyřešit okamžitý problém, ale nejde o stejný komfort jako u nativní podpory. Každá firma si musí nastavit vlastní způsob importu, pořadí instrukcí, jejich rozsah v podadresářích i pravidla aktualizací. Symbolické odkazy navíc mohou fungovat odlišně v různých operačních systémech, v Gitu, IDE, kontejnerech nebo firemních bezpečnostních prostředích.

Thariq Huq, který za Anthropic na diskusi reagoval, uvedl, že společnost pracuje na větší konfigurovatelnosti Claude Code. Ta má mimo jiné usnadnit používání AGENTS.md nebo úpravu dalších nastavení systémového promptu. 15 Z dostupných podkladů však nelze spolehlivě určit, proč Anthropic dosud nepřidal přímé rozpoznávání AGENTS.md; konkrétní motivy by proto byly pouze spekulací.

Proč je spor symbolický

Na celé věci je nápadné, že Anthropic se podílí na širším ekosystému Agentic AI Foundation, pod jejíž správu AGENTS.md patří, zatímco samotný Claude Code dál staví projektové instrukce na vlastních souborech. 22829

To automaticky neznamená, že Anthropic odmítá otevřené standardy. Výrobce může podporovat společný základ a současně si ponechat vlastní rozšíření pro funkce specifické pro jeho modely nebo produkt. Z pohledu velkého podnikového zákazníka je ale důsledek praktičtější než tato nuance: pokud je nutné společné instrukce nejprve přepisovat nebo propojovat, interoperabilita zůstává nedokonalá.

Co může spor znamenat pro AI nástroje pro vývojáře

Trvalá konfigurační daň

Každý proprietární strom instrukcí přináší další údržbu: duplicitní soubory, synchronizační kontroly, migrační skripty a testování. S každým novým agentem se zvyšuje počet kombinací, které musí firma podporovat.

Silnější tlak proti vendor lock-inu

Instrukční soubory často obsahují týmové postupy, bezpečnostní hranice, znalost provozu i pravidla práce s kódem. Pokud jsou nejlépe použitelné v jednom ekosystému, zdražuje se přechod ke konkurenci i souběžné používání více nástrojů. Společný formát tyto náklady snižuje a dává firmám větší volnost při výběru dodavatelů.

Pravděpodobný model dvou vrstev

Nejpraktičtějším výsledkem nemusí být úplné nahrazení všech proprietárních konvencí jedním formátem. AGENTS.md může sloužit jako přenosný základ pro obecná projektová pravidla, zatímco CLAUDE.md a podobné soubory nabídnou nepovinná rozšíření specifická pro konkrétní nástroj.

Takový model by zachoval prostor pro odlišení produktů, aniž by základní kontext projektu zůstal uzamčený u jediného dodavatele.

Velcí zákazníci mohou určovat standardy

Lütkeho veřejná kritika ukazuje, jak může velký zákazník proměnit zdánlivě drobnou žádost o kompatibilitu v podmínku nasazení. Pokud budou firmy typu Shopify považovat podporu více nástrojů za součást podnikové připravenosti, výrobci budou muset interoperabilitu vnímat jako produktový požadavek, nikoli jen jako komunitní bonus.

Závěr

Shopify nezvažuje zákaz Claude Code proto, že by CLAUDE.md byl ze své podstaty horší než AGENTS.md. Jádrem stížnosti je cena proprietárního výchozího formátu ve chvíli, kdy tisíce vývojářů používají několik AI agentů nad jednou kódovou základnou.

Rozšíření AGENTS.md, jeho správa pod Linux Foundation a podpora v hlavních nástrojích z něj dělají důvěryhodnou sdílenou vrstvu. 2931 Importy a symbolické odkazy mohou posloužit jako nouzové řešení, ale integrační práci přesouvají na jednotlivé firmy.

Ve skutečnosti se tak nevede spor o jednu příponu nebo jeden název souboru. Rozhoduje se o tom, zda se AI programovací agenti stanou interoperabilní infrastrukturou, nebo uzavřenými platformami, jejichž projektové znalosti bude nutné pro každý nástroj znovu upravovat.