Judul asli: Karpathy 's CLAUDEMd hit # 1 di GitHub dengan 82.000 bintang.

Foto oleh Dep

Editor menekan: Ketika banyak orang menggunakan Claude Code, masalah terbesar adalah tidak model yang cukup kuat, tetapi mereka mulai dari awal setiap kali。

Anda perlu menceritakannya berulang kali tentang latar belakang proyek, lemari besi teknologi, spesifikasi kode, di mana ia tidak dapat bergerak dan program yang telah dicoba. Selama informasi ini tidak tetap, Claude bergantung pada tebakan, yang mungkin menghasilkan perubahan dokumen yang tidak dapat diperbaiki, kode rekonstruksi yang tidak memerlukan reengineering dan bahkan merekomendasikan alat yang tidak cocok untuk proyek saat ini。

CLUDEMD, yang disajikan di sini, adalah manual untuk Claude Code. Yang harus Anda lakukan adalah memasukkannya ke dalam direktori root, dan Claude secara otomatis membacanya setiap kali itu dimulai. Ini dapat memberitahu Claude terlebih dahulu bagaimana menjawab, bagaimana menulis kode, ketika bertanya pertama, apa operasi tidak dapat dijalankan tanpa izin, apa teknologi yang digunakan dalam proyek dan apa keputusan penting yang telah dibuat di masa lalu。

Singkatnya, peran CLAUDE.md adalah untuk mengurangi interpretasi berulang, membatasi model di perbatasan dan membuat pemrograman AI lebih stabil dan dikelola。

Jika Anda menggunakan Claude Code, Anda dapat mulai dengan 4 aturan yang dirangkum oleh Karpathy: tanyakan pertama, buat solusi paling sederhana, jangan sentuh kode yang tidak relevan, tentukan ketidakpastian. Penambahan item-item ini di CLAUDEMD dan penambahan bertahap mereka pada proyek mereka sendiri secara signifikan akan meningkatkan pengalaman penggunaan mereka。

Berikut adalah teks asli:

Sebuah dokumen bernama CLAUDEMD berada di atas GitHub Trending。

8,2 juta bintang, 7,800 garpu。

Dimulai dari Andrej Karpathy. Dia adalah direktur Tesla AI dan salah satu pendiri anggota OpenAI. Dia menyimpulkan empat jenis perilaku yang akan membatalkan Claude Code dan menempatkan mereka dalam dokumen。

Kemudian, pengembang terus memperluas empat aturan dan merilis dokumen secara terbuka. Ternyata warnanya merah。

Alasannya adalah langsung: tingkat akurasi kode telah meningkat dari 65% menjadi 94%。

Tapi kebanyakan pengembang yang menggunakan Claude Code setiap hari belum pernah benar-benar melakukan hal ini. Masing-masing sesi mereka dimulai dari awal: konteks yang sama dijelaskan kembali, perubahan lingkup yang tidak perlu dibersihkan, dan tayangan ulang rekonstruksi tak terduga digulung kembali。

Dokumen lengkap berikut。

Pengaturan tidak terjawab oleh kebanyakan pengembang

Setiap kali Anda membuka Claude Code, itu default pada mengetahui apa-apa。

Ia tidak tahu teknologi Anda, ia tidak tahu kode kode Anda, ia tidak tahu latar belakang proyek Anda, ia tidak tahu apa yang telah Anda coba, dan ia tidak tahu apa yang Anda putuskan untuk tidak lakukan sebelum tiga sesi。

Jadi hanya bisa menebak. Dan setelah itu mulai menebak, mungkin menciptakan ulang kode yang tidak Anda minta untuk bergerak, dan rekomendasi akan melemahkan kerangka arsitektur yang ada, menghapus dokumen tanpa konfirmasi, atau bahkan membalikkan keputusan yang telah diambil sebelumnya。

CLUDE.md adalah berkas teks yang ditempatkan di bawah direktori root. Claude Code secara otomatis membacanya di awal setiap sesi。

Pengaturan satu kali tidak perlu dijelaskan berulang kali dan dapat memperbaiki tiga jenis kesalahan mahal。

Pengaturan Baku: Anda menghabiskan $375 per minggu, hanya mengulangi sendiri

Pengembang biasa memerlukan sekitar 30 menit sehari untuk menafsirkan kembali konteks ke Claude。

Brankas teknologi, kode kode, latar belakang proyek, metode yang telah Anda coba -- kecuali jika Anda menulis informasi ini sekali dan membuat Claude membacanya secara otomatis, mereka tidak terus antara sesi。

Jika dihitung pada pengembang 's gaji per jam dari $150:

30 menit per hari, 75 dolar

$375 per minggu。

Jika itu adalah tim dari lima, itu akan menjadi $1875 per minggu。

Aturan berikut 7 harus ditempatkan di atas dokumen CLAUDEMD。

Oh, persetan

Jawabannya adalah jangan mulai dengan "pertanyaan bagus" atau "tidak ada masalah" atau semacam kasur. Berikan saja jawabannya. Jangan tenang, jangan ulangi pertanyaannya。

Panjang respon sesuai dengan tugas

Panjang respon harus sesuai dengan kompleksitas tugas. Pertanyaan sederhana dijawab secara langsung, secara singkat; mandat kompleks memberikan gambaran lengkap dan rinci. Jangan mengisi ruang dengan pengulangan pertanyaan atau pengulangan kesimpulan。

Prior untuk bertindak

Sebelum memulai tugas penting, beri aku 2-3 jalur yang layak, dan kemudian lanjutkan sampai aku memilih。

{\ a6\ fs17\ fnCentury Gothic} ♪ ♪ Sebelum ketidakpastian menyebabkan kerugian, akui ketidakpastian

Jika Anda tidak yakin tentang fakta, data, tanggal atau informasi teknis, silakan spesifikasikan sebelum mengutip. Jangan isi kesenjangan pengetahuan dengan informasi yang tampaknya masuk akal. Bila Anda tidak bisa, hanya mengatakan Anda tidak yakin。

Siapa aku? Apa yang kutahu

Bagi saya: [nama] / Peran: [peran Anda] / Latar Belakang: [daerah]。

Aku pandai dalam hal ini:。

Saya masih belajar。

Harap menyesuaikan kedalaman setiap respon untuk informasi ini. Jangan terlalu menjelaskan apa yang sudah kuketahui, dan jangan lewatkan latar belakang yang kubutuhkan。

Konteks Projek Saat ini

Saya sedang melakukan: [Nama projek] / Objective: [Hasil khusus] / Penonton: [yang akan menggunakan] latar belakang gudang teknis: [kendala relevan] / Perlu menghindari: [daftar]。

Harap menerapkan konteks ini untuk setiap tugas. Jika sebuah persyaratan tidak cocok dengan konteks, silakan indikasikan sebelum implementasi。

♪ Lock your expression ♪

Gaya menulis saya adalah: [Deskripsi ekspresi Anda]。

Panjang kalimat: [preferensi]。

Aku menggunakan kata-kata: [Contoh]。

Saya tidak akan pernah menggunakan kata-kata: [Contoh]。

Format: [Spoken atau terstruktur]。

Ketika Anda menulis sesuatu atas nama saya, Anda harus benar-benar cocok dengan gaya itu dan tidak menggunakan ekspresi Anda sendiri secara default。

Waktu untuk mengulangi konteks: 30 menit

Berdasarkan gaji pengembang per jam dari $150: $75 / hari

Weekly: $375 per pengembang

5 orang tim: $1875 per minggu

Pengaturan CLUDEMD: total 45 menit

Galat perlu dihindari: Jangan tulis CLAUDEMD dari awal. Gunakan program ini dulu, kemudian sunting keluaran:

Berdasarkan apa yang saya katakan tentang diri saya, proyek saya, dan bagaimana saya ingin bekerja, silakan menulis saya CLUDEM lengkap. Ini termasuk siapa saya, latar belakang teknis saya, preferensi komunikasi saya, dan perilaku baku bahwa setiap sesi harus mengikuti. Khusus, teks polos, 500 kata diperlukan。

Penahan perilaku: perubahan yang Anda tidak otorisasi, $150 per jam

Anda membiarkan Claude memperbaiki fungsi。

akibatnya, tiga dokumen dibuat ulang, diganti nama variabel, laporan terorganisir ulang, dan menulis ulang catatan yang anda tulis。

Dan semua ini tidak dikonfirmasi olehmu。

Mungkin butuh satu jam, atau $150, untuk meninjau dan memutar kembali perubahan yang tidak perlu. Tiga kali seminggu, itu $450. Untuk tim dari lima, itu $2250 seminggu untuk membersihkan perubahan tidak sah。

Aturan berikut 7 harus dimasukkan dalam bagian pengikatan dari tindakan CLAUDEM。

Kontrol ketat

Hanya perubahan berkas, fungsi, dan baris kode yang berhubungan langsung dengan tugas saat ini. Jangan membuat ulang, mengubah nama, mengatur ulang, atau "optimisasi" apapun yang saya secara eksplisit tidak meminta Anda untuk berubah。

Jika kau menemukan tempat lain yang layak diperbaiki, gunakan catatan terakhir. Jangan pernah bergerak。

Tanyakan sebelum membuat perubahan besar

Sebelum membuat perubahan besar untuk apa yang telah saya buat, termasuk menulis ulang bab, menghapus paragraf, struktur restrukturisasi, mengubah nada, dll., penting untuk berhenti dan menyatakan apa yang ingin Anda ubah dan mengapa. Aku akan melanjutkan sampai aku yakin。

- Setiap operasi destruktif harus dikonfirmasi sebelum

Sebelum dokumen dihapus, kode yang ada tercakup, catatan basis data dihapus, atau ketergantungan dihapus, perlu untuk berhenti, untuk menuliskan apa yang secara khusus mempengaruhi dan meminta saya untuk konfirmasi yang jelas. Anda dapat melanjutkan hanya jika saya mengatakan ya dalam berita saat ini。

"Anda sebutkan sebelumnya" bukanlah konfirmasi。

Operasi lingkungan produksi harus dihentikan

Berikut ini harus jelas dikonfirmasi dalam sesi saat ini, tanpa pengecualian:

:: penyebaran atau transfer ke setiap lingkungan

Migrasi operasional atau perubahan dalam struktur basis data

KIRIM PANGGILAN API EKSTERNAL

Lakukan semua perintah dengan efek samping yang tidak dapat diubah。

Aku harus mengatakan "ya" jelas dalam berita saat ini。

Always showing what changed

Setelah menyelesaikan tugas pengkodean apapun, akhir harus termasuk:

Dokumen dimodifikasi: Daftar semua dokumen dipindahkan

Revisi: Setiap dokumen digambarkan dalam satu kalimat

Dokumen sengaja tidak diubah

Mengikutinya。

{\ bord0\ shad0\ alphaH3D Jangan bertindak atas namaku tanpa konfirmasi yang jelas

Tidak ada yang bisa dikirim, diterbitkan, dibagi atau diatur atas nama saya tanpa konfirmasi saya mengungkapkan dalam pesan saat ini. Termasuk surat, undangan kalender, berbagi dokumen, atau operasi apapun yang terjadi di luar dialog saat ini. Saya harus mengatakan ya jelas dalam berita saat ini。

Nah, berpikir sebelum Anda menulis kode

Untuk tugas yang melibatkan keputusan terstruktur, masalah debug kompleks, atau pengembangan fungsional yang tidak sederhana, satu per satu, lalu menulis kode. Tunjukkan penalaran Anda, menunjukkan ketidakpastian, dan kemudian menerapkannya。

Perubahan jangkauan yang tidak diperlukan dalam rollback mingguan: $150

pemeriksaan manual diff mingguan: $75

Perilaku yang tidak menyenangkan setiap pengembang: 225 / minggu

5 orang tim: $1125 / minggu

CLUDEMD perilaku paruh waktu: 30 menit

Memori dan teknologi gudang: Membuat Claude Kode setup benar-benar dapat diandalkan

Claude akan melupakan segala sesuatu di antara sesi。

Setiap keputusan yang Anda buat, setiap rumus yang Anda gagal, mengapa Anda memilih Prisma enam bulan yang lalu bukan Drizzle, dan mengapa batasan tertentu datang dari kebutuhan klien tertentu - itu dilupakan。

Dan kemudian itu akan reissue rumus Anda sudah mengesampingkan。

Bagian ini adalah setara dengan menyediakan Claude dengan mekanisme terdekat untuk "memori nyata" saat ini, sementara mengunci lemari besi teknologi Anda untuk menghindarinya terus merekomendasikan alat-alat yang bisa melemahkan struktur yang ada。

PENERJEMORY.md Decision Log

Menjaga berkas bernama MEMORY.md dalam proyek. Setiap kali keputusan penting dibuat, rekor baru ditambahkan:

Keputusan apa

Mengapa demikian

Menghindari apa, mengapa。

Baca Memory.md di awal setiap sesi. Tidak ada konflik dengan keputusan direkam diperbolehkan tanpa peringatan。

Ringkasan Sesi

Ketika saya mengatakan "sesi berakhir" "pembungkus" atau "mari kita berhenti di sini", tolong tulis ringkasan sesi ke Memory.md, termasuk:

Apa yang telah ditangani dengan saat ini

Apa yang telah dicapai

Apa yang masih terjadi

Keputusan diambil

:: Prioritas untuk sesi berikutnya。

Gagal Log

Menjaga file bernama ERRORS.m. Ketika sebuah program mencoba lebih dari dua kali untuk tetap gagal, itu dicatat bahwa:

Apa yang tidak bekerja

Apa yang terakhir bekerja

Yang perlu diperhatikan lain kali。

Periksa ERRORS.md sebelum mengusulkan program untuk tugas yang sama。

Daftar fakta Permanent

Fakta-fakta berikut tetap valid untuk proyek ini dan harus diterapkan ke setiap sesi tanpa pengecualian:

[Batas permanen Anda, keputusan struktural dan aturan]

Jika mandat tertentu bertentangan dengan fakta-fakta ini, silakan indikasikan sebelum implementasi。

♪ Lock the technology vault ♪

Gudang teknologi proyek adalah sebagai berikut dan alat-alat yang digunakan secara konsisten. Kecuali aku secara eksplisit meminta, tidak ada alternatif yang direkomendasikan:

Bahasa: [misalnya TypeScript]

Frame: [mis. Next.js 14]

manajer paket: [mis. pnpm]

Basis data: [misalnya PostgreSQL dengan Prisma]

Tes: [mis. Vital]

Styles: [mis. Taylor CSS]

Jika sebuah alat tampaknya tidak sesuai, itu dapat ditunjukkan. Tapi kecuali aku membuatnya jelas, sebuah gudang teknologi didefinisikan harus digunakan。

~ Hard decision-making trigger extended thinking

Bagi isu-isu yang berhubungan dengan arsitektur sistem, perdagangan kinerja, rancangan basis data, atau keputusan teknis jangka panjang, gunakan model pemikiran panjang。

Analisis langkah-demi-langkah masalah, dengan perdagangan-off yang saya mungkin tidak memperhitungkan, dan dengan asumsi yang mungkin tidak valid dalam hal peningkatan ukuran, akan memberikan saran Anda。

Nah, itu empat aturan merah

Karpathy menyimpulkan empat jenis perilaku yang akan membuat Claude Kode gagal. Satu pengembang memperbaikinya menjadi empat baris aturan di bawah ini. Jadi tingkat akurasi tersandi meningkat dari 65% menjadi 94%。

Pertama, jangan berasumsi。
Jika ada ketidakpastian, tanyakan sebelum menuliskan baris pertama. Jangan membuat asumsi diam tentang niat, struktur atau kebutuhan。

Pertama, yang paling sederhana。
Cara paling sederhana untuk bekerja selalu tercapai. Jangan tambahkan lapisan abstrak atau fleksibilitas yang secara eksplisit tidak diperlukan。

Jangan sentuh kode tidak relevan。
Jangan mengubah dokumen atau fungsi jika tidak secara langsung terkait dengan tugas saat ini. Bahkan jika kau pikir itu bisa dioptimalkan, jangan bergerak。

Mengidentifikasi ketidakpastian jelas。
Jika Anda tidak yakin tentang suatu program tertentu atau rincian teknis, silakan indikasikan sebelum melanjutkan. Kurangnya kepastian tapi ekspresi kepercayaan lebih merusak daripada pengakuan kesenjangan pengetahuan。

Pengembalian biaya per minggu karena keputusan yang terlupakan dan rekomendasi yang salah: 300 dolar per pengembang

Teknologi salah induktif dan alat yang tidak kompatibel: $75 per minggu

Limbah memori per pengembang: $375 / minggu

Tim 5- orang: $1875 / minggu

= = diterjemahkan oleh @ chasyatcha = =

Kesimpulan

Akun lengkap adalah sebagai berikut:

:: Mengulang konteks mingguan: $375

:: Weekly roll- back tanpa perubahan resmi: $225

Berurusan dengan masalah yang timbul dari keputusan yang terlupakan setiap minggu: $375

Total limbah per pengembang per minggu: $975。

Jika 5 orang tim pengembangan: $4875 per minggu. $253.500 per tahun。

Dan pengaturan CLUDEMD mengambil total dua jam。

Empat aturan Karpathy saja meningkatkan akurasi dikodekan dari 65% ke 94%。

Sebuah dokumen palsu, 21 aturan, dua jam kerja。

Pengembang yang menyelesaikan set-up ini sebenarnya menggunakan Claude yang lebih handal: ia dapat mengingat keputusan - membuat, kendali misi berkisar, meminta konfirmasi sebelum operasi destruktif, dan tidak merekomendasikan frameworks yang akan melemahkan struktur yang ada。

Dan mereka yang belum siap masih menghabiskan $975 seminggu untuk menjelaskan sendiri。

Catatan: dimulai dengan aturan 4 dari Karpathy. Hanya empat ini. Tempelkan ke berkas baru berikutnya di direktori root, yang disebut CLADEMD, selama dua menit. Kemudian akan diisi ulang berdasarkan mingguan berdasarkan celah yang telah Anda identifikasi。

Kumpulkan sebelum dibanjiri dengan informasi. Jika Anda merasa berguna, Anda dapat berbagi dengan seseorang yang benar-benar membutuhkannya。

[Terkekeh]Tautan Asli]