Waarom Shopify-CEO Tobi Lütke Claude Code mogelijk wil verbieden vanwege AGENTS.md

Shopify dreigt Claude Code niet te weren omdat de bestandsnaam CLAUDE.md op zichzelf verkeerd zou zijn. Het conflict gaat over iets fundamentelers: wie de projectinstructies beheert wanneer honderden of duizenden ontwikkelaars meerdere AI-programmeerassistenten gebruiken.

Shopify-CEO Tobi Lütke schreef op 25 augustus 2026 dat hij overweegt Claude Code binnen het bedrijf te verbieden totdat Anthropic bereid is AGENTS.md, .agents/skills en vergelijkbare gedeelde conventies te lezen. Hij waarschuwde dat Claude Codes keuze voor uitsluitend CLAUDE.md soms leidt tot “split brain”: verschillende teamleden werken in dezelfde codebase met verschillende instructies. 415

Waar maakt Shopify bezwaar tegen?

AGENTS.md is een eenvoudig Markdown-bestand in een softwareproject. Het kan uitleggen hoe de code wordt gebouwd en getest, welke programmeerconventies gelden en welke mappen of bestanden niet mogen worden aangepast. Omdat het bestand naast de broncode in de repository staat, blijven de instructies gekoppeld aan het project en niet aan één specifieke AI-tool. 2931

Claude Code gebruikt volgens de documentatie vooral CLAUDE.md, .claude/rules, projectspecifieke skills, hooks en instellingen. Die bestanden kunnen in de huidige map en in bovenliggende mappen worden gevonden, waardoor Claude Code zijn eigen hiërarchische instructiesysteem opbouwt. 2

Voor een individuele ontwikkelaar hoeft dat geen groot probleem te zijn. In een groot monorepo — één repository met code van veel teams en projecten — wordt het ingewikkelder. Een organisatie kan daar bijvoorbeeld Claude Code naast Codex, Cursor, Gemini CLI of GitHub Copilot gebruiken. Als de ene tool AGENTS.md leest en de andere alleen CLAUDE.md, kunnen ze in dezelfde map verschillende bouwcommando’s, stijlregels of veiligheidsgrenzen zien.

Waarom twee bestanden meer zijn dan dubbele documentatie

Een bedrijf dat meerdere AI-agents gebruikt, staat dan voor een weinig aantrekkelijke keuze:

• zowel AGENTS.md als CLAUDE.md onderhouden;
• die bestanden ook in relevante submappen dupliceren;
• beide versies bij elke wijziging synchroon houden; en
• controles of scripts bouwen om verschillen tussen de bestanden op te sporen.

Een gemiste update is niet alleen een administratieve fout. De ene agent kan een nieuw testcommando volgen terwijl een andere een verouderde opdracht gebruikt. Eén tool kan zien dat een bepaalde map niet mag worden gewijzigd, terwijl een andere die beperking niet meekrijgt. Dat kan leiden tot uiteenlopende codewijzigingen, reviews en verwachtingen van ontwikkelaars: precies het “split-brain”-probleem waar Lütke op wijst. 47

In een publiek featureverzoek voor Claude Code werd de praktische frictie expliciet beschreven. Wanneer een repository al AGENTS.md bevat, kan Claude Code die context negeren. De ontwikkelaar moet dan handmatig een CLAUDE.md aanmaken en de instructies dupliceren. 12

Hoe AGENTS.md een inzet werd van interoperabiliteit

AGENTS.md ontstond als een open conventie rond het Codex-ecosysteem van OpenAI. Aan de ontwikkeling ervan werkte een bredere groep bedrijven mee, waaronder Google, OpenAI, Sourcegraph, Factory en Cursor. 1931

Op 9 december 2025 brachten OpenAI en Anthropic AGENTS.md en andere infrastructuur voor AI-agents onder bij de Agentic AI Foundation, een initiatief onder de Linux Foundation. Die stichting moet open en interoperabele technologie voor agents onder neutraal beheer ondersteunen, in plaats van bij één commerciële leverancier. 2829

De adoptie geeft de discussie extra gewicht. Volgens de Linux Foundation was AGENTS.md al overgenomen door meer dan 60.000 opensourceprojecten en agentframeworks, waaronder Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules en VS Code. 31

Dat maakt AGENTS.md nog geen verplicht technisch standaardformaat. Het is wel een breed gebruikte draagbaarheidslaag: teams kunnen projectinstructies op één zichtbare, versiebeheerde plek opslaan en verwachten dat meerdere tools ze herkennen.

Welke oplossing biedt Claude Code momenteel?

De gedocumenteerde omweg is om gedeelde instructies via de eigen configuratie van Claude Code te laden. Zo kan CLAUDE.md verwijzen naar AGENTS.md. Een andere gemelde aanpak is het gebruik van een symbolische link of een vergelijkbare configuratiebrug. 69

Daarmee kan de directe incompatibiliteit worden verminderd, maar het is niet hetzelfde als ingebouwde ondersteuning. Elke organisatie moet dan zelf bepalen hoe imports, prioriteiten, mapbereiken en updates werken. Symbolische links kunnen bovendien anders uitpakken op verschillende besturingssystemen en in combinatie met Git-instellingen, IDE’s, containers en beveiligingsbeleid van bedrijven.

Anthropic-medewerker Thariq reageerde dat het bedrijf Claude Code beter aanpasbaar wil maken. Daaronder zou ook vallen dat gebruikers gemakkelijker AGENTS.md kunnen inzetten of andere instellingen voor de systeemprompt kunnen wijzigen. 15 De beschikbare informatie geeft geen definitieve technische of commerciële reden waarom Claude Code het formaat niet rechtstreeks herkent. Uitspraken over de precieze motivatie van Anthropic blijven daarom speculatief.

Een opvallende tegenstelling

De kwestie valt extra op omdat Anthropic betrokken is bij het bredere ecosysteem van de Agentic AI Foundation, terwijl Claude Codes eigen projectconventies volgens de documentatie nog steeds rond Anthropic-specifieke bestanden draaien. 22829

Dat betekent niet automatisch dat Anthropic open standaarden afwijst. Een leverancier kan een open basis ondersteunen en tegelijk eigen uitbreidingen behouden voor functies die specifiek zijn voor zijn modellen of product. Voor zakelijke klanten is dat onderscheid echter minder belangrijk wanneer de kerninstructies alsnog moeten worden herschreven of verbonden voordat een andere tool ze kan gebruiken.

Wat staat er op het spel voor AI-tools?

Een terugkerende configuratiebelasting

Elke leveranciersspecifieke instructiestructuur brengt onderhoud met zich mee: dubbele bestanden, synchronisatiecontroles, migratiescripts en tests. Naarmate organisaties meer coding agents inzetten, groeit die belasting mee met het aantal tools en repositorybereiken.

Meer druk om vendor lock-in te beperken

Repository-instructies bevatten vaak teamafspraken, beveiligingsgrenzen, workflows en operationele kennis. Als die informatie het best werkt in het formaat van één leverancier, wordt overstappen of het parallel gebruiken van meerdere tools duurder. Een gedeeld formaat verlaagt die overstapkosten en geeft technische managers meer ruimte bij inkoopbeslissingen.

Waarschijnlijk een model met twee lagen

De meest praktische uitkomst is waarschijnlijk niet dat elk propriëtair bestand verdwijnt. Een gemeenschappelijke basis zoals AGENTS.md kan algemene projectinstructies bevatten, terwijl CLAUDE.md of andere leveranciersbestanden optionele uitbreidingen bieden. Zo blijft ruimte voor productverschillen zonder dat de basiscontext van een project aan één tool vastzit.

Grote klanten bepalen de standaard

De reactie van Lütke laat zien hoe een grote klant een ogenschijnlijk kleine compatibiliteitsvraag kan veranderen in een harde producteis. Als bedrijven zoals Shopify ondersteuning voor meerdere tools als voorwaarde stellen, zullen leveranciers interoperabiliteit mogelijk moeten behandelen als onderdeel van zakelijke productkwaliteit — niet als een extraatje voor de opensourcegemeenschap.

De kern van het conflict

Shopify overweegt Claude Code niet te weren omdat CLAUDE.md inherent slechter zou zijn dan AGENTS.md. Het bezwaar is dat een leveranciersspecifieke standaard duur en foutgevoelig wordt zodra veel ontwikkelaars meerdere agents op dezelfde codebase loslaten.

Door de brede adoptie, de governance via de Linux Foundation en de ondersteuning door grote coding tools heeft AGENTS.md zich ontwikkeld tot een geloofwaardige gedeelde laag. 2931 Imports en symbolische links kunnen als noodoplossing werken, maar leggen de integratielast bij elke organisatie.

De grotere vraag is daarom of AI-programmeerassistenten uitgroeien tot interoperabele ontwikkelinfrastructuur — of tot gesloten platforms waarvan de projectkennis voor elke tool opnieuw moet worden aangepast.