Mengapa CEO Shopify Mengancam Melarang Claude Code Gara-Gara AGENTS.md

Ancaman Shopify untuk melarang Claude Code bukan semata-mata soal nama file konfigurasi. Di baliknya ada perselisihan tentang standar, interoperabilitas, dan cara perusahaan besar mengelola banyak AI coding agent dalam satu basis kode.

CEO Shopify Tobi Lütke mengatakan pada 25 Agustus 2026 bahwa ia sedang mempertimbangkan pelarangan Claude Code di Shopify sampai Anthropic bersedia mendukung AGENTS.md, .agents/skills, dan format terkait lainnya. Ia menilai keharusan Claude Code menggunakan CLAUDE.md dapat memicu masalah “split brain” ketika anggota tim memakai alat AI yang berbeda untuk mengerjakan repositori yang sama. 415

Apa yang dipermasalahkan Shopify?

AGENTS.md adalah file Markdown sederhana yang berisi konteks khusus proyek untuk AI coding agent. Isinya dapat mencakup cara menjalankan build dan pengujian, konvensi penulisan kode, batasan direktori, hingga aturan kontribusi.

Karena file ini disimpan bersama repositori, instruksinya ikut berpindah bersama kode dan tidak melekat pada satu vendor atau alat tertentu. 2931

Sementara itu, dokumentasi Claude Code berpusat pada CLAUDE.md, .claude/rules, skills proyek, hooks, dan pengaturan lain milik ekosistem Anthropic. File-file tersebut dapat ditemukan dari direktori kerja saat ini hingga direktori induknya, sehingga membentuk sistem instruksi bertingkat tersendiri. 2

Bagi developer individual, perbedaan ini mungkin masih mudah diatasi. Namun, situasinya jauh lebih rumit dalam monorepo besar—satu repositori yang menampung banyak proyek dan digunakan oleh banyak tim—ketika Claude Code berjalan berdampingan dengan Codex, Cursor, Gemini CLI, atau GitHub Copilot.

Jika satu alat membaca AGENTS.md, sementara alat lain hanya mencari CLAUDE.md, direktori yang sama dapat memberikan perintah build, aturan coding, atau batasan “jangan mengubah bagian ini” yang berbeda kepada masing-masing agen.

Mengapa masalah monorepo bukan sekadar dokumentasi ganda?

Perusahaan yang menggunakan banyak AI coding agent pada dasarnya memiliki beberapa pilihan yang sama-sama merepotkan:

• memelihara AGENTS.md dan CLAUDE.md sekaligus di root repositori;
• menggandakan file tersebut di berbagai subdirektori;
• memastikan keduanya selalu sinkron setiap kali kode berubah; dan
• membuat pemeriksaan otomatis untuk mendeteksi perbedaan isi atau aturan.

Instruksi yang tidak diperbarui bukan hanya masalah dokumentasi. Satu agen bisa mengikuti perintah pengujian terbaru, sedangkan agen lain masih memakai perintah lama. Satu agen mungkin mengetahui bahwa sebuah direktori tidak boleh disentuh, sementara agen lain tidak mendapat informasi itu.

Akibatnya, perubahan kode, proses review, dan ekspektasi developer dapat menjadi tidak konsisten. Inilah yang dimaksud Lütke dengan masalah “split brain”. 47

Permintaan fitur publik di repositori Claude Code juga menggambarkan persoalan tersebut. Ketika developer mengkloning repositori yang sudah memiliki AGENTS.md, konteks itu dapat diabaikan. Developer kemudian harus membuat CLAUDE.md secara manual dan menyalin instruksi yang sama. 12

Bagaimana AGENTS.md menjadi titik panas interoperabilitas?

AGENTS.md berawal dari konvensi terbuka yang terkait dengan ekosistem Codex dan dikembangkan melalui kolaborasi industri yang melibatkan perusahaan seperti Google, OpenAI, Sourcegraph, Factory, dan Cursor. 1931

Pada 9 Desember 2025, OpenAI dan Anthropic menyumbangkan AGENTS.md serta infrastruktur agen lainnya kepada Agentic AI Foundation (AAIF), organisasi yang berada di bawah naungan Linux Foundation. Tujuannya adalah menyediakan tata kelola netral untuk teknologi agen yang terbuka dan interoperabel, bukan menyerahkannya kepada satu vendor komersial. 2829

Menurut Linux Foundation, AGENTS.md telah diadopsi oleh lebih dari 60.000 proyek open source dan kerangka kerja agen. Daftar tersebut mencakup Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules, dan VS Code. 31

Angka adopsi itu tidak otomatis menjadikan AGENTS.md sebagai standar teknis wajib. Namun, format tersebut sudah berfungsi sebagai lapisan portabilitas yang praktis: perusahaan dapat menyimpan panduan proyek yang tahan lama di satu lokasi yang terlihat, berversi, dan dapat digunakan oleh berbagai alat.

Apa solusi yang ditawarkan Claude Code?

Salah satu cara yang didokumentasikan adalah membuat Claude Code memuat instruksi bersama melalui konfigurasi bawaannya. Misalnya, CLAUDE.md dapat diarahkan untuk mengimpor isi AGENTS.md. Pendekatan lain yang dilaporkan adalah menggunakan symbolic link atau jembatan konfigurasi serupa. 69

Cara-cara tersebut dapat mengurangi masalah dalam jangka pendek, tetapi belum sama dengan dukungan native. Perusahaan tetap harus menambahkan konfigurasi khusus untuk setiap repositori, menentukan urutan prioritas instruksi, mengatur cakupan direktori, serta memastikan pembaruan tetap berjalan dengan benar.

Symbolic link juga bisa berperilaku berbeda bergantung pada sistem operasi, pengaturan Git, IDE, container, dan kebijakan keamanan perusahaan. Dengan kata lain, beban integrasi tidak hilang—hanya berpindah dari vendor ke organisasi pengguna.

Dalam tanggapan publik yang dikutip dalam diskusi tersebut, Thariq dari Anthropic mengatakan bahwa perusahaan sedang membuat Claude Code lebih mudah dikustomisasi. Perubahan itu disebut akan mencakup kemudahan menggunakan AGENTS.md atau memodifikasi pengaturan system prompt lainnya. 15

Namun, materi yang tersedia belum memberikan alasan teknis atau komersial definitif mengapa dukungan native untuk AGENTS.md belum ditambahkan. Karena itu, dugaan tentang motif Anthropic sebaiknya tidak diperlakukan sebagai fakta.

Kontradiksi soal standar terbuka

Perselisihan ini menjadi semakin menarik karena Anthropic ikut terlibat dalam ekosistem Agentic AI Foundation, sementara konvensi proyek Claude Code tetap berpusat pada file khusus Anthropic. 22829

Hal tersebut tidak otomatis berarti Anthropic menolak standar terbuka. Vendor tetap dapat mendukung standar dasar yang terbuka sambil mempertahankan ekstensi eksklusif untuk fitur yang spesifik pada model atau produknya.

Namun, bagi pembeli enterprise, perbedaannya terasa kurang penting jika instruksi utama proyek masih harus ditulis ulang atau dijembatani sebelum dapat digunakan oleh alat lain.

Dampak yang mungkin muncul di pasar AI developer tools

Pajak konfigurasi yang terus berulang

Setiap pohon instruksi khusus vendor menambah pekerjaan pemeliharaan: file duplikat, pemeriksaan sinkronisasi, skrip migrasi, dan pengujian. Ketika jumlah coding agent bertambah, biaya ini ikut meningkat berdasarkan jumlah alat dan cakupan repositori yang harus didukung.

Tekanan lebih besar terhadap vendor lock-in

File instruksi repositori sering memuat praktik tim, batasan keamanan, alur kerja, dan pengetahuan operasional. Jika semua itu paling efektif digunakan dalam format milik satu vendor, perpindahan alat atau penggunaan beberapa alat secara bersamaan menjadi lebih mahal.

Format bersama dapat menurunkan biaya perpindahan dan memberi posisi tawar yang lebih kuat bagi pemimpin engineering saat memilih vendor.

Model dua lapis kemungkinan menjadi jalan tengah

Hasil yang paling realistis mungkin bukan satu format yang menggantikan semua konvensi proprietary. Format umum seperti AGENTS.md dapat menyimpan panduan proyek yang portabel, sedangkan CLAUDE.md atau file vendor lain menyediakan ekstensi opsional.

Model ini memungkinkan vendor tetap membedakan produknya tanpa membuat konteks dasar repositori terkunci pada satu alat.

Pembeli enterprise ikut menentukan standar

Respons Lütke menunjukkan bagaimana permintaan kompatibilitas yang tampak kecil dapat berubah menjadi persyaratan produk. Jika perusahaan besar seperti Shopify menjadikan dukungan lintas alat sebagai syarat penggunaan, vendor mungkin harus memperlakukan interoperabilitas sebagai bagian dari kesiapan enterprise, bukan sekadar fitur tambahan untuk komunitas.

Kesimpulan

Shopify tidak mengancam melarang Claude Code karena CLAUDE.md secara inheren lebih buruk daripada AGENTS.md. Masalahnya adalah ketika default proprietary menjadi mahal untuk dikelola dalam perusahaan yang memakai banyak agen AI pada basis kode yang sama.

Adopsi AGENTS.md yang luas, tata kelola di bawah Linux Foundation, serta dukungan dari berbagai alat coding besar membuatnya layak dipandang sebagai lapisan bersama. 2931 Fitur impor dan symbolic link Claude Code dapat menjadi solusi sementara, tetapi integrasinya harus ditanggung oleh setiap organisasi.

Pada akhirnya, pertanyaan yang lebih besar bukanlah file mana yang memiliki nama terbaik. Pertanyaannya adalah apakah AI coding agent akan berkembang menjadi infrastruktur developer yang saling terhubung, atau menjadi platform tertutup yang memaksa pengetahuan proyek diadaptasi ulang untuk setiap alat.