Pertikaian Fail Arahan AI Cetus Ancaman Shopify Untuk Menyekat Claude Code

Shopify bukan mengancam untuk menyekat Claude Code kerana CLAUDE.md semata-mata “lebih teruk” daripada AGENTS.md. Isu sebenarnya ialah kos mengurus arahan yang berbeza apabila ribuan jurutera menggunakan beberapa ejen AI dalam repositori yang sama.

Pada 25 Ogos 2026, CEO Shopify Tobi Lütke berkata beliau sedang mempertimbangkan untuk menyekat penggunaan Claude Code di syarikat itu sehingga Anthropic bersetuju membaca AGENTS.md, .agents/skills dan fail berkaitan. Menurut Lütke, kebergantungan Claude Code pada CLAUDE.md sahaja kadangkala mewujudkan masalah “otak berpecah” apabila ahli pasukan menggunakan alat yang berlainan. 415

Apakah yang dipertikaikan Shopify?

AGENTS.md ialah fail Markdown biasa yang diletakkan bersama kod projek. Ia boleh menerangkan cara membina dan menguji perisian, piawaian pengekodan, sempadan direktori serta peraturan sumbangan. Oleh sebab fail itu disimpan dalam repositori, konteks projek boleh bergerak bersama kod dan tidak terikat kepada alat atau vendor tertentu. 2931

Claude Code pula mendokumentasikan sistem konteks projek yang berpusat pada CLAUDE.md, .claude/rules, kemahiran projek, hooks dan tetapan. Fail-fail ini boleh ditemui dalam direktori semasa serta direktori induk, lalu membentuk sistem arahan berhierarki tersendiri. 2

Bagi pembangun solo, perbezaan ini mungkin mudah diurus. Namun, dalam monorepo—satu repositori besar yang menempatkan kod untuk banyak pasukan—kesannya lebih serius. Sebuah syarikat mungkin menggunakan Claude Code bersama Codex, Cursor, Gemini CLI, GitHub Copilot atau VS Code. Jika satu alat membaca AGENTS.md manakala Claude Code hanya mencari CLAUDE.md, setiap ejen boleh menerima arahan yang berbeza daripada folder yang sama.

Mengapa masalah monorepo ini bukan sekadar dokumentasi berganda?

Organisasi yang menggunakan pelbagai ejen terpaksa memilih antara beberapa pilihan yang tidak begitu menarik:

• mengekalkan AGENTS.md dan CLAUDE.md serentak di akar repositori;
• mengulangi kedua-dua fail dalam subdirektori yang berkaitan;
• memastikan kandungannya sentiasa seiring apabila kod berubah; dan
• membina semakan automatik untuk mengesan arahan yang sudah tidak selaras.

Jika satu kemas kini terlepas, masalahnya bukan sekadar dokumentasi yang lapuk. Satu ejen mungkin menggunakan arahan ujian baharu, sementara ejen lain masih menggunakan arahan lama. Satu ejen mungkin tahu bahawa direktori tertentu tidak boleh diubah, manakala ejen lain tidak menerima larangan itu.

Akibatnya boleh melibatkan suntingan kod, semakan perubahan dan jangkaan pembangun—tepat seperti masalah “otak berpecah” yang dibangkitkan Lütke. 47

Geseran ini turut diterangkan dalam permintaan ciri awam Claude Code. Apabila pembangun membuka repositori yang mengandungi AGENTS.md, konteks tersebut boleh diabaikan. Mereka kemudiannya perlu mencipta CLAUDE.md dan menggandakan arahan secara manual. 12

Bagaimana AGENTS.md menjadi titik panas kesalingoperasian?

AGENTS.md bermula sebagai konvensyen terbuka yang dikaitkan dengan ekosistem Codex OpenAI. Format ini dibangunkan melalui kerjasama lebih luas yang melibatkan syarikat seperti Google, OpenAI, Sourcegraph, Factory dan Cursor. 1931

Pada 9 Disember 2025, OpenAI dan Anthropic menyumbangkan AGENTS.md serta infrastruktur ejen lain kepada Agentic AI Foundation, sebuah inisiatif di bawah Linux Foundation. Matlamatnya ialah menyediakan pengawasan neutral untuk teknologi ejen yang terbuka dan saling beroperasi, bukannya menyerahkan kawalan kepada satu vendor komersial. 2829

Linux Foundation berkata AGENTS.md telah digunakan oleh lebih 60,000 projek sumber terbuka dan rangka kerja ejen, termasuk Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules dan VS Code. 31

Angka itu tidak menjadikan AGENTS.md sebagai piawaian teknikal yang wajib dipatuhi semua pihak. Namun, ia menjadikannya lapisan mudah alih yang penting: pasukan boleh menyimpan panduan projek yang berkekalan di satu lokasi yang jelas, disimpan dalam kawalan versi, dan diakses oleh pelbagai alat.

Apakah penyelesaian yang ditawarkan Claude Code?

Berdasarkan dokumentasi dan perbincangan awam, salah satu jalan penyelesaian ialah memasukkan kandungan AGENTS.md melalui CLAUDE.md. Kaedah lain yang dilaporkan termasuk menggunakan pautan simbolik atau jambatan konfigurasi yang serupa. 69

Cara ini boleh mengurangkan masalah dengan segera, tetapi tidak memberikan pengalaman yang sama seperti sokongan asli. Setiap organisasi masih perlu menetapkan cara import, keutamaan arahan, skop direktori dan penyelarasan kemas kini berfungsi.

Pautan simbolik juga mungkin berkelakuan berbeza mengikut sistem operasi, tetapan Git, persekitaran pembangunan bersepadu, kontena dan dasar keselamatan perusahaan. Ringkasnya, beban integrasi dipindahkan kepada setiap pasukan dan repositori.

Dalam respons awam yang dipetik dalam perbincangan itu, Anthropic berkata syarikat tersebut sedang menjadikan Claude Code lebih mudah diubah suai. Ini termasuk memudahkan penggunaan AGENTS.md atau pengubahsuaian tetapan system prompt yang lain. 15 Bahan yang tersedia tidak menetapkan sebab teknikal atau komersial yang muktamad mengapa sokongan asli belum ditambah. Oleh itu, sebarang dakwaan tentang motif Anthropic perlu dianggap sebagai spekulasi.

Percanggahan yang sukar tidak disedari

Pertikaian ini menarik kerana Anthropic turut dikaitkan dengan ekosistem Agentic AI Foundation yang lebih luas, sedangkan konvensyen projek Claude Code masih berpusat pada fail khusus Anthropic. 22829

Itu tidak semestinya bermakna Anthropic menentang piawaian terbuka. Vendor boleh menyokong piawaian asas terbuka sambil mengekalkan sambungan proprietari untuk ciri yang khusus kepada model atau produknya.

Namun, dari sudut pandang pembeli perusahaan, perbezaannya menjadi kurang penting jika arahan asas projek masih perlu ditulis semula atau disambungkan terlebih dahulu sebelum boleh digunakan oleh alat lain.

Apakah maknanya untuk pasaran alat pembangun AI?

“Cukai konfigurasi” yang berulang

Setiap hierarki arahan khusus vendor menambah kerja penyelenggaraan: fail pendua, semakan penyelarasan, skrip migrasi dan ujian tambahan. Apabila organisasi menambah lebih banyak ejen pengekodan, kos ini meningkat mengikut jumlah alat serta skop repositori yang perlu disokong.

Tekanan lebih besar terhadap penguncian vendor

Arahan repositori boleh mengandungi amalan pasukan, sempadan keselamatan, aliran kerja dan pengetahuan operasi. Jika semua itu berfungsi paling baik dalam format vendor tertentu, menukar alat atau menggunakan beberapa alat secara serentak menjadi lebih mahal.

Format bersama boleh mengurangkan kos pertukaran dan memberi lebih banyak kuasa tawar-menawar kepada pemimpin kejuruteraan ketika memilih vendor.

Model dua lapisan mungkin menjadi jalan tengah

Hasil paling praktikal mungkin bukan satu format yang menggantikan semua konvensyen proprietari. Format asas seperti AGENTS.md boleh menyimpan panduan projek yang boleh digunakan merentas alat, manakala CLAUDE.md dan fail khusus vendor lain menyediakan sambungan pilihan.

Model ini mengekalkan ruang untuk pembezaan produk tanpa menjadikan konteks asas repositori tidak mudah alih.

Pelanggan perusahaan menjadi pembentuk piawaian

Respons Lütke menunjukkan bagaimana pelanggan besar boleh mengubah permintaan keserasian kecil menjadi keperluan produk. Jika syarikat seperti Shopify menjadikan sokongan arahan merentas alat sebagai syarat penggunaan, vendor mungkin terpaksa menganggap kesalingoperasian sebagai sebahagian daripada kesediaan perusahaan—bukan sekadar ciri tambahan untuk komuniti.

Kesimpulan

Ancaman Shopify itu sebenarnya berkaitan dengan operasi, bukan nama fail. Apabila satu organisasi menggunakan Claude Code, Codex, Cursor dan ejen lain pada kod yang sama, penyelenggaraan beberapa set arahan boleh mencetuskan tingkah laku yang tidak konsisten serta menambah kos kejuruteraan.

Penggunaan AGENTS.md yang meluas, tadbir urus melalui Linux Foundation dan sokongan daripada pelbagai alat utama menjadikannya calon kukuh sebagai lapisan bersama. 2931 Import dan pautan simbolik boleh menjadi penyelesaian sementara, tetapi kedua-duanya memindahkan kerja penyepaduan kepada organisasi.

Persoalan yang lebih besar ialah sama ada ejen pengekodan AI akan berkembang sebagai infrastruktur pembangun yang saling beroperasi—atau sebagai platform tertutup yang memerlukan penyesuaian pengetahuan projek untuk setiap alat.