Shopify saattaa kieltää Claude Coden – kiista koskee yhtä Markdown-tiedostoa

Shopifyn uhkaus ei oikeastaan koske tiedostonimeä. Taustalla on standardi- ja toimintamallikiista: Tobi Lütken mukaan Claude Coden pitäytyminen omassa CLAUDE.md-käytännössään voi aiheuttaa niin sanotun ”aivojen jakautumisen” eli split brain -tilanteen, kun insinöörit käyttävät samassa koodivarastossa useita tekoälypohjaisia ohjelmointityökaluja. Hänen näkemyksensä on, että suuren teknologiayrityksen pitäisi ylläpitää yhtä yhteistä agenttiohjeistusta, ei erillistä versiota jokaiselle toimittajalle. 415

Mitä Shopify vastustaa?

AGENTS.md on tavallinen Markdown-tiedosto, johon voidaan kirjata projektikohtaiset ohjeet tekoälyagenteille: miten koodi rakennetaan ja testataan, mitä ohjelmointikäytäntöjä noudatetaan ja mitä hakemistoja tai tiedostoja ei saa muuttaa. Tiedosto tallennetaan koodivaraston yhteyteen, jolloin ohjeet kulkevat versionhallinnassa koodin mukana eivätkä ole sidottuja yksittäiseen työkaluun tai kehittäjään. 2931

Claude Coden dokumentaatiossa projektin konteksti taas rakentuu ensisijaisesti CLAUDE.md-tiedostoista, .claude/rules-säännöistä, projektin skill-toiminnoista, hookeista ja asetuksista. Tiedostoja voidaan etsiä nykyisestä hakemistosta ja sen yläpuolisista hakemistoista, joten myös Claude Codella on oma rekursiivinen ohjejärjestelmänsä. 2

Yksittäiselle kehittäjälle ero voi olla helppo kiertää. Suuressa monorepossa, jossa käytetään rinnakkain esimerkiksi Claude Codea, Codexia, Cursoria, Gemini CLI:tä tai GitHub Copilotia, seuraukset ovat suuremmat. Jos yksi työkalu lukee AGENTS.md:n ja toinen vain CLAUDE.md:n, sama hakemisto voi tarjota agenteille erilaiset testikomennot, koodausohjeet tai rajaukset.

Miksi monorepon ongelma ei ole vain päällekkäistä dokumentaatiota?

Yrityksellä on käytännössä muutama hankala vaihtoehto:

• ylläpitää sekä AGENTS.md- että CLAUDE.md-tiedostoa projektin juuressa;
• toistaa sama rakenne tarpeellisissa alihakemistoissa;
• pitää tiedostot synkronoituna koodipohjan muuttuessa; ja
• rakentaa tarkistuksia, jotka etsivät ohjeiden välisiä eroja.

Unohtunut päivitys ei ole pelkkä dokumentointivirhe. Yksi agentti saattaa noudattaa uutta testikomentoa, kun taas toinen käyttää vanhentunutta komentoa. Yksi voi tietää, ettei tiettyyn hakemistoon saa koskea, kun taas toinen ei näe rajoitusta lainkaan. Seurauksena voi olla keskenään ristiriitaisia muutoksia, katselmointeja ja kehittäjien odotuksia – juuri se ”split brain” -ongelma, jonka Lütke nosti esiin. 47

Claude Coden julkisessa ominaisuuspyynnössä kuvataan ongelma suoraan: jos koodivarastossa on AGENTS.md, Claude Code saattaa jättää sen kontekstin huomiotta. Kehittäjän täytyy tällöin luoda CLAUDE.md ja kopioida ohjeet sinne. 12

Miten AGENTS.md:stä tuli yhteensopivuuskiistan keskipiste?

AGENTS.md sai alkunsa OpenAI:n Codex-ekosysteemiin liittyvänä avoimena käytäntönä, ja sen kehityksessä on ollut mukana laajempi toimialan yhteistyö, johon ovat osallistuneet muun muassa Google, OpenAI, Sourcegraph, Factory ja Cursor. 1931

OpenAI ja Anthropic luovuttivat 9. joulukuuta 2025 AGENTS.md:n sekä muuta agentti-infrastruktuuria Linux Foundationin tukemalle Agentic AI Foundationille. Tavoitteena on, että avointa ja yhteentoimivaa agenttiteknologiaa hallinnoidaan neutraalisti eikä yhden kaupallisen työkalutoimittajan ehdoilla. 2829

Linux Foundationin mukaan AGENTS.md oli jo omaksuttu yli 60 000 avoimen lähdekoodin projektissa ja agenttikehyksessä. Mukana ovat esimerkiksi Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules ja VS Code. 31

Tämä ei tee AGENTS.md:stä pakollista teknistä standardia. Se tekee siitä kuitenkin laajasti käytetyn siirrettävän yhteensopivuuskerroksen: tiimi voi sijoittaa pysyvät projektiohjeet yhteen näkyvään, versionhallittuun paikkaan ja odottaa useiden työkalujen löytävän ne.

Mitä Claude Code tarjoaa ratkaisuksi?

Dokumentoitu kiertotapa on saada Claude Code lataamaan jaetut ohjeet oman asetusrakenteensa kautta. Yksi vaihtoehto on viitata AGENTS.md-tiedostoon CLAUDE.md:stä. Toisena vaihtoehtona on raportoitu symbolisen linkin tai muun asetussillan käyttäminen. 69

Nämä keinot voivat ratkaista akuutin yhteensopivuusongelman, mutta ne eivät vastaa natiivista tuesta. Ne vaativat projektikohtaisia asetuksia ja jättävät organisaation päätettäväksi esimerkiksi tuontien järjestyksen, ohjeiden etusijan, hakemistokohtaisen laajuuden ja päivitysten hallinnan. Symboliset linkit voivat lisäksi toimia eri tavoin Windowsissa, Git-asetuksissa, kehitysympäristöissä, konteissa ja yritysten tietoturvakäytännöissä.

Anthropicin julkisuudessa esitetyn vastauksen mukaan yhtiö tekee Claude Codesta muokattavampaa. Tähän kuuluu sen helpottaminen, että käyttäjä voi hyödyntää AGENTS.md:tä tai muuttaa muita järjestelmäkehotteen asetuksia. 15 Käytettävissä olevat lähteet eivät kuitenkaan osoita ratkaisevaa teknistä tai kaupallista syytä sille, miksi Claude Code ei ole lisännyt natiivia tunnistusta. Anthropicin motiiveja koskevat varmat väitteet ovat siksi spekulaatiota.

Näennäinen ristiriita standardien kanssa

Kiista on erityisen kiinnostava, koska Anthropic liittyy laajempaan Agentic AI Foundation -ekosysteemiin, kun taas Claude Coden dokumentoidut projektikäytännöt nojaavat edelleen Anthropicin omiin tiedostoihin. 22829

Tämä ei välttämättä tarkoita, että Anthropic vastustaisi avoimia standardeja. Toimittaja voi tukea avointa perustasoa ja säilyttää sen rinnalla omia laajennuksiaan mallien tai tuotteen erityisominaisuuksia varten. Yritysasiakkaan näkökulmasta ero kuitenkin hämärtyy, jos projektin keskeiset ohjeet on ensin kirjoitettava uudelleen tai yhdistettävä erillisellä sillalla, jotta toinen työkalu voi käyttää niitä.

Mitä kiista voi merkitä tekoälykehitystyökaluille?

Toistuva asetusten ylläpitomaksu

Jokainen toimittajakohtainen ohjerakenne tuo jatkuvaa ylläpitotyötä: päällekkäisiä tiedostoja, synkronointitarkistuksia, migraatiokomentoja ja testejä. Kun organisaatio lisää uusia koodausagentteja, kustannukset kasvavat työkalujen ja tuettujen repositorioiden määrän mukana.

Lisää painetta toimittajalukon vähentämiseen

Projektiohjeet voivat sisältää tiimin työtapoja, tietoturvarajoja, työnkulkuja ja operatiivista tietoa. Jos ohjeet toimivat parhaiten yhden toimittajan formaatissa, työkalun vaihtaminen tai usean työkalun käyttäminen rinnakkain tulee kalliimmaksi. Jaettu formaatti pienentää vaihtamisen kustannusta ja antaa teknologiajohdolle enemmän neuvotteluvoimaa hankinnoissa.

Todennäköinen kaksikerroksinen malli

Käytännöllisin lopputulos ei välttämättä ole yksi formaatti, joka korvaa kaikki toimittajakohtaiset käytännöt. Yhteinen perustaso, kuten AGENTS.md, voisi sisältää siirrettävät projektiohjeet, kun taas CLAUDE.md ja muut vastaavat tiedostot voisivat tarjota valinnaisia, työkaluun sidottuja laajennuksia. Näin tuotteet voivat erottua toisistaan ilman, että projektin peruskonteksti lukitaan yhteen työkaluun.

Yritysasiakkaista tulee standardien määrittäjiä

Lütken kommentti osoittaa, kuinka suuren asiakkaan pieni yhteensopivuuspyyntö voi muuttua tuotevaatimukseksi. Jos Shopify kaltaisineen yrityksineen tekee monityökaluisesta ohjetuesta käyttöönoton ehdon, toimittajat voivat joutua näkemään yhteentoimivuuden osana yritysvalmiutta eikä vain yhteisön toivomana lisäominaisuutena.

Lopputulos

Shopify ei uhkaa kieltää Claude Codea siksi, että CLAUDE.md olisi itsessään huonompi kuin AGENTS.md. Ongelma on siinä, että toimittajan oma oletusformaatti muuttuu kalliiksi, kun tuhannet kehittäjät käyttävät useita agentteja saman koodipohjan parissa.

AGENTS.md:n laaja käyttöönotto, Linux Foundationin alainen hallinnointi ja tuki useissa merkittävissä koodaustyökaluissa tekevät siitä uskottavan yhteisen kerroksen. 2931 Claude Coden tuonnit ja symboliset linkit voivat toimia kiertoteinä, mutta ne siirtävät integraatiotyön jokaisen organisaation vastuulle.

Laajempi kysymys kuuluu, kehittyvätkö tekoälypohjaiset koodausagentit yhteentoimivaksi infrastruktuuriksi vai suljetuiksi alustoiksi, joiden projektitieto on sovitettava erikseen jokaiselle työkalulle.