CLAUDE.md adalah satu file yang membentuk cara Claude memahami proyek Anda. Yang ditulis dengan baik berarti lebih sedikit koreksi, kode yang lebih baik, dan agen yang benar-benar tahu apa yang mereka kerjakan.
Panduan ini memandu Anda melalui setiap bagian file CLAUDE.md, dari deklarasi tech stack hingga petunjuk khusus agen. Ikuti dan bangun milik Anda langkah demi langkah.
CLAUDE.md adalah file markdown yang Anda tempatkan di root proyek Anda. Ketika Claude Code memulai sesi, ia membaca file ini terlebih dahulu. Semua yang ada di dalamnya menjadi bagian dari konteks Claude: tech stack Anda, struktur file Anda, konvensi tim Anda, dan instruksi spesifik yang Anda inginkan agar diikuti setiap agen.
Anggap ini sebagai dokumen briefing. Tanpanya, Claude harus menebak bagaimana proyek Anda diorganisir. Dengan yang baik, Claude sudah tahu di mana hal-hal berada, pola mana yang diikuti, dan apa yang harus dihindari. Perbedaan kualitas output cukup signifikan.
“Investasi 10 menit di CLAUDE.md menghemat jam-jam untuk mengoreksi kode yang dihasilkan AI yang tidak cocok dengan pola proyek Anda.”
Diamati di ratusan proyek Claude Code
Struktur dan kekhususan CLAUDE.md Anda secara langsung memengaruhi seberapa baik Claude bekerja di codebase Anda.
CLAUDE.md yang terstruktur dengan baik mencakup enam area ini. Setiap satu memberi Claude informasi konkret yang dapat langsung ditindaklanjuti.
Daftarkan framework, library, dan versinya secara eksplisit. Sertakan package manager, versi Node, dan persyaratan runtime apa pun. Claude menggunakan ini untuk menghasilkan kode yang kompatibel tanpa menebak.
Deskripsikan direktori kunci dan apa yang ada di masing-masing. Komponen, store, service, rute API, tipe. Diagram tree singkat dengan deskripsi satu baris per folder bekerja dengan baik.
Dokumentasikan pola penamaan (camelCase untuk file, PascalCase untuk komponen), pendekatan penanganan error, urutan impor, dan aturan khusus proyek apa pun. Ini menjaga output Claude konsisten dengan kode yang sudah ada.
Sertakan perintah dev, build, test, dan lint Anda. Saat Claude perlu memverifikasi sesuatu berfungsi atau menyarankan skrip, ia akan menggunakan perintah yang tepat yang diharapkan proyek Anda.
Jika Anda menggunakan beberapa agen (QA, frontend, backend, DevOps), tambahkan bagian yang mendeskripsikan apa yang harus difokuskan setiap peran. Ini sangat berguna dengan pengaturan multi-agen AgentsRoom.
Beri tahu Claude apa yang TIDAK harus dilakukan. Jangan modifikasi file konfigurasi, jangan ubah sistem auth, jangan refaktor lapisan database. Batasan eksplisit mencegah agen melakukan perubahan yang tidak diinginkan.
Anda tidak perlu menulis segalanya sekaligus. Mulai dengan dasar-dasar dan perluas seiring Anda menemukan apa yang perlu diketahui Claude.
Buka package.json dan daftarkan setiap framework, library, dan alat yang digunakan proyek Anda. Catat versinya. Periksa persyaratan runtime (versi Node, versi Python, database). Ini menjadi bagian tech stack Anda.
package.json + versi runtime + database
Jalankan tree cepat dari direktori src Anda. Identifikasi folder level atas dan tulis deskripsi satu baris untuk masing-masing. Fokus pada lokasi komponen, store, service, tipe, dan rute API.
Pohon src/ dengan anotasi tujuan
Lihat kode yang sudah ada dan catat polanya: cara Anda menamai file, cara menangani error, cara menstrukturkan impor, apakah Anda menggunakan default atau named export. Tuliskan sebagai aturan singkat.
Penamaan, impor, penanganan error, export
Jika Anda bekerja dengan agen spesialis, tambahkan area fokus untuk setiap peran. Agen frontend harus mengetahui library komponen Anda. Agen DevOps harus mengetahui pipeline deployment Anda. Agen QA harus mengetahui framework pengujian Anda.
Area fokus per peran + area yang harus dihindari
AgentsRoom dibangun di sekitar CLAUDE.md sebagai konsep kelas satu, bukan renungan belakangan.
Edit CLAUDE.md Anda langsung di dalam AgentsRoom dengan penyorotan sintaksis dan penyimpanan langsung. Tidak perlu beralih ke editor teks atau IDE.
Lihat bagaimana setiap agen menginterpretasikan CLAUDE.md Anda secara real-time. Perhatikan output terminal untuk memverifikasi bahwa agen mengikuti konvensi dan menghormati area yang harus dihindari.
Setiap proyek di AgentsRoom memiliki CLAUDE.md sendiri. Beralih antara proyek dan setiap agen secara otomatis memuat file konteks yang tepat untuk codebase tersebut.
14 peran agen AgentsRoom dipasangkan langsung dengan bagian-bagian CLAUDE.md. Definisikan area fokus dan area yang harus dihindari per peran, dan setiap agen mengambil instruksi yang dimaksudkan untuknya.
Unduh AgentsRoom dan gunakan editor CLAUDE.md bawaan untuk memberi agen konteks yang mereka butuhkan. Instruksi yang lebih baik, kode yang lebih baik.
Aplikasi pendamping: pantau agen Anda saat bepergian
Kompatibel dengan Claude, Codex, OpenCode, Gemini CLI, dan Aider
Kirim bug dan permintaan langsung ke backlog publik Anda.