Satu Fail Arahan untuk Claude Code, Codex dan Cursor pada 2026

Untuk mendapatkan maklumat tentang perkhidmatan ini, lihat dokumentasi Ailoot.

Apakah perubahan apabila anda menggunakan Claude Code, Codex dan Cursor bersama-sama?#

Dalam contoh yang dihuraikan, Claude Code ialah alat utama, manakala Codex dan Cursor digunakan untuk tugasan tertentu. CLAUDE.md saya mempunyai kira-kira 250 baris arahan: perkara yang perlu dibaca dan susunannya, perkara yang tidak boleh disentuh, arahan yang perlu digunakan untuk deployment, dan peraturan pemformatan commit. Apabila saya mula-mula mencuba Codex CLI pada projek itu, ia tidak tahu apa-apa tentang peraturannya: ia menjalankan git push --force, mengusik .env, dan menamakan semula fail dengan cuai.

Mula-mula saya menyalin CLAUDE.md secara manual menjadi AGENTS.md. Dua minggu kemudian, saya mendapati projek itu sudah mempunyai empat versi arahan yang sama: dalam CLAUDE.md, AGENTS.md, .cursorrules dan .windsurf/rules/. Semuanya berbeza sedikit. Ini bukan masalah Claude atau Cursor; inilah perangkap asas bagi mana-mana sistem yang mempunyai berbilang sumber kebenaran. Saya membincangkan masalah ini dengan lebih terperinci dalam panduan kerja berbilang ejen.

Pada Jun 2026, dokumentasi memori Claude Code daripada Anthropic menawarkan satu jawapan: fail dikongsi bersama satu import. Sejak September 2026, Claude Code membaca AGENTS.md sendiri jika projek tidak mempunyai CLAUDE.md, dan import diperlukan apabila anda mempunyai peraturan khusus untuk Claude. Di bawah, saya menerangkan bila satu AGENTS.md sudah memadai, cara menyediakan import, dan cara memisahkan peraturan bersama daripada peraturan khusus Claude.

Adakah Claude Code membaca AGENTS.md sendiri?#

Sebelum September 2026, jawapannya ialah “tidak.” Issue #6235, yang meminta sokongan untuk AGENTS.md, telah dibuka sejak Ogos 2025 dan ditutup pada 17 Ogos 2026. Sepanjang tempoh itu, dokumentasi memori mencadangkan satu penyelesaian: cipta CLAUDE.md dan sertakan AGENTS.md di dalamnya sebagai import. Bermula dengan versi 2.1.277, dokumentasi menyatakan sesuatu yang berbeza:

Perkara yang dibaca oleh Claude Code bergantung tepat pada fail yang terdapat dalam projek:

Untuk semakan ini, CLAUDE.md, .claude/CLAUDE.md dan CLAUDE.local.md dalam direktori kerja dan mana-mana direktori induk turut diambil kira. Fail peribadi ~/.claude/CLAUDE.md, fail korporat terurus dan peraturan daripada .claude/rules/ tidak diambil kira: semuanya dimuatkan bersama AGENTS.md.

Jika tiada CLAUDE.md, Claude Code membaca semua fail AGENTS.md dan .claude/AGENTS.md dalam direktori kerja dan direktori induk semasa permulaan, dan mengambil AGENTS.md dalam subdirektori apabila ia membuka fail dalam subdirektori tersebut. Import @path di dalam AGENTS.md juga berfungsi. Claude Code tidak membaca AGENTS.local.md, AGENTS.override.md atau kandungan direktori .agents/.

Perangkapnya: CLAUDE.local.md peribadi juga dikira. Jika anda menciptanya untuk menyimpan peraturan yang belum di-commit, Claude Code akan berhenti membaca AGENTS.md secara senyap. Tetapan di bawah ialah penyelesaiannya.

Tingkah laku ini berubah dalam /config, di bawah Project instructions:

Jika anda mahu mengekalkan CLAUDE.local.md tanpa kehilangan AGENTS.md, tetapkan claude-md-and-agents-md. Bacaan pendua tidak akan berlaku: jika AGENTS.md sudah disertakan melalui baris @AGENTS.md atau pautan simbolik, Claude Code tidak akan memuatkannya sekali lagi, tanpa mengira tetapan.

Anda boleh menyemak sama ada fail itu telah diambil menggunakan arahan /memory: bermula dengan versi 2.1.280, laluan ke AGENTS.md akan muncul dalam senarai. Dalam versi sebelum 2.1.277 dan sesi yang mematikan plugin terbina dalam agents-md, Claude Code hanya membaca CLAUDE.md, dan tiada item Project instructions dalam /config. Sebelum versi 2.1.281, sesi melalui Amazon Bedrock dan sesi dengan telemetri dinyahdayakan juga berkelakuan dengan cara yang sama. Dalam sesi pertama selepas mengemas kini daripada versi lebih lama, AGENTS.md juga mungkin tidak diambil; ia akan berfungsi mulai sesi seterusnya.

Apakah maksudnya untuk persediaan dengan satu fail? Jika anda tiada peraturan yang khusus untuk Claude, anda boleh mengetepikan CLAUDE.md: AGENTS.md sudah memadai, dan Claude Code, Codex serta Cursor akan membacanya. Jika anda mempunyai peraturan sedemikian (plan mode untuk direktori berisiko, skills, hooks), anda memerlukan CLAUDE.md, dan Claude Code tidak akan membaca AGENTS.md sendiri. Kemudian sertakan AGENTS.md dalam CLAUDE.md dengan baris @AGENTS.md; persediaan ini berfungsi seperti sebelum September. Ia juga membantu dengan versi Claude Code yang lebih lama. Saya menerangkannya dengan terperinci di bawah.

Bagaimanakah cara mengimport @AGENTS.md di dalam CLAUDE.md?#

Contoh minimum yang berfungsi daripada dokumentasi rasmi:

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Beginilah cara ia berfungsi. Baris pertama, @AGENTS.md, ialah arahan import. Apabila Claude Code menghuraikan CLAUDE.md pada permulaan sesi, ia menemui import ini lalu memasukkan keseluruhan kandungan AGENTS.md di tempatnya. Seterusnya ialah tajuk ## Claude Code: ia hanya markdown, tetapi berfungsi sebagai bahagian “tambahan khusus Claude”. Di bawahnya terdapat peraturan yang hanya terpakai kepada Claude Code: gunakan plan mode untuk perubahan dalam direktori billing. Codex CLI dan Cursor langsung tidak membuka fail ini; kedua-duanya menggunakan AGENTS.md biasa.

Petikan daripada dokumentasi tentang cara import berfungsi:

Beberapa butiran praktikal:

• Laluan relatif dan mutlak. @AGENTS.md adalah relatif kepada fail yang mengandungi import itu. @/Users/me/shared/rules.md atau @~/.claude/personal.md ialah laluan mutlak. Saya menggunakan @~/.claude/personal.md untuk pilihan peribadi yang tidak mahu saya letakkan dalam repositori.
• Kedalaman empat tahap. AGENTS.md boleh mengimport @docs/coding-style.md, dan coding-style.md boleh mengimport fail lain sehingga empat tahap. Itu mencukupi untuk apa-apa struktur sebenar.
• Backtick menghalang import. Jika teks menyebut `@README`, itu cuma sebutan nama, bukannya import. Ini berguna apabila menerangkan kepada pembaca cara import berfungsi tanpa mencetuskan import.
• Kelulusan untuk fail di luar projek. Jika import menunjuk ke luar direktori kerja, seperti @~/.claude/personal.md, Claude Code akan memaparkan dialog yang menyenaraikan fail tersebut buat kali pertama. Jika anda menolaknya, import luaran kekal dinyahdayakan dan dialog itu tidak akan dipaparkan lagi. @AGENTS.md di akar projek tidak mencetuskan dialog. Ini melindungi anda daripada memuatkan fail yang tidak berkaitan ke dalam konteks secara tidak sengaja.

Selepas beralih kepada persediaan ini dalam projek yang diterangkan, CLAUDE.md saya berkurang daripada 250 baris kepada 60: @AGENTS.md serta lima hingga tujuh peraturan yang hanya terpakai kepada Claude Code (plan mode untuk direktori berisiko, perkara yang tidak boleh dibuat dalam bahagian pentadbir, dan cara menulis commit). Semua perkara yang dikongsi berada dalam AGENTS.md, yang dibaca oleh Codex dan Cursor.

Bilakah anda patut memilih pautan simbolik, dan bilakah import?#

Dokumentasi menunjukkan pilihan pautan simbolik seperti ini:

ln -s AGENTS.md CLAUDE.md

Dokumentasi itu kemudian memberikan amaran terus terang tentang Windows:

Jadual perbandingan:

Saya menggunakan import dalam projek yang diterangkan. Sebabnya:

1. Pasukan menggunakan sistem yang berbeza. Saya menggunakan Mac; dalam contoh ini, pasukan dibahagikan kira-kira sama rata antara pengguna Windows dan Mac. Jika pautan simbolik muncul dalam repositori, bagi pengguna Windows tanpa Developer Mode, fail itu akan dibuat checkout sebagai fail teks biasa yang mengandungi satu baris, AGENTS.md. Ini menyebabkan pepijat pelik: kadangkala peraturan berfungsi, kadangkala tidak, dan sebabnya tidak jelas.
2. Saya mahukan peraturan khusus Claude. Di bawah @AGENTS.md, CLAUDE.md saya mempunyai bahagian “Claude Code” dengan peraturan: gunakan --effort high untuk tugasan seni bina, jalankan npm run build sebelum git push, dan jangan panggil /api/v1/deploy secara manual. Codex tidak memahami arahan ini.
3. Lebih mudah untuk nyahpepijat. Apabila berlaku masalah, saya membuka CLAUDE.md dan melihat import serta penggantian saya. Pautan simbolik tidak menyatakan “ini telah ditambah di sini”. Untuk maklumat lanjut tentang nyahpepijat tetapan Claude Code, lihat panduan mod selamat.

Jika anda tiada peraturan khusus Claude, pautan simbolik tidak lagi diperlukan bermula dengan versi 2.1.277: padamkan CLAUDE.md, dan Claude Code akan membaca AGENTS.md sendiri. Kekalkan pautan simbolik hanya jika seseorang dalam pasukan menggunakan versi lebih lama daripada 2.1.277 dan tidak boleh mengemas kini. Jika anda mempunyai peraturan khusus Claude, import lebih mudah dalam sembilan daripada sepuluh keadaan.

Apakah yang dibaca oleh Codex, Cursor, Copilot, Windsurf dan Gemini CLI?#

Peta tujuh alat utama (berdasarkan dokumentasi rasmi setiap alat):

Apakah kesimpulannya? Jika repositori mempunyai AGENTS.md (serta CLAUDE.md dengan import apabila peraturan khusus Claude diperlukan), lima daripada tujuh alat mendapat arahan terkini secara automatik. Cursor dan Windsurf, yang mempunyai fail natif sendiri, boleh dibiarkan seperti sedia ada (AGENTS.md juga dibaca oleh kedua-duanya) atau boleh ditambah import @AGENTS.md—tetapi sintaksnya berbeza dan tidak sentiasa disokong.

Strategi paling ringkas untuk projek baharu:

1. Letakkan semua peraturan bersama dalam AGENTS.md—95% peraturan sepatutnya berada di situ.
2. Cipta CLAUDE.md jika anda memerlukan peraturan khusus Claude: letakkan @AGENTS.md pada baris pertama, kemudian tambah bahagian yang mengandungi peraturan khusus Claude sahaja. Jika tiada peraturan sedemikian, CLAUDE.md tidak diperlukan; Claude Code telah membaca AGENTS.md sendiri sejak versi 2.1.277.
3. Kekalkan .cursor/rules/ untuk Cursor bagi kes jarang apabila sesuatu yang khusus untuk Cursor diperlukan (arahannya @Codebase dan @Docs).
4. Lakukan perkara yang sama untuk Windsurf: lupakan .windsurfrules lama; gunakan .windsurf/rules/ yang baharu hanya apabila anda memerlukan corak untuk sintaksnya.

Pendekatan ini memberikan 80% manfaat dengan 20% usaha. Berdasarkan pengalaman saya, apabila menyusun pasukan bercampur dalam “Antigravity”, mengekalkan lebih daripada dua sumber kebenaran (bersama dan khusus Claude) menjadi sukar. Jika seseorang dalam pasukan menambah peraturan pada .cursorrules dan terlupa tentang AGENTS.md, seminggu kemudian Cursor dan Codex akan bercanggah.

Bagaimanakah /init dalam Claude Code mengambil AGENTS.md yang sedia ada?#

Anthropic menerangkan /init begini dalam dokumentasinya:

Apakah maksudnya dalam amalan? Repositori yang saya terangkan mempunyai .cursorrules daripada masa saya mencuba Cursor (kira-kira 80 baris), dan AGENTS.md (120 baris, disusun secara manual). Apabila saya menjalankan claude /init, arahan itu mengambil kedua-dua fail, membuang peraturan yang serupa dan menyusun CLAUDE.md yang kemas dalam masa seminit. Saya menyemaknya selepas itu dan membuat sedikit suntingan—membuang item lapuk dan menambah struktur dengan tajuk. Ini lebih pantas daripada menulis semula dari awal.

Mod interaktif, yang membolehkan /init turut membaca AGENTS.md, didayakan melalui pemboleh ubah persekitaran:

CLAUDE_CODE_NEW_INIT=1 claude

Selepas /init bermula, Claude akan mengemukakan beberapa soalan penjelasan: artifak yang hendak dikonfigurasi (CLAUDE.md, skills, hooks), stack yang digunakan projek dan arahan yang digunakan untuk ujian. Kemudian subagent meneroka pangkalan kod—membaca package.json, README.md dan fail konfigurasi—lalu mengisi bahagian yang belum lengkap. Pada akhirnya, ia memaparkan cadangan yang boleh anda sunting sebelum menyimpannya. Untuk maklumat lanjut tentang mengkonfigurasi Claude Code ketika memulakan projek, lihat panduan berasingan.

Kini tentang kelemahannya. Jika projek sudah mempunyai AGENTS.md yang aktif, /init akan mencipta CLAUDE.md di sebelahnya yang mengandungi salinan peraturannya. Mulai saat itu, secara lalai Claude Code hanya membaca CLAUDE.md, jadi terdapat dua sumber kebenaran sekali lagi: anda mengemas kini AGENTS.md, sementara Claude terus menggunakan salinan lama. Arahan /import melakukan sesuatu yang serupa: ia menambah salinan sekali sahaja daripada AGENTS.md kepada CLAUDE.md. Untuk mengekalkan satu sumber, letakkan import @AGENTS.md pada baris pertama CLAUDE.md selepas /init, dan buang apa-apa daripada CLAUDE.md yang mengulangi kandungan AGENTS.md.

/init ialah titik permulaan yang sesuai untuk projek baharu atau projek yang anda pindahkan daripada Cursor atau Copilot. Tidak perlu mencari dalam talian untuk “templat CLAUDE.md terbaik”—Anthropic sudah mengambil kira kandungan repositori. Jika projek sudah mempunyai AGENTS.md yang aktif dan tiada peraturan khusus Claude, /init tidak diperlukan: Claude Code akan membaca AGENTS.md sendiri.

Bagaimanakah cara memisahkan arahan bersama daripada arahan khusus Claude?#

Saya memisahkannya berdasarkan prinsip ini. Peraturan bersama yang diletakkan dalam AGENTS.md:

• Perkara yang tidak boleh disentuh dalam kod. Folder .env, node_modules, prisma/migrations (hanya melalui prisma migrate), .next/, .git/.
• Cara menamakan perkara. Branch: feat/, fix/, chore/. Commit: awalan feat:, fix:, docs: diikuti penerangan ringkas. Fail komponen dalam kebab-case.
• Arahan ujian/lint. npm run build, npm run lint, npm test. Arahan yang perlu dijalankan sebelum git push.
• Prinsip seni bina. Perkara yang diletakkan dalam src/lib/, perkara yang diletakkan dalam src/components/, tempat logik perniagaan berada dan tempat UI berada.
• Keselamatan. Jangan sekali-kali commit rahsia. Akses pangkalan data production hanya melalui prod-psql. Akses production melalui SSH hanya menggunakan alias prod, bukan root@IP.

Peraturan khusus Claude yang diletakkan dalam CLAUDE.md (di bawah @AGENTS.md):

• Plan mode. Gunakan plan mode untuk perubahan dalam direktori berisiko (contohnya, src/billing/).
• Tahap usaha. Gunakan --effort high untuk tugasan seni bina dan medium untuk kerja rutin.
• Skills. Ejen AI dan skills yang perlu dijalankan dalam situasi tertentu. Contohnya: “apabila bekerja pada panduan, jalankan skill build-masterskaya-guide.”
• Memori Claude. Perkara yang perlu dimasukkan ke dalam memori automatik dan perkara yang perlu diletakkan dalam CLAUDE.local.md. Untuk maklumat lanjut tentang memori Claude, lihat panduan Memory dan CLAUDE.md.
• Hooks. Jika .claude/settings.json mempunyai hooks yang dikonfigurasi, terangkan fungsinya dalam CLAUDE.md (Codex dan Cursor tidak mengetahuinya dan tidak perlu mengetahuinya).
• Skills dan arahan. Senarai arahan garis miring yang kerap saya gunakan (/init, /cd, /memory, /plan).

Sempadannya tidak semestinya jelas. Contohnya, “jangan sekali-kali jalankan git push --force ke main” jelas merupakan peraturan bersama, jadi ia diletakkan dalam AGENTS.md. Tetapi “apabila menjalankan git push ke branch hot, gunakan plan mode dahulu” khusus kepada Claude Code, jadi ia diletakkan dalam CLAUDE.md. Uji dengan bertanya: “Jika saya membuang Claude Code esok dan hanya mengekalkan Codex, adakah peraturan ini masih terpakai?” Jika ya, letakkannya dalam AGENTS.md. Jika tidak, letakkannya dalam CLAUDE.md.

Apakah yang patut diletakkan dalam AGENTS.md, dan apakah yang patut diletakkan dalam CLAUDE.md atau .claude/rules?#

Jika peraturan melebihi 200 baris, sudah tiba masanya untuk memecahkannya. Dokumentasi Anthropic mengesyorkan sasaran 200 baris bagi setiap fail, kerana fail CLAUDE.md yang panjang menyebabkan Claude kurang mematuhi arahan secara senyap: nampaknya ia membacanya, tetapi ia semakin jarang mengikutinya.

Struktur untuk projek besar yang berkesan bagi saya:

my-project/
├── AGENTS.md                    # 100-150 lines, shared
├── CLAUDE.md                    # 30-50 lines: @AGENTS.md + Claude-only
└── .claude/
    ├── CLAUDE.md                # alternative to root file, same file
    └── rules/
        ├── api.md               # with paths: ['src/api/**']
        ├── components.md        # with paths: ['src/components/**']
        ├── testing.md           # without paths, always active
        └── security.md          # without paths, always active

Setiap fail dalam .claude/rules/ boleh mempunyai frontmatter:

---
paths:
  - "src/api/**/*.ts"
---

# API rules
- Every endpoint validates input with zod
- Errors use the standard `{error, code}` format
- OpenAPI comments are required

Claude memuatkan peraturan ini hanya apabila bekerja dengan fail yang sepadan dengan corak tersebut. Jika ia menyentuh src/components/Button.tsx, peraturan API tidak ditambah ke dalam konteks. Dengan cara ini, tetingkap konteks hanya digunakan untuk perkara yang relevan. Direktori .claude/rules/ juga berfungsi tanpa CLAUDE.md: jika projek hanya mengandungi AGENTS.md, peraturannya dimuatkan bersama fail itu dan tidak menyahdayakan bacaan terus AGENTS.md.

Cursor dan Windsurf menyokong pendekatan yang sama melalui direktori .cursor/rules/ dan .windsurf/rules/. Piawaian AGENTS.md boleh merujuk kepada direktori ini, tetapi sintaks merentas alat masih belum stabil sepenuhnya. Lebih selamat untuk mengekalkan peraturan bersama dalam AGENTS.md dan menggandakan peraturan berskop laluan dalam .claude/rules/ dan .cursor/rules/—ini kes khusus yang jarang berlaku, bukannya sebahagian besar peraturan.

Lokasi berguna untuk CLAUDE.md (mengikut susunan daripada paling luas kepada paling khusus):

Contoh ~/.claude/CLAUDE.md mungkin mengandungi dua peraturan: “balas dalam bahasa pilihan pengguna” dan “eja Ailoot tepat seperti ini.” Peraturan ini terpakai kepada setiap projek, jadi tidak perlu menggandakannya dalam setiap repositori.

Daripada empat tahap ini, hanya CLAUDE.md peringkat projek dan CLAUDE.local.md menyahdayakan bacaan terus AGENTS.md. ~/.claude/CLAUDE.md peribadi dan dasar terurus tidak menghalangnya; Claude Code membaca kedua-duanya bersama AGENTS.md.

Apakah yang patut anda lakukan jika AGENTS.md sudah lapuk dalam projek anda?#

Dalam projek yang saya huraikan, saya mempunyai AGENTS.md dari Mei 2025—180 baris, banyak daripadanya sudah lapuk (ia menyebut endpoint Anthropic API yang telah berubah sejak itu; contoh sintaks claude --tools yang tidak lagi wujud; dan peraturan mengenai ~/.claude/projects/ dengan struktur yang sudah lapuk).

Pelan yang saya gunakan untuk mengemas kininya:

1. Semak dengan claude dalam plan mode. Saya membuka repositori, menjalankan claude --safe-mode, dan meminta: “Baca semula AGENTS.md dan cadangkan senarai item yang sudah lapuk atau berulang. Jangan editnya; senaraikan sahaja.” Dalam masa dua minit, saya mendapat senarai 23 item untuk disemak.
2. Buang item yang jelas sudah lapuk. Daripada 23 item, 9 memang sudah lapuk—sintaks arahan, endpoint dan nama flag. Saya memadamkan baris tersebut.
3. Gabungkan pendua. Enam item lain mengulangi perkara yang sama dengan kata-kata berbeza (“jangan buat force-push,” “jangan sekali-kali gunakan --force,” “elakkan git push -f”). Saya menggabungkannya menjadi satu baris.
4. Tambah item baharu. Saya menambah perkara yang saya perhatikan sering dilakukan dengan salah oleh Claude/Codex sepanjang bulan lalu, berdasarkan peraturan “satu baris bagi setiap corak kesilapan”. Hasilnya ialah 8 item baharu.
5. Minta subagent membuat semakan akhir. Saya meminta Claude menyemak dengan arahan “cari percanggahan, kekaburan dan pendua.” Ia menemui tiga frasa yang boleh diperjelas. Saya membetulkannya.

Selepas sejam, AGENTS.md mempunyai 110 baris, terkini, dan saya mengenali setiap baris secara peribadi. Mudah untuk membina CLAUDE.md sepanjang 30 baris daripadanya. Codex juga menjadi jauh lebih berhati-hati dengan ujian selepas itu—saya mengesyaki beberapa keputusannya yang “pelik” berpunca daripada arahan lapuk yang dipatuhinya dengan niat baik.

Prinsip utama untuk AGENTS.md yang sentiasa berkembang:

• Setiap peraturan menjawab kesilapan berulang. Jika saya tidak teringat tentang sesuatu peraturan walaupun sekali sepanjang bulan itu, tidak ada gunanya mengekalkannya.
• Tulis peraturan sebagai arahan, bukan teori. “Gunakan dua ruang” ialah peraturan. “Gaya kod patut kemas” bukan.
• Perincian mengatasi keumuman. “Jalankan npm run build sebelum git push” ialah peraturan. “Uji perubahan anda” bukan.

Apakah yang sememangnya TIDAK berfungsi dengan persediaan ini?#

Beberapa perkara yang saya pelajari dengan cara yang sukar sepanjang enam bulan bekerja menggunakan persediaan ini:

1. Autolengkap Cursor tidak menggunakan AGENTS.md. Apabila Cursor mencadangkan pelengkapan baris dalam editor, ia tidak membaca AGENTS.md dalam masa nyata—ada enjin pantas yang berasingan. Peraturan dalam AGENTS.md hanya penting apabila anda membuat permintaan dalam sembang Cursor. Ini bermakna menulis “jangan gunakan var, gunakan const” dalam AGENTS.md tidak akan mempengaruhi autolengkap; anda perlu mengkonfigurasikannya melalui ESLint atau konfigurasi TypeScript.

2. Hooks Claude Code dalam AGENTS.md tidak berfungsi untuk Codex. Jika .claude/settings.json mempunyai hook PreToolUse yang dikonfigurasi untuk menyekat tindakan tertentu, maklumat itu hanya berguna untuk Claude. Codex tidak tahu tentang hooks; baginya, “alat itu membuat keputusan sendiri.” Wajar untuk menulis “jangan buat X” dalam AGENTS.md, dan “terdapat hook yang menyekat X secara fizikal” dalam CLAUDE.md di bawah import.

3. Copilot dan .github/copilot-instructions.md. GitHub Copilot membaca failnya sendiri dan masih tidak membaca AGENTS.md dengan begitu baik. Jika pasukan anda aktif menggunakan Copilot, sama ada tambahkan .github/copilot-instructions.md berasingan dengan versi ringkas peraturan itu, atau gunakan Copilot Extensions yang mengetahui tentang AGENTS.md. Perkara ini berubah dengan pantas, jadi keadaannya mungkin berbeza dalam masa tiga hingga enam bulan.

4. Git tidak menjejak pautan simbolik sebagai perubahan CLAUDE.md. Jika anda menjalankan ln -s AGENTS.md CLAUDE.md dan mengemas kini AGENTS.md seminggu kemudian, Git hanya akan menunjukkan diff untuk AGENTS.md. Itu perkara biasa, tetapi rakan sekerja yang menyemak PR mungkin tidak sedar bahawa CLAUDE.md juga telah dikemas kini (melalui pautan simbolik). Penyelesaian: nyatakan secara jelas dalam huraian PR, “AGENTS.md dikemas kini; Claude Code melihat fail yang sama melalui pautan simbolik.”

5. Import bersarang dalam-dalam sukar dinyahpepijat. Jika AGENTS.md mengimport @docs/coding-style.md, yang mengimport @docs/typescript.md, dan terdapat peraturan yang bercanggah, penyahpepijatan sukar dilakukan. Saya mengehadkan import kepada satu tahap (CLAUDE.md → AGENTS.md) dan tidak menyarangnya lebih jauh. Anthropic menyediakan hook InstructionsLoaded yang merekod fail yang dimuatkan—berguna untuk menyahpepijat persediaan berlapis. Nota: hook ini dicetuskan untuk AGENTS.md yang disertakan melalui import atau pautan simbolik, tetapi bukan untuk AGENTS.md yang dibaca sendiri oleh Claude Code.

Persediaan vibe coding lengkap untuk satu malam: klon AI + Second Brain + kejuruteraan konteks.

Kenali Ailoot.