# Cara Menyiapkan CLAUDE.md pada 2026: Template dan 6 Aturan > Template CLAUDE.md siap pakai, 6 aturan untuk menjaga file tetap hidup, dan analisis file kerja dari bisnis aktif. Termasuk kutipan resmi Anthropic. Source: https://ailoot.ai/blog/id/claude-md-template/ Canonical: https://ailoot.ai/blog/id/claude-md-template/ Language: id Publisher: Ailoot (https://ailoot.ai/) Translation: guide-126 Revision: sha256-3354290f334e6b8fc7bcc01847e68f34d6407435c8766b0f64b6d8c97fa0b15b
Poin utama CLAUDE.md adalah file teks di akar proyek yang dibaca Claude Code di awal setiap sesi. Tanpanya, agen memulai dari awal setiap kali: Anda menghabiskan 5-10 menit untuk mengatakan, “Hai, saya sedang mengerjakan proyek ini, ini audiens saya, dan ini gaya saya.” File awal yang ringkas sering menargetkan 100-200 baris; itu panduan peninjauan, bukan batas teknis. Template ini berisi 6 bagian (deskripsi, alat, struktur, perutean file, aturan, dan bahasa), dan diperbarui setiap kali Claude membuat kesalahan. Artikel ini mencakup template siap pakai, 6 aturan, analisis file kerja dari bisnis aktif, dan daftar periksa audit 12 poin.
Materi tentang vibe coding: alat, studi kasus, kesalahan. [Panduan Ailoot](https://ailoot.ai/docs/).
[Panduan Ailoot](https://ailoot.ai/docs/)
## Mengapa Anda memerlukan CLAUDE.md, dan mengapa Claude melupakan proyek tanpanya?
Poin utama Di Claude Code, setiap obrolan baru dimulai dengan konteks kosong. CLAUDE.md adalah satu-satunya file yang otomatis dimuat Claude ke setiap sesi baru. Tanpanya, agen bekerja seperti pegawai magang pada hari pertama: mereka tidak tahu apa pun tentang bisnis, gaya, atau aturan Anda. Dengannya, mereka bekerja seperti pegawai yang sudah memasuki tahun kedua.
Anda membuka Claude Code pada hari Selasa dan menjelaskan: “Saya sedang mengerjakan proyek ini, ini alat-alatnya, jangan lakukan ini.” Berhasil. Pada hari Kamis, obrolan yang sama sudah berakhir, jadi Anda mengulang semuanya. Pada hari Sabtu, lagi; pada hari Senin, sekali lagi. Begitulah bekerja dengan agen tanpa CLAUDE.md: setiap jendela baru adalah pegawai magang yang mulai dari nol, yang harus diberi tahu hal yang sama berulang kali. Dulu saya menghabiskan 5-10 menit mengetik pengantar ini untuk setiap sesi. Prompt menjadi panjang karena saya harus membawa semua konteks secara manual. Hasilnya tetap generik: agen tidak tahu audiens, ekonomi, atau prinsip saya.
Catatan Ini bukan masalah memori model. Ini masalah arsitektur. Claude Code sengaja memulai dengan konteks bersih di setiap sesi; kalau tidak, proyek-proyek berbeda di komputer yang sama akan tercampur. CLAUDE.md adalah mekanisme untuk memberi tahu agen apa yang harus dimuat.
Dengan CLAUDE.md yang terus diperbarui, pengantar itu tidak lagi diperlukan. Semua aturan yang dulu Anda ulangi di setiap obrolan kini ada dalam satu file dan otomatis muncul di awal setiap sesi. Prompt menjadi singkat: “lakukan X,” alih-alih “Saya sedang mengerjakan proyek Y, alat-alatnya Z, jangan lakukan A atau B, dan ingat juga C.” Lalu, kesalahan yang berulang pun berhenti terjadi. Setiap kesalahan agen menjadi alasan untuk menambahkan satu baris ke CLAUDE.md. Setelah sebulan, Anda memiliki “konstitusi proyek” yang terus hidup, dan Claude berhenti terjerumus ke jebakan-jebakan yang sama. Ada lapisan ketiga: agen berhenti menulis tanpa konteks. Melalui `CLAUDE.md`, saya mengarahkan Claude ke folder berisi konteks: tempat mencari informasi tentang audiens, harga, dan merek. Tanpa perutean ini, agen menulis “solusi berkualitas tinggi” tanpa mengetahui ekonomi bisnis saya, sehingga hasilnya abstrak, klise, dan “sama seperti yang lain.” ## Apa itu CLAUDE.md, dan dalam urutan apa Claude membacanya?
Poin utama CLAUDE.md adalah file teks dalam format Markdown. Claude Code mencarinya di empat tempat sekaligus: tingkat sistem, tingkat pengguna, akar proyek, dan catatan lokal. Keempatnya dimuat ke dalam konteks pada awal setiap sesi. Nama file peka huruf besar-kecil: selalu gunakan `CLAUDE.md` dengan huruf kapital.
Anthropic menjelaskan CLAUDE.md seperti ini dalam dokumentasi resminya:
File CLAUDE.md adalah file Markdown yang memberikan instruksi persisten kepada Claude untuk proyek, alur kerja pribadi, atau seluruh organisasi Anda. Anda menulisnya dalam teks biasa, dan Claude membacanya pada awal setiap sesi.
— Anthropic, code.claude.com/docs/en/memory
Empat tempat Claude Code mencari CLAUDE.md, menurut urutan prioritas yang meningkat: | Tingkat | Lokasi | Tujuan | |----|----|----| | **Organisasi** | `/Library/Application Support/ClaudeCode/CLAUDE.md` di Mac, `/etc/claude-code/CLAUDE.md` di Linux | Aturan yang diterapkan admin perusahaan untuk seluruh tim melalui MDM. Sebagai individu, Anda tidak memerlukannya. | | **Pengguna** | `~/.claude/CLAUDE.md` | Aturan pribadi yang berlaku di semua proyek Anda. “Selalu jawab dalam bahasa pilihan pengguna,” “jangan gunakan em dash.” | | **Proyek** | `./CLAUDE.md` di akar proyek atau `./.claude/CLAUDE.md` | Aturan khusus proyek: alat, struktur folder, logika bisnis. File ini di-commit ke git. | | **Lokal** | `./CLAUDE.local.md` | Catatan pribadi Anda untuk proyek ini yang tidak seharusnya masuk ke git. Misalnya, eksperimen sementara atau preferensi pribadi yang tidak diperlukan tim. | Keempat file dimuat ke dalam konteks pada saat yang sama. Jika aturannya bertentangan, Anthropic menyatakan langsung dalam dokumentasinya bahwa tidak diketahui aturan mana yang akan didahulukan; Claude mungkin memilih salah satunya secara acak. Jadi, lebih sederhana untuk menyimpan semua hal penting di CLAUDE.md proyek dan menghindari duplikasi.
Tips Nama file sangat peka huruf besar-kecil. Gunakan `CLAUDE.md` dengan huruf kapital agar Claude membacanya. Claude tidak akan membaca `claude.md` atau `Claude.md`. Hal yang sama berlaku untuk `CLAUDE.local.md`. Ini kesalahan umum bagi orang yang baru menyiapkan Claude Code: mereka membuat file, menulis instruksi, bertanya-tanya mengapa tidak berfungsi, lalu baru menyadari nama filenya menggunakan huruf kecil.
Ada satu detail teknis yang hampir tidak pernah dibahas, tetapi menjelaskan banyak perilaku aneh.
Isi CLAUDE.md dikirim sebagai pesan pengguna setelah prompt sistem, bukan sebagai bagian dari prompt sistem. Claude membacanya dan berusaha mengikutinya, tetapi kepatuhan ketat tidak dijamin.
— Anthropic, code.claude.com/docs/en/memory
Dengan kata lain, CLAUDE.md bukan “prompt sistem” dalam arti yang ketat. Itu adalah pesan pengguna pertama yang dilihat Claude. Jadi, aturannya merupakan saran kuat, bukan hukum. Jika aturan perlu ditegakkan, gunakan hook teruji untuk peristiwa yang dicakupnya serta izin atau isolasi lingkungan untuk batas akses yang lebih luas. Hook yang berjalan otomatis tidak membuat pemeriksaannya menjadi lengkap. Saya akan menjelaskan batas antara `hooks` dan `CLAUDE.md` di bawah. ## Bagaimana menulis CLAUDE.md minimal dalam 5 menit (template siap pakai)?
Poin utama Salin template, ganti bagian dalam tanda kurung siku, lalu simpan di akar proyek sebagai `CLAUDE.md`. Itu cukup untuk mencegah Claude memulai dari awal di setiap sesi. Anda bisa mengembangkannya sambil berjalan dengan aturan: “setelah setiap kesalahan agen, tambahkan satu baris.”
Di bawah ini adalah template yang telah saya uji di puluhan proyek saya. Panjang file tetap sekitar 80-120 baris, sesuai rekomendasi Anthropic untuk mengusahakan kurang dari 200 baris. Dengan template ini, agen memberikan hasil yang paling masuk akal. ```markdown # [PROJECT NAME] - project navigation This document is the project map. Read it at the start of every session to understand where things are and how to work with them. ## What this project is **[NAME]** - [one sentence: what it is and who it’s for]. [1-2 sentences: what problem it solves and how]. Details are in `business/INDEX.md`. ## Reading order at the start of every session 1. `about-me/INDEX.md` - who I am and how I think 2. `business/INDEX.md` - what we do (product, audience, economics) 3. `CLAUDE.md` (this file) - repo rules, tools, navigation 4. Task area: the relevant file from `business/`, `plans/`, `mastery/` or the feature folder in the code Principle: layer 1 (about me) comes before layer 2 (business) for a reason. First, **who** is thinking, then **about what**. ## Repository structure [NAME]/ ├── CLAUDE.md ← this file, navigation ├── about-me/ ← digital projection of you (how you think, what you value) │ └── INDEX.md ├── business/ ← the business’s second brain │ ├── INDEX.md │ ├── audience/ ← customer profile │ ├── products/ ← products, prices │ ├── goals/ ← goals, metrics │ └── economics/ ← unit economics, revenue ├── plans/ ← technical plans (one plan = one feature) ├── retrospectives/ ← reflections after each session └── (project code) ### Where to find things | What you need | Where to look | |---|---| | Why we’re building the project, and for whom | `business/INDEX.md` | | Target customer, pains, desires | `business/audience/` | | Product, plans, prices | `business/products/` | | Goals and metrics | `business/goals/` | | Economics | `business/economics/` | | Technical plans | `plans/` | ## Tools [INSERT TOOLS - for example: Next.js 14, TypeScript, Tailwind CSS, Prisma + PostgreSQL]. ## Repo rules 1. Never hardcode dynamic data (prices, dates, figures) - get everything from files in `business/` and the LIVE marker. 2. Don’t publish without my explicit command. 3. Before `git push`, run `npm run build` and check that it builds without errors or warnings. 4. Add files by name with `git add`. Never use `git add .` or `git add -A`. 5. Don’t read `.env` in full. To check a variable, use `grep "^VAR=" .env`. ## Big features = a plan in `plans/` Any task lasting more than an hour must be written up as a plan in the `plans/` folder: 1. Filename: `YYYY-MM-DD-feature-name.md`. 2. Divide the plan into phases. Mark each phase `[ ]` or `[x]`. 3. At the end of the plan, add a summary: whether it was fully implemented and what remains. ## End-of-feature cycle After each feature is complete, go through these 5 steps: 1. Find errors → prove them with an example → fix them. 2. What was missed (edge cases, input validation, error handling). 3. Is this a real problem in our project? Check `business/` and `plans/`. 4. Take a fresh look: reread the diff as if you’re seeing it for the first time. 5. Security review. Especially: personal data and third-party materials. ## End-of-session reflection In `retrospectives/YYYY-MM-DD_short-name.md`, record: 1. What the task was. 2. How it was solved. 3. Whether it was solved - yes / no / partially. 4. What could have been done better. 5. What was learned about the user or project. ## Language Always respond in the user’s preferred language. Use hyphens only, not em dashes. ``` Agar Claude mengisi template ini secara otomatis untuk proyek Anda, berikan prompt berikut. Claude akan membaca konteks dan mengisi bagian dalam tanda kurung siku:
Prompt: Isi CLAUDE.md untuk proyek saya ``` Buat file CLAUDE.md di akar proyek menggunakan template ini: [TEMPELKAN SELURUH TEMPLATE DI ATAS] Ikuti langkah-langkah berikut: Baca about-me/INDEX.md dan business/INDEX.md untuk memahami konteks proyek dan saya sebagai penulis. Isi semua bagian dalam tanda kurung siku pada template berdasarkan informasi yang Anda temukan di folder tersebut. Jika ada informasi yang belum tersedia, ajukan pertanyaan klarifikasi satu per satu, dengan 3-4 pilihan jawaban. Usahakan CLAUDE.md hasilnya kurang dari 200 baris. Jika lebih panjang, tinjau pengulangan dan pindahkan prosedur terperinci ke file tertaut. Pertahankan aturan utama untuk perencanaan, refleksi, dan repo, lalu uji pada tugas yang mewakili pekerjaan. Tampilkan file final kepada saya dan tanyakan bagian mana yang perlu direvisi. Selalu jawab dalam bahasa pilihan pengguna. ```
Jika Anda belum memiliki folder `about-me/` dan `business/`, tidak apa-apa. Claude akan mengajukan pertanyaan klarifikasi dan menyusun CLAUDE.md minimal berdasarkan informasi yang tersedia. Anda bisa membuat folder-folder itu nanti, setelah tahu apa yang perlu dimasukkan. ## Apa 6 aturan yang membuat CLAUDE.md menjadi dokumen yang terus hidup?
Poin utama Enam aturan ini merupakan rangkuman pengalaman dari puluhan proyek. Aturan-aturan ini mengubah CLAUDE.md dari “file yang dibuat lalu dilupakan” menjadi dokumen kerja yang dibaca Claude di setiap sesi.
### Aturan 1. Batasi hingga kurang dari 200 baris Anthropic menyatakannya secara ringkas dalam dokumentasi resminya:
Usahakan CLAUDE.md kurang dari 200 baris. File yang lebih panjang menggunakan lebih banyak konteks dan mengurangi kepatuhan terhadap instruksi.
— Anthropic, code.claude.com/docs/en/memory
CLAUDE.md yang panjang merugikan dirinya sendiri dengan dua cara. Pertama, file itu menghabiskan token. File instruksi sepanjang 800 baris dimuat di setiap jendela dan memakai beberapa ribu token dari jatah Anda di setiap sesi. Dengan langganan Pro yang memiliki batas harian, jumlah sesi yang tersedia berkurang secara nyata. Kedua, model mulai mengabaikan aturan. Dokumentasi menyarankan untuk mengusahakan kurang dari 200 baris guna mengurangi penggunaan konteks dan meningkatkan kepatuhan. Dokumentasi itu tidak menetapkan batas kegagalan tajam pada baris ke-201. Tinjau relevansi, pertentangan, volume token yang dimuat, dan hasil tugas nyata sebelum memutuskan apa yang perlu dipindahkan.
Peringatan Jika file Anda sudah mencapai 300-500 baris, jangan panik - pisahkan kontennya ke beberapa folder. Letakkan aturan terperinci tentang, misalnya, sistem desain, di `business/assets/brand-guidelines.md`. CLAUDE.md cukup merujuk ke sana dalam satu baris: “Saat mengerjakan UI, lihat `business/assets/brand-guidelines.md`.” Prinsip peruteannya: CLAUDE.md adalah daftar isi, bukan buku.
### Aturan 2. Akhiri setiap sesi dengan refleksi Di CLAUDE.md, tulis: “Di akhir setiap sesi, catat hal yang Anda kerjakan dan pelajari di `retrospectives/YYYY-MM-DD_*.md`.” Setelah baris ini ditambahkan, Claude akan mulai mengakhiri setiap sesi dengan refleksi sendiri; Anda tidak perlu memintanya. Mengapa perlu refleksi: - Dua minggu kemudian, Anda dapat membuka retrospektif lama dan mengingat alasan memilih jalur tersebut. - Ketika kembali ke proyek sebulan kemudian, Anda memiliki peta siap pakai tentang keputusan terbaru. - Jika bekerja dengan tim, rekan dapat membaca retrospektif dan memahami keadaan terkini dalam 2 menit, tanpa perlu menelepon. ### Aturan 3. Buat commit setelah setiap tugas selesai CLAUDE.md saya menyatakan: “Setelah setiap tugas selesai, buat git commit dengan pesan yang bermakna.” Claude pun mulai membagi pekerjaan menjadi commit atomik dengan sendirinya. Ini memberi Anda dua hal. Pertama, jika terjadi kerusakan, Anda dapat membatalkan satu operasi, bukan “semua yang saya lakukan hari ini.” Kedua, riwayat commit menjadi catatan kerja yang menunjukkan perubahan apa yang terjadi dan dalam urutan apa. ### Aturan 4. Selalu periksa folder `business/` Untuk tugas apa pun yang melibatkan pelanggan, produk, atau naskah, agen sebaiknya lebih dahulu membuka `business/INDEX.md` dan file terkait yang dirujuk di sana. CLAUDE.md saya menyatakan secara eksplisit: “Saat mengerjakan UI atau naskah, periksa dulu `business/audience/avatar.md` dan `business/assets/brand-guidelines.md`.” Tanpa aturan ini, Claude menulis naskah dengan “gaya umum situs web berkualitas.” Dengan aturan ini, naskah mengikuti gaya Anda, ditujukan kepada pelanggan Anda, dan tidak menggunakan kata-kata terlarang. ### Aturan 5. Tambahkan aturan setelah setiap kesalahan agen Inilah aturan utama yang membuat CLAUDE.md terus hidup. Contoh dari CLAUDE.md saya sendiri yang ditambahkan setelah kesalahan tertentu: - “Jangan pernah memasukkan file WIP orang lain dengan `git add .` - stage file berdasarkan nama.” - “Sebelum melakukan push ke `main`, periksa `git log origin/main..main --oneline` - jika hasilnya tidak kosong, jangan lakukan push.” - “Jangan mengarang nilai - ambil dari `.env` atau kode. Terutama URL, nama pengguna, dan token.” Setiap baris ini merupakan jejak insiden tertentu. Pernah ada agen yang memasukkan branch rekan yang belum selesai. Pernah saya memasukkan commit orang lain yang belum di-push. Pernah ada agen yang mengarang URL yang tidak ada. Setiap kesalahan menjadi aturan, dan luka yang ditimbulkan sendiri itu tidak terjadi lagi. ### Aturan 6. Letakkan keamanan di `.claude/settings.json`, bukan di CLAUDE.md Di CLAUDE.md, Anda bisa menulis “jangan sentuh `.env`,” tetapi itu hanya permintaan; Claude bisa saja melanggarnya karena CLAUDE.md dimuat sebagai pesan pengguna, bukan hukum. Untuk keamanan kritis, gunakan `.claude/settings.json`, tempat Anda dapat memblokir perintah tertentu secara ketat. Daftar blokir yang saya tambahkan ke setiap proyek baru: - `rm -rf` (penghapusan file secara rekursif). - Membaca seluruh isi `.env` (`Read .env`). - `export` dan `curl` dalam perintah yang sama (pola untuk membocorkan rahasia ke pihak luar). - `git push --force` tanpa persetujuan eksplisit.
Peringatan Perbedaannya sederhana: aturan dalam CLAUDE.md adalah saran yang dapat dilanggar agen. Aturan deny yang cocok memblokir tindakan yang dicakup dalam alur izin yang berlaku. Itu bukan bukti perlindungan terhadap setiap perintah setara, alat lain, atau mode izin berbeda. Simpan aturan keamanan kritis di `settings.json` dan semua hal lainnya di CLAUDE.md.
Temukan panduan lainnya di [Ailoot](https://ailoot.ai/docs/).
[Panduan Ailoot](https://ailoot.ai/docs/)
## Bagaimana struktur CLAUDE.md dalam bisnis aktif (anatomi file 280 baris)?
Poin utama Saya akan menguraikan struktur file CLAUDE.md yang digunakan layanan daring aktif. Panjang file ini sekitar 280 baris dan memiliki 11 bagian. Saya akan menunjukkan isi setiap bagian dan alasannya. Saya tidak akan memublikasikan teks aslinya; file itu berisi detail operasional. Namun, kerangkanya dapat diterapkan pada bisnis apa pun.
Sebagian besar contoh CLAUDE.md di internet merupakan template teknis untuk pengembang: “Gunakan TypeScript,” “Jangan menulis tes lebih dari 50 baris.” Bagi pengusaha, CLAUDE.md semacam ini tidak berguna - isinya tidak mencakup sisi bisnis. Di bawah ini adalah struktur CLAUDE.md kerja saya. Saya menghapus aturan dan jalur khusus karena mencerminkan operasi internal saya. Namun, struktur dan logika bagiannya dapat diterapkan pada proyek apa pun: sesuaikan dengan keadaan Anda sendiri, dan Anda akan mendapatkan file yang berfungsi. **1. Deskripsi singkat proyek (15 baris).** Apa yang kami lakukan, siapa audiensnya, dan produk apa yang kami tawarkan. Bukan ringkasan situs pemasaran, melainkan rangkuman untuk agen agar memahami “ke mana arah kita.” **2. Tentang saya (10 baris).** Rujukan ke folder `about-me/` - proyeksi digital cara saya berpikir. Nada, nilai, prinsip, kata-kata terlarang. Saat Claude menulis teks “sebagai saya,” ia membaca folder ini terlebih dahulu agar suaranya cocok. **3. Struktur repositori (20 baris).** Pohon dengan komentar: lokasi kode, konteks bisnis, rencana, dan refleksi. Tanpa peta ini, Claude mencari file secara membabi buta setiap kali. **4. Tabel “Di mana menemukan sesuatu” (25 baris).** Perutean dari “pertanyaan → file.” Misalnya, untuk agensi real estat, isinya bisa “perlu ketentuan hipotek → `business/products/mortgage.md`,” atau “perlu nada tulisan untuk postingan → `business/assets/voice.md`.” Ganti dengan file Anda sendiri. Tabel ini adalah inti CLAUDE.md. Tanpanya, agen menebak file mana yang berisi jawaban. Dengannya, agen langsung menuju sumbernya. **5. Prinsip utama proyek (40 baris, 10-15 butir).** Bagian ini bertambah perlahan dan paling banyak membutuhkan upaya. Setiap butir merupakan jejak kesalahan tertentu. Misalnya, untuk toko daring, aturannya bisa berbunyi “jangan pernah hardcode harga dan waktu pengiriman,” “jangan publikasikan produk tanpa perintah eksplisit,” dan “periksa gaya terhadap glosarium merek sebelum memublikasikan daftar produk.” Bagian ini adalah “konstitusi proyek.” **6. Perencanaan operasional (20 baris).** Tabel pemicu yang memetakan “ucapan pengguna → tindakan.” Misalnya: “Saat saya berkata ‘rencanakan minggu ini,’ buka `ops/monthly.md` dan buat file untuk minggu ini.” Ini menjadikan Claude asisten operasional yang memahami konteks perintah. **7. Alat (5 baris).** Teknologi. Singkat, tanpa basa-basi. **8. Publikasi (15 baris).** Proses langkah demi langkah untuk memublikasikan perubahan ke produksi: perintah yang dijalankan, urutannya, dan hal yang harus diperiksa. Dulu saya menjelaskannya setiap kali. Sekarang Claude sudah tahu. **9-12. Keamanan (35 baris).** Empat subbagian terpisah: aturan untuk menggunakan `.env`, akses ke basis data produksi, perintah aman untuk demo (rekaman layar, siaran, tangkapan layar, agar token tidak terekspos secara tidak sengaja), dan aturan untuk merotasi rahasia. **13. Folder `plans/` (10 baris).** Standar rencana: nama file, struktur fase, dan hal yang harus dimasukkan ke blok ringkasan. **14. Folder `retrospectives/` (5 baris).** Standar refleksi: template, nama file, dan isinya. **15. Data basis data langsung (15 baris).** Aturan untuk menandai “data terbaru”: ketika sebuah file menyatakan bahwa angka harus terkini, agen mengambilnya dari sumber alih-alih menggunakan angka lama. Ini menghilangkan risiko Claude menggunakan angka kemarin. **16. Bahasa (3 baris).** “Selalu jawab dalam bahasa pilihan pengguna. Gunakan tanda hubung saja, bukan em dash.” Jumlahnya sekitar 280 baris. Itu melebihi target keringkasan, tetapi tidak membuat file menjadi tidak valid. Dalam contoh ini file tetap berguna; keputusan mempertahankannya harus bergantung pada penggunaan konteks yang terukur dan pengujian tugas yang mewakili pekerjaan. Tabel tidak otomatis memakai lebih sedikit token daripada prosa.
Tips Struktur yang saya kembangkan selama setahun bekerja bukanlah dogma. Kerangkanya adalah: deskripsi (1-2 bagian), struktur dan perutean (2-3 bagian), aturan/prinsip (1 bagian besar), prosedur operasional (2-3 bagian khusus untuk bisnis Anda), dan detail kecil (bahasa, kontak). Lengkapi dengan detail khusus bisnis Anda. Aturan utamanya: setiap bagian harus menjawab pertanyaan, “Apakah Claude akan membuat kesalahan tanpa ini?” Jika tidak, hapus bagian itu.
## Apa fungsi perintah `/init`, dan mengapa itu belum cukup?
Poin utama Perintah `/init` di Claude Code secara otomatis membuat CLAUDE.md dasar dengan memindai proyek dan mencantumkan alat serta perintah build. Ini titik awal yang baik, tetapi tanpa konteks dan prinsip bisnis, file tersebut bersifat teknis dan generik. Gunakan `/init` sebagai langkah pertama, lalu tambahkan isinya secara manual.
Anthropic menjelaskan perintah ini dalam dokumentasinya:
Jalankan /init untuk membuat CLAUDE.md awal secara otomatis. Claude akan menganalisis kode Anda dan membuat file yang berisi perintah build, instruksi pengujian, dan konvensi proyek yang terdeteksi.
— Anthropic, code.claude.com/docs/en/memory
Hal yang dilakukan `/init` dengan baik: - Mengenali alat dari `package.json`, `Cargo.toml`, dan `pyproject.toml`. - Mencantumkan perintah build dan pengujian. - Mendeteksi konvensi dari file yang sudah ada (`.eslintrc`, `.prettierrc`). - Menemukan aturan Cursor (`.cursorrules`, `.cursor/rules/`) dan aturan Copilot yang sudah ada serta memasukkan bagian yang relevan. Perintah ini mendeteksi `AGENTS.md` dalam mode `CLAUDE_CODE_NEW_INIT=1`. Hal yang tidak dilakukan `/init`: - Tidak mengetahui siapa pelanggan Anda. - Tidak menyertakan kata-kata terlarang untuk naskah. - Tidak menambahkan aturan tentang kesalahan agen (karena belum pernah terjadi). - Tidak membuat tabel “di mana menemukan sesuatu” untuk struktur bisnis Anda. Jadi, alur kerja yang tepat adalah: 1. ### Jalankan /init di Claude Code Anda akan mendapatkan CLAUDE.md awal sepanjang 30-50 baris yang berisi alat dan perintah. Inilah fondasi teknisnya. 2. ### Tambahkan template dari artikel ini di atasnya Gunakan bagian “CLAUDE.md minimal dalam 5 menit.” Tambahkan bagian navigasi, perutean, dan prinsip. 3. ### Isi bagian dalam tanda kurung siku Berikan prompt kepada Claude: “baca proyek saya dan isi templatenya.” Jika folder `business/` dan `about-me/` belum ada, Claude akan mengajukan pertanyaan klarifikasi. 4. ### Lakukan uji stres Beri tahu Claude, “Baca CLAUDE.md saya dan temukan 10 ambiguitas yang dapat membuat Anda, sebagai agen, salah paham.” Anda akan mendapatkan daftar perbaikan. 5. ### Selanjutnya, gunakan file tersebut Tambahkan satu baris setelah setiap kesalahan agen. Dalam sebulan, Anda akan memiliki CLAUDE.md yang terus hidup dan disesuaikan dengan bisnis Anda. Prompt untuk langkah keempat:
Prompt: Uji stres CLAUDE.md ``` Saya memiliki CLAUDE.md. Besok saya akan membangun fitur berdasarkan file tersebut. Tugas Anda adalah menguji ketahanannya. Temukan 10 alasan yang dapat membuat kita gagal: di bagian mana CLAUDE.md ambigu sehingga Anda, sebagai agen, mungkin salah memahaminya di bagian mana ada kesenjangan yang akan memaksa Anda mengarang sesuatu di bagian mana aturan saling bertentangan di bagian mana saya melebih-lebihkan jumlah pekerjaan yang bisa diselesaikan dalam satu hari di bagian mana saya meremehkan pekerjaan (ini lebih buruk lagi) Jangan menahan diri. Kritik dengan keras. Saya ingin menemukan masalah ini sekarang, bukan saat sudah di produksi. Di akhir, berikan daftar perubahan spesifik: apa yang harus diubah dan bagaimana agar masalah ini tidak terjadi. ```
## CLAUDE.md vs AGENTS.md vs MEMORY.md: siapa membaca apa pada 2026?
Poin utama Tiga file serupa sering tertukar. CLAUDE.md berisi aturan proyek yang Anda tulis sendiri dan dibaca Claude Code di setiap sesi. AGENTS.md adalah standar universal untuk agen lain (Codex, Cursor, Copilot), dan sejak September 2026 Claude Code juga membacanya jika proyek tidak memiliki CLAUDE.md. MEMORY.md berisi catatan otomatis yang ditulis Claude untuk dirinya sendiri tentang kebiasaan Anda. Ketiganya dapat ada bersamaan tanpa konflik.
| File | Siapa yang menulisnya | Siapa yang membacanya | Kapan dimuat | |----|----|----|----| | **CLAUDE.md** | Anda, secara manual | Claude Code (secara native) | Pada awal setiap sesi | | **AGENTS.md** | Anda, secara manual | Codex CLI, Cursor, GitHub Copilot CLI, Gemini CLI, dan, sejak versi 2.1.277, Claude Code jika proyek tidak memiliki CLAUDE.md | Pada awal setiap sesi | | **MEMORY.md** | Claude Code sendiri | Claude Code (secara native) | Pada awal setiap sesi, 200 baris pertama (atau 25 KB, mana yang lebih kecil) | Pertanyaan utama yang membingungkan pengguna baru adalah: **apakah Claude Code membaca `AGENTS.md`?** Sebelum September 2026, jawabannya “tidak”: dokumentasi Anthropic menyarankan untuk membuat CLAUDE.md yang mengimpor AGENTS.md. Sejak versi 2.1.277 (dirilis 18 September 2026), Claude Code membaca AGENTS.md sendiri, tetapi hanya jika tidak ada CLAUDE.md, `.claude/CLAUDE.md`, atau `CLAUDE.local.md` di folder kerja atau folder induknya.

Claude Code dapat membaca AGENTS.md sebagai instruksi proyek, sehingga repositori yang sudah dikonfigurasi untuk agen lain dapat berfungsi tanpa CLAUDE.md, impor, atau konfigurasi.

— Anthropic, https://code.claude.com/docs/en/memory#agents-md
Jika proyek memiliki CLAUDE.md, secara default Claude Code hanya membacanya dan melewatkan AGENTS.md. Anda dapat mengubahnya di `/config`, pada bagian Project instructions: misalnya, pengaturan `claude-md-and-agents-md` akan membuatnya membaca kedua file. Cara lain yang berfungsi di versi mana pun adalah menambahkan impor ke CLAUDE.md: ```markdown @AGENTS.md ## Claude Code Aturan tambahan khusus Claude Code yang tidak diperlukan agen lain. ``` Sintaks `@filename` mengimpor file lain. Claude membacanya dan memuatnya ke dalam konteks bersama CLAUDE.md. Impor tersebut tidak membuat file dibaca dua kali, meskipun Claude Code dapat membaca AGENTS.md sendiri. **Kapan memerlukan AGENTS.md.** Jika Anda bekerja bersama Claude Code dan Codex CLI, Cursor, atau Copilot, buat AGENTS.md sebagai satu sumber kebenaran, masukkan `@AGENTS.md` ke dalam CLAUDE.md, lalu tambahkan aturan khusus Claude di atasnya. Jika tidak ada aturan seperti itu, Anda tidak perlu membuat CLAUDE.md: sejak versi 2.1.277, Claude Code akan membaca AGENTS.md sendiri. Jika hanya menggunakan Claude Code, Anda tidak memerlukan AGENTS.md; cukup gunakan satu CLAUDE.md. Untuk semua pilihan dan langkah-langkahnya, lihat [panduan penggunaan AGENTS.md dan CLAUDE.md dalam satu proyek](https://ailoot.ai/blog/id/agents-md-claude-md-one-instruction-file/). **Apa itu MEMORY.md?** Sejak pembaruan terbaru, Claude Code secara otomatis menyimpan catatan tentang Anda di `~/.claude/projects//memory/MEMORY.md`. Catatan ini mencakup kebiasaan dalam percakapan (“pengguna lebih suka jawaban singkat”), frasa yang berulang (“melarang emoji dalam kode”), dan pengamatan perilaku (“bekerja di macOS, menggunakan zsh”). Ini adalah sistem memori terpisah, bukan CLAUDE.md. Anda tidak menulisnya secara manual; Claude yang menulisnya berdasarkan percakapan Anda. Jika MEMORY.md berisi sesuatu yang seharusnya menjadi aturan, pindahkan ke CLAUDE.md. Jika isinya tidak perlu atau tidak benar, Anda dapat menghapusnya secara manual; file ini berupa teks.
Catatan Untuk melihat apa yang dimuat pada awal sesi, ketik `/memory` di Claude Code. Perintah ini menampilkan isi CLAUDE.md, MEMORY.md, dan file lain yang dimuat. Ini berguna ketika perilaku Claude terasa aneh: buka `/memory` dan cari aturan yang mungkin menyebabkannya.
## Berapa ukuran CLAUDE.md yang berguna, dan bagaimana meninjau file panjang?
Poin utama File instruksi yang lebih panjang memakai lebih banyak konteks dan dapat membuat aturan yang relevan lebih sulit diikuti, terutama jika mengandung pengulangan atau pertentangan. Anthropic menyarankan untuk mengusahakan kurang dari 200 baris. Rekomendasi itu bukan batas teknis atau prediksi universal tentang berapa aturan yang akan diikuti agen.
Di setiap jendela Claude Code, beberapa lapisan dimuat ke dalam konteks: prompt sistem Anthropic (diperkirakan puluhan ribu token), CLAUDE.md Anda, file yang diimpor dengan `@`, MEMORY.md, riwayat obrolan saat ini, dan isi file yang dibuka Claude. Semua ini harus muat dalam konteks model (200K token untuk Sonnet, 1M untuk Opus). Semakin besar CLAUDE.md, semakin sedikit ruang yang tersisa untuk pekerjaan saat ini. File 1,000 baris berisi sekitar 8,000 token dan diulang di setiap sesi. Dengan langganan Pro (berdasarkan pengalaman saya, sekitar 10-12 prompt “berat” sehari), kapasitas Anda berkurang seperempat. Biaya hanyalah salah satu pertimbangan. Kepatuhan dapat menurun ketika instruksi panjang, tidak relevan, atau saling bertentangan; tidak ada jumlah universal instruksi yang pasti diikuti dengan andal. Uji beberapa tugas yang mewakili pekerjaan dan menggunakan aturan kritis, catat kegagalan, lalu bandingkan perilaku setelah edit yang terarah.
File CLAUDE.md yang terlalu gemuk membuat Claude mengabaikan instruksi Anda yang sebenarnya.
— Anthropic, code.claude.com/docs/en/best-practices
Berikut patokan ukuran: - **80-120 baris** - rentang awal yang praktis untuk peta proyek ringkas, bukan jaminan nilai kepatuhan. - **150-200 baris** - pengingat yang berguna untuk meninjau relevansi dan memindahkan prosedur terperinci ke file tertaut. - **200-300 baris** - periksa volume token, pengulangan, dan hasil tugas; contoh bisnis 280 baris di atas mungkin tetap bekerja dengan baik. - **400+ baris** - alasan kuat untuk peninjauan terarah, bukan bukti bahwa file tidak dapat digunakan. Pertahankan batasan utama dan pindahkan detail hanya setelah memastikan tautan dan aturan tetap berfungsi. Jumlah baris saja tidak membuktikan keberhasilan atau kegagalan. Setelah mengedit, ulangi tugas representatif yang sama dan verifikasi aturan penting, alih-alih memberi persentase kepatuhan rekaan.
Peringatan Jika CLAUDE.md Anda sudah terlalu besar, jangan refaktor secara manual. Berikan prompt ini kepada Claude: “Baca CLAUDE.md dan nilai setiap baris dengan pertanyaan, ‘Jika baris ini dihapus, apakah agen akan membuat kesalahan?’ Berikan daftar baris yang dapat dihapus tanpa kerugian, beserta alasannya.” Claude akan menghapus hal-hal yang secara objektif tidak berfungsi.
Anthropic memberikan tes langsung dalam dokumentasinya:
Untuk setiap baris, tanyakan: ‘Jika saya menghapus ini, apakah Claude akan mulai membuat kesalahan?’ Jika tidak, hapus.
— Anthropic, code.claude.com/docs/en/best-practices
Terapkan pertanyaan ini pada setiap baris. Jika jawabannya “ia tetap akan melakukannya dengan benar,” hapus baris tersebut. CLAUDE.md bukan tempat untuk dokumentasi, riwayat keputusan, atau filosofi. Isinya hanya aturan yang diperlukan agen agar tidak membuat kesalahan. ## 7 kesalahan apa yang membuat CLAUDE.md tidak berguna?
Poin utama Ini tujuh kesalahan umum yang sering saya lihat dalam CLAUDE.md orang lain. Masing-masing menjadi alasan untuk merapikan file secara sistematis. Sebagian besar merupakan variasi dari satu masalah: mencoba menjadikan CLAUDE.md sebagai “dokumen proyek” universal, alih-alih alat kerja untuk agen.
### Kesalahan 1. “Jadilah insinyur yang baik” Kesalahan paling umum. Orang menulis harapan umum di CLAUDE.md: “tulis kode yang rapi,” “gunakan praktik terbaik,” “berpikirlah seperti insinyur senior.” Kata-kata ini tidak berarti apa-apa. Secara umum, Claude sudah menulis “kode yang rapi.” Baris-baris ini menghabiskan konteks tanpa memengaruhi keputusan apa pun. Ganti “tulis kode yang rapi” dengan “gunakan indentasi 2 spasi,” “jangan gunakan `any` di TypeScript,” atau “fungsi harus tidak lebih dari 30 baris.” Spesifik dan dapat diverifikasi. ### Kesalahan 2. Menggandakan hal yang sudah diketahui Claude Deskripsi konvensi bahasa standar (“dalam JavaScript, fungsi adalah first-class citizen,” “TypeScript memiliki pengetikan statis”). Penjelasan tentang cara kerja npm, git, atau docker. Claude mempelajari semua ini selama pelatihan. Menggandakannya di CLAUDE.md tidak menambah apa-apa; hanya mengurangi ruang konteks Anda. ### Kesalahan 3. Instruksi panjang langkah demi langkah di dalam CLAUDE.md Instruksi panjang tentang “cara men-deploy proyek,” “cara menulis migrasi basis data,” atau “cara menyiapkan komponen baru.” Puluhan baris langkah demi langkah. Ini bukan tempat untuk instruksi langkah demi langkah yang panjang. Gunakan satu baris aturan. Letakkan instruksi panjang di `skills/` (mekanisme Claude Code terpisah yang dimuat sesuai kebutuhan) atau di `docs/`. Di CLAUDE.md, gunakan tautan satu baris: “Saat membuat migrasi baru, buka `docs/migrations.md`.” ### Kesalahan 4. Aturan yang sudah diperiksa oleh penganalisis kode otomatis “Gunakan titik koma,” “jangan biarkan impor yang tidak terpakai,” “jangan gunakan `var`.” ESLint, Prettier, dan Biome dapat mendeteksi semua ini - semuanya adalah linter (alat pemeriksa kode otomatis). Linter bersifat deterministik: linter dijalankan, menemukan kesalahan, lalu memperbaikinya. Aturan CLAUDE.md bersifat probabilistik; agen mungkin lupa. Tidak perlu menggandakannya - lebih mudah mengonfigurasi linter. ### Kesalahan 5. Rahasia di CLAUDE.md Saya pernah melihat kata sandi akun uji, token API sandbox, dan tautan ke panel admin terautentikasi. Semuanya berada di file yang di-commit ke git dan dimuat ke konteks model Anthropic. Jangan pernah. Rahasia harus disimpan di `.env`, yang tercantum dalam `.gitignore`. Paling jauh, CLAUDE.md cukup menyatakan: “Jangan membaca seluruh isi `.env`; gunakan `grep` untuk variabel tertentu.” ### Kesalahan 6. File penampung lebih dari 500 baris yang tidak dibersihkan selama enam bulan CLAUDE.md membesar, menggandakan separuh isi `docs/`, bertentangan dengan dirinya sendiri di beberapa bagian, dan tidak ada yang ingat isinya. Agen mulai mengabaikan sebagian besar aturan. Tim mengeluh bahwa “Claude tidak mengikuti instruksi” lalu menambahkan lebih banyak aturan sehingga masalahnya makin parah. Tanda-tanda CLAUDE.md yang terbengkalai: lebih dari 300 baris, aturan yang sama diulang di bagian berbeda, tautan usang ke file yang sudah tidak ada, serta catatan “historis” seperti “pada 2024 kami memutuskan melakukan ini, lalu berubah pikiran.” Solusinya: setiap dua minggu, minta Claude meninjaunya menggunakan tes Anthropic, “Jika baris ini dihapus, apakah agen akan membuat kesalahan?” Hapus semua yang jawabannya “tidak.” ### Kesalahan 7. CLAUDE.md dibuat lalu dilupakan Ini kebalikan dari kesalahan sebelumnya. File disusun sekali, dua bulan yang lalu, lalu tidak pernah disentuh lagi. Sementara itu, alat berubah, folder baru ditambahkan, dan kesalahan agen baru muncul. CLAUDE.md tidak mengetahui semua ini karena tidak ada yang memperbaruinya. Tanda yang jelas: Anda mengulang instruksi yang sama di setiap sesi. “Jangan lakukan X,” “jangan sentuh Y,” “ingat Z.” Jika Anda sudah mengulanginya lebih dari dua kali, aturan itu seharusnya ada di CLAUDE.md, bukan hanya di kepala Anda.
[Panduan Ailoot](https://ailoot.ai/docs/)
## Bagaimana membuat CLAUDE.md belajar sendiri dengan aturan “perbarui di akhir sesi”?
Poin utama Teknik utama yang mengubah CLAUDE.md saya dari dokumen menjadi alat hidup adalah menambahkan satu aturan ke file tersebut: “Di akhir setiap sesi, periksa apakah Anda telah mempelajari sesuatu yang baru tentang pengguna atau cara bekerja dengannya yang belum ada di CLAUDE.md, lalu tambahkan satu baris.” Dalam dua bulan, file itu mulai menghimpun aturan khusus tanpa proses terpisah.
CLAUDE.md saya memiliki bagian singkat: ```markdown ## Self-learning At the end of every session, check: - Have I learned anything new about the user or how to work with them? - Did I break any rule that should now be recorded? If so, create or update a file in `about-me/feedback/` in this format: Rule (one-line rule) → Why (why it was added) → How to apply (when it applies). I don’t write the rules by hand - I say, “not like that, because this is how,” and you put it into a file. ``` Setelah bagian ini ditambahkan ke CLAUDE.md, Claude mulai bertanya di akhir setiap sesi: “Apakah ada hal baru yang perlu dicatat?” Jika ada, Claude menyarankan draf aturan, saya memperjelasnya, lalu sebuah file dibuat. Setelah dua bulan bekerja dengan cara ini, saya memiliki lebih dari dua lusin file di `about-me/feedback/` - aturan yang dipelajari dari kesalahan tertentu. Setiap file adalah satu halaman dalam format Aturan → Alasan → Cara. Folder ini menjadi “memori kedua” yang mencatat preferensi dan pantangan pribadi saya. Kesalahan tidak terulang karena berubah menjadi aturan, dan aturan terus terkumpul serta saling menguatkan. Setelah enam bulan, Claude mengenal proyek saya lebih baik daripada yang saya ingat setelah jeda sebulan. ## Bagaimana menambahkan aturan hukum, pemasaran, dan operasional ke CLAUDE.md?
Poin utama Panduan teknis di CLAUDE.md baru separuh gambaran. Separuh lainnya adalah aturan bisnis: pilihan kata terlarang untuk persyaratan hukum, format naskah eksternal untuk merek, dan kebiasaan operasional tentang cara tim bekerja dari minggu ke minggu. Jika CLAUDE.md mencakup kedua sisi, Claude bukan hanya menjadi pemrogram, tetapi juga editor dan asisten operasional.
Bagi sebagian besar tim, CLAUDE.md adalah dokumen yang sepenuhnya teknis: alat, perintah build, konvensi kode. Ini berguna, tetapi hanya sepertiga dari nilainya. Saat pengusaha mengelola CLAUDE.md, menambahkan bagian bisnis merupakan hal yang masuk akal. Tiga bagian paling penting: ### Aturan hukum (untuk pasar yang diatur) Jika Anda memublikasikan naskah di industri yang diatur (keuangan, medis, iklan obat, produk anak), kata-kata terlarang memiliki konsekuensi hukum dan harus dicantumkan secara eksplisit sebagai aturan di CLAUDE.md. Jangan hanya menyimpannya di kepala seseorang atau dalam tangkapan layar editor - simpan di file yang dilihat agen di setiap sesi. Contoh untuk proyek fintech tanpa lisensi perbankan: Catatan editorial: Contoh berikut menunjukkan format aturan internal untuk proyek tertentu. Contoh ini bukan izin universal untuk menggunakan istilah yang tercantum: dapat atau tidaknya suatu pernyataan digunakan bergantung pada hukum yang berlaku dan status perusahaan. > 🚨 KRITIS - penggunaan istilah keuangan dilarang. Dalam materi untuk pelanggan, jangan gunakan: “deposito,” “imbal hasil terjamin,” atau “produk investasi.” Gunakan: “rekening tabungan,” “imbal hasil yang diharapkan,” dan “produk dengan suku bunga variabel.” Alasannya adalah persyaratan hukum yang berlaku untuk iklan layanan keuangan dalam proyek ini. Blok ini dalam CLAUDE.md melakukan hal sederhana: setiap kali Anda meminta Claude menulis naskah untuk pelanggan, agen memeriksanya berdasarkan larangan tersebut. Tanpa aturan itu, kata-kata terlarang muncul di setiap kampanye ketiga. Dengannya, Anda sampai lupa bahwa kata-kata itu pernah ada. Pendekatan yang sama berlaku untuk: - Proyek medis (tanpa klaim bahwa sesuatu “mengobati” atau “menyembuhkan”). - Iklan obat (tanpa klaim “paling efektif”; peringatan wajib). - Industri apa pun yang diatur dan memiliki aturan periklanannya sendiri. ### Gaya pemasaran dan format naskah Jika Anda rutin memublikasikan naskah (media sosial, buletin, situs web), ada baiknya mendokumentasikan formatnya dalam satu paragraf di CLAUDE.md. Berikut contoh yang mungkin ditulis influencer atau agensi yang mengelola kanal pesan: > Saat menulis postingan kanal, lihat `style/posts.md`. Gunakan penanda pemformatan yang diizinkan kanal dan hindari karakter khusus yang “berbahaya.” Akhiri dengan CTA yang memiliki tag UTM sesuai konvensi ini: `utm_source=&utm_medium=&utm_campaign=`. Dulu Claude menulis postingan dengan “gaya umum situs web pemasaran.” Kini Claude mengikuti format Anda, menggunakan UTM Anda, dan tidak memperlihatkan bahwa tulisan itu dibuat oleh AI. ### Kebiasaan operasional Tabel pemicu. Saat Anda mengucapkan frasa tertentu, agen tahu file mana yang harus dibuka dan tindakan apa yang harus dilakukan. Berikut contoh untuk tim yang membuat rencana mingguan: > “Rencanakan minggu ini” → buka `ops/monthly.md`, buat `YYYY-WNN.md` di folder yang sama, lalu pindahkan tugas dari `ops/backlog.md` ke hari-hari yang sesuai. “Apa isi backlog?” → baca `ops/backlog.md` dan tampilkan sebagai daftar. “Tutup minggu ini” → isi bagian “Ringkasan minggu” di file minggu berjalan. Dengan tabel seperti ini, Claude berubah dari “asisten yang menulis kode” menjadi “operator” yang memahami rutinitas bisnis Anda. Setiap Senin, saya berkata “mari rencanakan minggu ini,” lalu Claude membuka file yang tepat, membaca sasaran bulanan, dan menyarankan cara membaginya menjadi beberapa tugas.
Catatan Panduan khusus bisnis di CLAUDE.md masuk akal jika Anda sudah memiliki folder `business/` dengan konteks nyata tentang audiens, produk, dan sasaran. Jika belum, buat `business/` terlebih dahulu, lalu tambahkan tautan ke folder itu di CLAUDE.md. Kalau tidak, instruksi Anda akan menunjuk ke tempat yang tidak ada.
## Bagaimana memeriksa CLAUDE.md dengan daftar periksa 12 poin dalam 5 menit?
Poin utama Periksa CLAUDE.md Anda saat ini dengan daftar periksa ini. Setiap butir memerlukan 30 detik. Jika Anda menjawab “tidak” sebanyak lima kali atau lebih, file itu perlu dirapikan.
1. **Ukuran.** Apakah isinya ringkas, dengan sekitar 200 baris sebagai target peninjauan, bukan batas lulus/gagal? 2. **Nama.** Apakah namanya tepat `CLAUDE.md` dengan huruf kapital, bukan `claude.md`? 3. **Lokasi.** Apakah file berada di akar proyek atau di `./.claude/CLAUDE.md`? 4. **Deskripsi proyek.** Apakah 5 baris pertama menjelaskan dengan jelas apa proyek ini dan untuk siapa? 5. **Alat.** Apakah teknologi dicantumkan secara eksplisit dan tanpa basa-basi? 6. **Struktur.** Apakah ada diagram repositori beserta penjelasannya? 7. **Perutean.** Apakah ada tabel “pertanyaan → file” yang menunjukkan tempat menemukan jawaban? 8. **Prinsip.** Apakah ada bagian dengan aturan yang diawali “jangan pernah” dan “selalu”? 9. **Kekhususan.** Apakah setiap aturan dapat diverifikasi? (“Gunakan 2 spasi,” bukan “tulis dengan indah.”) 10. **Pembaruan mandiri.** Apakah ada aturan untuk “memeriksa hal yang perlu ditambahkan di akhir sesi”? 11. **Refleksi.** Apakah ada aturan untuk “mencatat ringkasan sesi di `retrospectives/`”? 12. **Keamanan.** Apakah larangan kritis (`.env`, `rm -rf`) juga dicantumkan di `.claude/settings.json`? Jika jawaban “tidak” lebih dari lima, buka Claude dan berikan prompt ini:
Prompt: Audit CLAUDE.md berdasarkan daftar periksa ``` Baca CLAUDE.md saya dan bandingkan dengan daftar periksa di bawah. Untuk setiap butir, jawab: ya / tidak / sebagian, dan jelaskan apa yang harus diperbaiki. Daftar periksa: Cukup ringkas untuk tugasnya; tinjau sekitar 200 baris tanpa menganggapnya sebagai batas keras Deskripsi proyek ada di 5 baris pertama Alat dicantumkan secara eksplisit Diagram struktur repositori disertakan Tabel “Pertanyaan → file” disertakan Bagian prinsip berisi aturan Setiap aturan spesifik dan dapat diverifikasi Aturan “perbarui di akhir sesi” disertakan Aturan “refleksi di akhir sesi” disertakan Larangan kritis disertakan di .claude/settings.json Tidak ada aturan yang sama diulang di bagian berbeda Tidak ada tautan mati ke file yang sudah tidak ada Setelah audit, berikan daftar perubahan spesifik yang akan membuat file ini terus hidup. ```
## Apa yang sebaiknya digunakan setelah CLAUDE.md: Plan Mode, Skills, atau sub-agents?
Poin utama CLAUDE.md adalah fondasinya. Setelah berfungsi, Anda dapat menggunakan tingkat berikutnya: Plan Mode (minta Claude membuat rencana terlebih dahulu, lalu bertindak), Skills (pindahkan pengetahuan yang jarang digunakan dari CLAUDE.md ke file terpisah), dan sub-agents (tugas terisolasi dalam konteksnya sendiri).
CLAUDE.md adalah fondasinya. Setelah berfungsi, Anda dapat menambahkan tiga mekanisme Claude Code yang saling memperkuat. **Plan Mode.** Mode ketika Claude terlebih dahulu membuat rencana perubahan, menunggu persetujuan Anda, lalu mulai bekerja. Aktifkan dengan Shift+Tab atau perintah `/plan`. Mode ini mengatasi masalah utama vibe coding: “Saya meminta Claude memperbaiki satu hal, tetapi ia malah menulis ulang separuh proyek.” Itu tidak akan terjadi dalam Plan Mode - Anda melihat rencananya sebelum agen menyentuh file apa pun. **Skills.** File `.md` terpisah di folder `.claude/skills/` yang berisi pengetahuan untuk jenis tugas tertentu. Misalnya, skill “cara menulis migrasi basis data” berisi prosedur spesifik, template, dan contoh. Pengetahuan itu tidak dimasukkan ke CLAUDE.md karena terlalu panjang. Namun, ketika Claude menghadapi tugas seperti “tulis migrasi,” Claude memuat skill yang relevan dan mengikutinya. **Sub-agents.** Jika sebuah tugas membutuhkan banyak konteks (misalnya, meninjau fitur besar), Claude dapat memulai sub-agent terpisah dengan konteks bersihnya sendiri. Sub-agent mengerjakan tugas dan mengembalikan hasil tanpa memenuhi konteks obrolan utama Anda. Ketiga mekanisme tersebut menggunakan CLAUDE.md sebagai titik masuk: semuanya membacanya pada awal pekerjaan untuk memahami konteks proyek. Itulah sebabnya fitur-fitur ini juga tidak berfungsi dengan baik tanpa CLAUDE.md yang terus diperbarui. Mulai dari fondasi, lalu tambahkan lapisannya. **Langkah berikutnya.** Buat file `CLAUDE.md` di akar proyek, salin template dari awal artikel ini, lalu isi bagian dalam tanda kurung siku menggunakan prompt bantuan. Selanjutnya, gunakan file itu: ubah setiap kesalahan agen menjadi satu baris baru. Setelah dua atau tiga minggu, CLAUDE.md tidak lagi menjadi “dokumen yang dibuat lalu dilupakan,” melainkan sesuatu yang benar-benar dibaca Claude di setiap sesi. Jika Anda ingin membangun kerangka lengkap di sekitar `CLAUDE.md` - folder `business/` untuk Second Brain, folder `about-me/` untuk proyeksi digital diri Anda, basic skills, dan Plan Mode yang dikonfigurasi - gunakan langkah-langkah dan contoh dalam artikel ini. [Panduan Ailoot](https://ailoot.ai/docs/).
### Sumber - [Anthropic - Memori Claude Code](https://code.claude.com/docs/en/memory) - dokumentasi resmi tentang CLAUDE.md, MEMORY.md, dan hierarki pemuatan - [Anthropic - Praktik Terbaik](https://code.claude.com/docs/en/best-practices) - aturan untuk menulis CLAUDE.md yang efektif dan tes “apakah menghapus ini akan menyebabkan Claude membuat kesalahan?” - [Dukungan Anthropic - Beri Claude Konteks](https://support.claude.com/en/articles/14553240-give-claude-context-claude-md-and-better-prompts) - panduan dukungan untuk bekerja dengan konteks - [Panduan Ailoot](https://ailoot.ai/docs/) - dokumentasi.
[Lanjutkan membaca panduan Ailoot](https://ailoot.ai/).
[Lanjutkan membaca panduan Ailoot](https://ailoot.ai/)
[Lanjutkan membaca panduan Ailoot](https://ailoot.ai/)
## Pertanyaan tentang Cara Menyiapkan CLAUDE.md pada 2026: Template dan 6 Aturan ### Apakah file CLAUDE.md menjadi tidak valid setelah 200 baris? Tidak. Rekomendasi itu adalah target keringkasan, bukan batas penguraian atau titik kegagalan yang dijamin. Tinjau pengulangan, pertentangan, dan konteks yang dimuat, lalu uji aturan penting pada tugas yang mewakili pekerjaan Anda. Contoh 280 baris dalam artikel memerlukan evaluasi yang sama. ### Apa yang sebaiknya dipindahkan dari CLAUDE.md yang terus bertambah? Pindahkan prosedur terperinci, bahan referensi panjang, dan riwayat keputusan ke dokumen atau skill yang relevan. Pertahankan fakta proyek yang ringkas, batasan utama, dan tautan yang jelas dalam file masuk. Ulangi tugas nyata setelah mengedit untuk memastikan perutean dan aturan kritis tetap berfungsi. ## Ailoot · Perusahaan dan portofolio proyeknya Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan. Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan. Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.