Cursor Rules vs CLAUDE.md vs AGENTS.md: Saya Uji Satu Config di Ketiganya (2026)

Cursor Rules vs CLAUDE.md vs AGENTS.md: Saya Uji Satu Config di Ketiganya (2026)

Pertanyaan cursor rules vs claude md punya jebakan di dalamnya: keduanya bukan dua opsi yang bisa Anda pilih. Keduanya adalah dua file, dibaca oleh dua tool berbeda, yang kebetulan melakukan pekerjaan yang sama. Taruh CLAUDE.md di proyek Cursor dan Cursor mengabaikannya. Taruh AGENTS.md di Claude Code dan tidak terjadi apa-apa juga. Kami pun kaget. AGENTS.md kini ada di 60.000+ repo sebagai standar terbuka, dikelola oleh Agentic AI Foundation di bawah Linux Foundation, tapi Claude Code tetap tidak mau membacanya sendiri. Berikut peta kompatibilitasnya, teruji di repo kami.

Poin Penting

• Cursor membaca .cursor/rules/*.mdc dan AGENTS.md, bukan CLAUDE.md.
• Claude Code hanya membaca CLAUDE.md, bukan AGENTS.md secara native.
• Untuk berbagi satu file: symlink AGENTS.md ke CLAUDE.md, atau import dengan @AGENTS.md.
• Standarisasi pada AGENTS.md (standar terbuka, 60k+ repo), lalu tambahkan override khusus tool.

Format Config Mana yang Harus Anda Pakai? Keputusan 30 Detik

Pilih format berdasarkan bentuk tim, bukan hype. Jika Anda menjalankan satu tool, gunakan file native-nya. Jika Anda menjalankan dua atau lebih, jadikan AGENTS.md sebagai sumber kebenaran dan tambahkan override per-tool hanya jika suatu tool butuh sesuatu yang tidak dibutuhkan tool lain. Satu aturan itu menyelesaikan sebagian besar kebingungan.

Masih memutuskan asisten mana yang dijalankan sebelum memikirkan config-nya? Mulai dengan panduan kami tentang memilih AI coding agent yang akan dijalankan, lalu kembali untuk setup file-nya.

Poros keputusan yang penting adalah portabilitas. File .cursor/rules kuat di dalam Cursor dan tidak berguna di tempat lain. AGENTS.md bisa dibawa ke mana-mana. Jadi kecuali Anda terkunci pada satu tool selamanya, file yang agnostik-tool adalah pilihan yang lebih aman.

Apa Sebenarnya Masing-Masing Format (Masing-Masing 30 Detik)

Ketiga file ini melakukan satu hal: memberikan aturan, konvensi, dan jebakan proyek Anda ke AI coding tool sebelum ia menulis satu baris pun. Perbedaannya adalah siapa yang membacanya dan bagaimana cakupannya. Berikut versi singkatnya. Panduan mendalam untuk masing-masing ada di panduan tersendiri.

Cursor Rules adalah file .mdc di dalam .cursor/rules/. Cursor mendukung empat tipe rule (always-on, agent-requested, glob-scoped, dan @-mention manual), jadi Anda bisa menempelkan rule hanya ke file *.tsx atau hanya ke migration Anda. Untuk frontmatter, glob, dan budget token, baca panduan kami tentang cara benar-benar menulis file .cursor/rules.

CLAUDE.md adalah file memori Claude Code. Claude menelusuri pohon direktori ke atas dari folder kerja Anda dan menggabungkan setiap CLAUDE.md yang ditemukan. Ini Markdown polos, tanpa frontmatter yang diperlukan. Untuk struktur dan aturan agar Claude tidak mengabaikannya, lihat apa yang membuat CLAUDE.md tidak diabaikan Claude.

AGENTS.md adalah standar terbuka. Satu file Markdown polos di root repo Anda, dibaca secara native oleh Cursor, Codex, Copilot, Windsurf, Zed, Aider, dan puluhan lainnya. Dikelola oleh Agentic AI Foundation dan sudah ada di 60.000+ proyek.

Berikut reframing yang layak diingat: AGENTS.md, CLAUDE.md, dan .cursor/rules bukan pesaing, melainkan instruksi yang sama, ditujukan ke pembaca berbeda.

Cursor Rules vs CLAUDE.md vs AGENTS.md: Perbandingan Utama

Cara tercepat melihat perbedaannya adalah berdampingan. Kolom penentunya adalah portabilitas: tool mana yang membaca file tanpa setup tambahan. AGENTS.md menang di jangkauan, Cursor Rules menang di presisi cakupan, dan CLAUDE.md menang untuk siapa pun yang all-in di Claude Code.

Perhatikan baris .cursorrules. Satu file root itu masih bekerja di Cursor, tapi sudah hilang dari dokumentasi, jadi perlakukan sebagai lawas. Proyek baru sebaiknya menggunakan .cursor/rules/*.mdc atau AGENTS.md.

Tool Mana Membaca File Mana? (Membongkar Mitos AGENTS.md)

Berikut fakta yang separuh internet salah paham: Claude Code tidak membaca AGENTS.md secara native, dan Cursor tidak membaca CLAUDE.md. Cursor membaca .cursor/rules/*.mdc plus AGENTS.md. Claude Code membaca CLAUDE.md dan tidak ada yang lain. Tidak ada fallback otomatis di kedua arah, yang menjebak tim yang mengira satu file standar mencakup semuanya.

Ini ditanyakan terus-menerus, jadi mari bicara terus terang. Menaruh AGENTS.md di proyek Claude Code tidak melakukan apa-apa dengan sendirinya. Claude Code membaca CLAUDE.md dan hanya CLAUDE.md. Dokumentasi memori Claude Code dari Anthropic menjelaskan perilaku pemuatan file tanpa menyebut AGENTS.md, spesifikasi AGENTS.md mencantumkan Cursor dan Codex di antara pembaca native tapi bukan Claude Code, dokumentasi rules Cursor sendiri mengonfirmasi pemisahan ini, dan GitHub issues Claude Code penuh dengan developer yang menabrak dinding yang persis sama.

Jadi apakah Cursor membaca claude.md? Tidak. Apakah Claude Code membaca agents.md? Tidak tanpa bantuan. "Bantuan" itu adalah seluruh alasan postingan ini ada, dan berupa dua perintah pendek yang akan Anda lihat selanjutnya.

Bagaimana Prioritas & Nesting Bekerja, Berdampingan

Setiap tool menyelesaikan konflik secara berbeda, dan salah memahami ini adalah sumber utama kebingungan "kenapa rule saya diabaikan?". Cursor menggabungkan rule berdasarkan prioritas sumber. Claude Code menggabungkan berdasarkan kedalaman direktori. AGENTS.md memilih file terdekat di pohon. claude md management yang baik dimulai dengan mengetahui model mental mana yang sedang Anda gunakan.

Di setup kami, hasil praktisnya sederhana: taruh rule luas di atas (root repo) dan rule spesifik di bawah (di dalam folder paket). Untuk Claude Code maupun AGENTS.md, file terdekat ke tempat Anda bekerja mendapat prioritas, jadi packages/api/AGENTS.md mengesampingkan file root untuk apa pun di dalam folder itu. Cursor yang berbeda sendiri, menyelesaikan berdasarkan tingkatan sumber alih-alih kedalaman folder.

Kami Uji Satu Config di Cursor + Claude Code, Inilah yang Dimuat Masing-Masing Tool

Kami menguji ini di repo klien Techsy yang live (backend Next.js 15) menggunakan Cursor 3.7 (build 17 Juni 2026) dan Claude Code v2.1.x (awal Juli 2026). Satu AGENTS.md, tiga setup berbagi, prompt yang sama dibuka di kedua tool. Berikut persisnya apa yang ditarik masing-masing.

Kami mulai dengan file minimal:

# AGENTS.md
- Package manager: pnpm, never npm.
- Tests: Vitest. Run `pnpm test` before any commit.
- DB access goes through `lib/db.ts` only, no inline SQL.

Setup 1: AGENTS.md saja. Cursor langsung mengambilnya. File itu muncul di konteksnya dan dengan benar menolak menyarankan npm install. Claude Code tidak melakukan apa-apa dengannya. Menjalankan /memory di Claude Code menampilkan nol file memori proyek: tidak ada CLAUDE.md ditemukan, dan AGENTS.md bahkan tidak diakui. Terkonfirmasi: tidak ada fallback native.

Setup 2: symlink. Kami mengarahkan CLAUDE.md ke file yang sama:

ln -s AGENTS.md CLAUDE.md

Kini /memory di Claude Code mencantumkan ./CLAUDE.md sebagai memori Project, dan konten yang dimuat adalah AGENTS.md kami byte-per-byte. Cursor tetap membaca AGENTS.md secara langsung. Satu file fisik, kedua tool senang. Di Windows ini memerlukan Admin atau Developer Mode diaktifkan, atau ln/mklink gagal diam-diam.

Setup 3: @import. Kami menghapus symlink dan sebagai gantinya menaruh satu baris di paling atas CLAUDE.md sungguhan:

@AGENTS.md

/memory lalu menampilkan CLAUDE.md sebagai file yang dimuat dengan AGENTS.md ditarik sebagai referensi import di bawahnya. Ini jalur yang benar-benar didokumentasikan Anthropic, dan tidak memerlukan izin OS khusus.

Verdict dari pengujian kami: symlink membuat Claude Code membaca AGENTS.md byte-per-byte; import @AGENTS.md adalah versi aman-Windows yang benar-benar direkomendasikan Anthropic. Keduanya memberi Anda satu sumber kebenaran. Pilih symlink di macOS/Linux untuk nol pengalihan, atau baris import jika ada anggota tim yang menggunakan Windows.

Migrasi Antar Format: .cursorrules → .cursor/rules → AGENTS.md

Kebanyakan tim tiba di sini dengan file .cursorrules lawas dan ingin keluar dari jebakan satu file. Migrasinya singkat di setiap arah, dan langkahnya tinggal copy-paste. Satu jebakan yang menggigit orang: file .md di dalam .cursor/rules tanpa frontmatter diabaikan diam-diam, jadi harus .mdc.

Untuk memodernisasi .cursorrules lama, Anda punya dua jalur bersih:

• Ke .cursor/rules/*.mdc: buat .cursor/rules/general.mdc, tambahkan frontmatter (alwaysApply: true untuk rule global), dan tempel konten lama Anda di bawahnya. Hapus .cursorrules setelah diverifikasi.
• Ke AGENTS.md (direkomendasikan untuk tim multi-tool): untuk mengonversi cursorrules ke agents.md, salin isi .cursorrules ke AGENTS.md baru di root repo Anda. Tidak perlu frontmatter; ini Markdown polos. Lalu tambahkan symlink atau import @AGENTS.md agar Claude Code juga membacanya.

Jika Anda tetap di dalam Cursor dan ingin memeras lebih banyak darinya, panduan kami tentang memaksimalkan Cursor sehari-hari membahas scoping rule dalam praktik.

Arah sebaliknya (AGENTS.md → CLAUDE.md) hanyalah symlink atau import dari bagian sebelumnya. Tidak ada konversi yang kehilangan data karena ketiganya adalah Markdown di balik layar.

Di Mana SKILL.md dan Copilot Instructions Cocok?

Dua format lagi muncul di percakapan ini, dan skills md sedang jadi pencarian yang naik daun, jadi layak penempatan cepat. Keduanya tidak menggantikan tiga file utama; mereka berdampingan.

SKILL.md adalah format Skills dari Anthropic: instruksi khusus tugas yang dibundel di .claude/skills/*/SKILL.md yang dimuat Claude sesuai permintaan saat suatu tugas cocok, alih-alih always-on seperti CLAUDE.md. Anggap sebagai playbook khusus yang diraih Claude, bukan file memori seluruh proyek. Cakupannya masih berkembang, jadi jangan investasi berlebihan dulu. Untuk bagaimana ia cocok di alur kerja nyata, lihat di mana CLAUDE.md cocok di alur kerja Claude Code nyata.

Copilot instructions ada di .github/copilot-instructions.md untuk GitHub Copilot. Kabar baik: Copilot juga membaca AGENTS.md, jadi jika Anda sudah standarisasi pada standar terbuka, Copilot sudah tercakup tanpa file terpisah.

Mana yang Harus Anda Pakai? (Berdasarkan Bentuk Tim)

Cocokkan format dengan cara tim Anda benar-benar bekerja:

• Pengguna solo Claude Code: cukup gunakan CLAUDE.md. Tidak ada alasan menambah AGENTS.md kecuali Anda berencana memasukkan Cursor atau Codex nanti.
• Pengguna solo Cursor: .cursor/rules/*.mdc untuk scoping glob, atau satu AGENTS.md jika Anda ingin portabilitas sejak hari pertama.
• Tim tool campuran: satu AGENTS.md sebagai sumber kebenaran, di-symlink atau di-import ke CLAUDE.md. Tambahkan file .cursor/rules kecil hanya untuk perilaku khusus Cursor.
• Monorepo: AGENTS.md di root plus file bersarang per paket, jadi setiap subproyek mendeskripsikan dirinya sendiri dan file terdekat menang.

Di Techsy kami menstandarisasi config AI-coding di seluruh tim tool campuran, biasanya satu AGENTS.md sebagai sumber kebenaran dengan override per-tool di mana tool membutuhkannya. Jika tim Anda mengelola tiga file config secara manual, dapatkan konsultasi gratis dan kami akan memetakannya.

Satu petunjuk terakhir: postingan ini membandingkan file config. Jika Anda sebenarnya mencoba memutuskan di antara tool-toolnya sendiri, baca membandingkan asisten-asistennya sendiri, bukan config mereka.

Tentang Penulis

Mert Batur Gurbuz adalah Co-Founder Techsy.io, di mana tim mengirimkan AI agent, sistem otomasi, dan pipeline voice/SDR untuk klien B2B. Ia belajar di University of Birmingham dan menulis tentang stack tooling LLM yang benar-benar digunakan tim Techsy di produksi.

Co-Founder, Techsy.io · University of Birmingham · LinkedIn

Pertanyaan yang Sering Diajukan

Apakah Cursor membaca CLAUDE.md?

Tidak. Cursor membaca .cursor/rules/*.mdc dan AGENTS.md secara native, tapi CLAUDE.md tidak pernah disebut di dokumentasi Cursor dan tidak dimuat. Jika Anda di Cursor dan ingin berbagi config dengan pengguna Claude Code, taruh rule Anda di AGENTS.md (yang memang dibaca Cursor) alih-alih CLAUDE.md.

Apakah Claude Code membaca AGENTS.md?

Tidak secara native. Claude Code hanya membaca CLAUDE.md, tanpa fallback otomatis ke AGENTS.md. Agar berfungsi, symlink file-nya (ln -s AGENTS.md CLAUDE.md) agar Claude membaca AGENTS.md byte-per-byte, atau tambahkan @AGENTS.md di baris 1 CLAUDE.md untuk meng-importnya. Import adalah opsi yang direkomendasikan Anthropic dan aman di Windows.

Bisakah saya cukup pakai satu file untuk ketiga tool?

Ya. Jadikan AGENTS.md sebagai satu-satunya sumber kebenaran Anda, dan Cursor serta Codex membacanya langsung. Untuk Claude Code, tambahkan satu jembatan: symlink AGENTS.md ke CLAUDE.md, atau taruh @AGENTS.md di atas CLAUDE.md. Anda mengelola satu file, dan setiap tool memuat rule yang sama. Itulah seluruh resep berbagi satu config.

Apakah .cursorrules sudah deprecated?

Soft-deprecated. File tunggal .cursorrules di root repo Anda masih bekerja di Cursor, tapi tidak lagi ada di dokumentasi resmi, yang merupakan sinyal umum bahwa suatu format sedang menuju keluar. Proyek baru sebaiknya menggunakan .cursor/rules/*.mdc untuk rule scoped atau AGENTS.md untuk portabilitas.

Bagaimana cara mengonversi .cursorrules ke AGENTS.md?

Salin isi file .cursorrules Anda ke AGENTS.md baru di root repo Anda. Ini Markdown polos, jadi tidak perlu frontmatter atau pemformatan ulang. Lalu tambahkan symlink atau import @AGENTS.md agar Claude Code juga membacanya, dan hapus .cursorrules lama setelah Anda mengonfirmasi Cursor mengambil file baru.

Apa perbedaan antara CLAUDE.md dan AGENTS.md?

CLAUDE.md adalah file memori proprietary Claude Code, hanya dibaca oleh Claude Code. AGENTS.md adalah standar terbuka yang dibaca oleh Cursor, Codex, Copilot, dan 20+ tool lain, tapi tidak oleh Claude Code secara native. Format Markdown sama, pekerjaan sama. Perbedaannya adalah jangkauan. AGENTS.md berjalan lintas tool; CLAUDE.md tetap di dalam Claude Code.

Format mana yang harus distandarisasi tim yang menggunakan beberapa AI tool?

AGENTS.md. Ini standar terbuka, dibaca secara native oleh kebanyakan tool dan sudah ada di 60.000+ repo. Standarisasi rule bersama Anda di sana, jembatani ke Claude Code dengan symlink atau import, dan tambahkan file khusus tool kecil (seperti .cursor/rules) hanya jika satu tool butuh perilaku yang tidak dibutuhkan tool lain.

Bagaimana prioritas bekerja ketika saya punya file config bersarang?

Untuk Claude Code maupun AGENTS.md, file terdekat ke direktori kerja Anda menang, jadi rule di packages/api/AGENTS.md mengesampingkan file root repo untuk apa pun di dalam folder itu. Cursor berbeda: ia menggabungkan rule Team, Project, dan User berdasarkan tingkatan sumber alih-alih kedalaman folder, dengan sumber lebih awal memenangkan konflik.

Di mana SKILL.md cocok?

SKILL.md adalah format Skills Anthropic yang sedang berkembang: instruksi khusus tugas di .claude/skills/*/SKILL.md yang dimuat Claude sesuai permintaan saat suatu tugas cocok, alih-alih always-on seperti CLAUDE.md. Ia melengkapi CLAUDE.md alih-alih menggantikannya. Cakupannya masih berkembang di 2026, jadi perlakukan sebagai add-on khusus, bukan file keempat yang dibutuhkan setiap proyek.