Cara Menyediakan CLAUDE.md pada 2026: Templat dan 6 Peraturan

Bahan tentang vibe coding: alat, kajian kes, kesilapan. Panduan Ailoot.

Mengapa anda memerlukan CLAUDE.md, dan mengapa Claude melupakan projek tanpanya?#

Anda membuka Claude Code pada hari Selasa dan menerangkan: “Saya sedang mengusahakan projek ini, ini alatnya, jangan buat perkara ini.” Ia berfungsi.

Pada hari Khamis, sembang yang sama sudah pun tamat, jadi anda mengulangi semuanya. Pada hari Sabtu, sekali lagi; pada hari Isnin, sekali lagi.

Begitulah rasanya bekerja dengan ejen tanpa CLAUDE.md: setiap tetingkap baharu ialah pelatih yang bermula dari kosong dan perlu diberitahu perkara yang sama berulang kali. Dahulu saya menghabiskan 5-10 minit menaip penerangan awal ini untuk setiap sesi. Arahan semakin panjang kerana saya perlu membawa semua konteks secara manual. Hasilnya tetap umum: ejen tidak tahu khalayak, ekonomi atau prinsip saya.

Dengan CLAUDE.md yang sentiasa dikemas kini, penerangan awal itu tidak lagi diperlukan. Semua peraturan yang dahulu anda ulang dalam setiap sembang berada dalam satu fail dan muncul secara automatik pada permulaan setiap sesi. Arahan menjadi ringkas: “buat X,” bukannya “saya sedang mengusahakan projek Y, alatnya Z, jangan buat A atau B, dan ingat juga C.”

Kemudian kesilapan berulang pun berhenti.

Setiap kesilapan ejen ialah sebab untuk menambah satu baris pada CLAUDE.md. Selepas sebulan, anda mempunyai “perlembagaan projek” yang sentiasa berkembang, dan Claude berhenti terjerumus ke dalam perangkap biasa yang sama.

Ada juga lapisan ketiga: ejen berhenti menulis dalam keadaan serba tidak tahu. Melalui CLAUDE.md, saya menghalakan Claude ke folder yang mengandungi konteks: tempat mencari maklumat tentang khalayak, harga dan penjenamaan. Tanpa penghalaan ini, ejen menulis “penyelesaian berkualiti tinggi” tanpa mengetahui ekonomi saya, lalu hasilnya abstrak, klise dan “sama seperti yang lain.”

Apakah CLAUDE.md, dan mengikut urutan apakah Claude membacanya?#

Anthropic menerangkan CLAUDE.md begini dalam dokumentasi rasminya:

Empat tempat Claude Code mencari CLAUDE.md, mengikut tertib keutamaan yang semakin meningkat:

Keempat-empat fail dimuatkan ke dalam konteks pada masa yang sama. Jika peraturannya bercanggah, Anthropic menyatakan secara langsung dalam dokumentasinya bahawa tidak diketahui yang mana satu akan diutamakan; Claude mungkin memilih salah satunya secara sewenang-wenangnya. Jadi lebih mudah untuk menyimpan semua perkara penting dalam CLAUDE.md projek dan mengelakkan pendua.

Ada satu butiran teknikal yang hampir tiada siapa tulis, tetapi ia menjelaskan banyak tingkah laku yang pelik.

Dalam erti kata lain, CLAUDE.md bukan “gesaan sistem” dalam erti kata yang ketat. Ia ialah mesej pengguna pertama yang dilihat Claude. Jadi peraturannya ialah saranan yang kuat, bukannya undang-undang. Jika sesuatu peraturan perlu dikuatkuasakan, gunakan hook yang diuji untuk peristiwa yang diliputinya serta kebenaran atau pengasingan persekitaran untuk sempadan akses yang lebih luas. Pelaksanaan hook secara automatik tidak menjadikan pemeriksaannya lengkap. Saya akan menerangkan batas antara hooks dengan `CLAUDE.md di bawah.

Bagaimanakah anda menulis CLAUDE.md minimum dalam 5 minit (templat sedia guna)?#

Di bawah ialah templat yang telah saya uji merentas berpuluh-puluh projek saya. Fail ini kekal sekitar 80-120 baris, mengikut saranan Anthropic supaya menyasarkan kurang daripada 200 baris. Dengan templat ini, ejen memberikan hasil yang paling munasabah.

# [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/<current plan>`,
   `mastery/<area>` 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.

Untuk meminta Claude mengisi templat ini secara automatik bagi projek anda, berikan arahan ini kepadanya. Claude akan membaca konteks dan mengisi medan dalam kurungan siku:

Create a CLAUDE.md file at the project root using this template:

[INSERT THE ENTIRE TEMPLATE FROM ABOVE]

Proceed as follows:

Read about-me/INDEX.md and business/INDEX.md to understand the project context and me as the author.

Fill in all the square-bracketed fields in the template based on what you find in those folders.

If some information is missing, ask me clarifying questions one at a time, with 3-4 answer options.

Sasarkan CLAUDE.md yang terhasil kurang daripada 200 baris. Jika lebih panjang, semak penduaan dan pindahkan prosedur terperinci ke fail berpaut. Kekalkan peraturan penting tentang perancangan, refleksi dan repositori, kemudian uji peraturan itu pada tugasan yang mewakili penggunaan sebenar.

Show me the final file and ask what should be revised.

Always respond in the user’s preferred language.

Jika anda belum mempunyai folder about-me/ dan business/, tidak mengapa. Claude akan bertanya soalan penjelasan dan menyediakan CLAUDE.md minimum berdasarkan maklumat yang tersedia. Anda boleh mencipta folder itu kemudian, selepas mengetahui perkara yang perlu dimasukkan.

Apakah 6 peraturan yang menjadikan CLAUDE.md dokumen yang sentiasa berkembang?#

Peraturan 1. Pastikan panjangnya kurang daripada 200 baris

Anthropic menyatakannya dengan ringkas dalam dokumentasi rasminya:

CLAUDE.md yang panjang memudaratkan dirinya sendiri dalam dua cara. Pertama, ia menggunakan token. Fail arahan sepanjang 800 baris dimuatkan ke dalam setiap tetingkap dan menggunakan beberapa ribu token daripada kuota anda dalam setiap sesi. Dengan langganan Pro yang mempunyai had harian, hal ini mengurangkan bilangan sesi yang tersedia dengan ketara. Kedua, model mula mengabaikan peraturan.

Dokumentasi menyarankan supaya menyasarkan kurang daripada 200 baris untuk mengurangkan penggunaan konteks dan meningkatkan pematuhan. Ia tidak menetapkan sempadan kegagalan mendadak pada baris ke-201. Semak kerelevanan, percanggahan, jumlah token yang dimuatkan dan hasil tugasan sebenar sebelum menentukan kandungan yang patut dipindahkan.

Peraturan 2. Akhiri setiap sesi dengan refleksi

Dalam CLAUDE.md, tulis: “Pada akhir setiap sesi, catat perkara yang anda lakukan dan pelajari dalam retrospectives/YYYY-MM-DD_*.md.” Selepas anda menambah baris ini, Claude mula mengakhiri setiap sesi dengan refleksi sendiri; anda tidak perlu memintanya.

Mengapa perlu membuat refleksi:

• Dua minggu kemudian, anda boleh membuka retrospektif lama dan mengingati sebab anda memilih laluan itu.
• Apabila anda kembali kepada projek sebulan kemudian, anda mempunyai peta keputusan terkini yang sedia digunakan.
• Jika anda bekerja dalam pasukan, rakan sekerja boleh membaca retrospektif itu dan memahami keadaan semasa dalam 2 minit tanpa panggilan.

Peraturan 3. Buat komit selepas setiap tugasan selesai

CLAUDE.md saya menyatakan: “Selepas setiap tugasan selesai, buat komit git dengan mesej yang bermakna.” Claude mula memecahkan kerja kepada komit atomik dengan sendirinya.

Ini memberi anda dua perkara. Pertama, jika sesuatu rosak, anda boleh mengundurkan satu operasi, bukannya “semua yang saya buat hari ini.” Kedua, sejarah komit menjadi log kerja yang menunjukkan perkara yang berubah dan susunannya.

Peraturan 4. Sentiasa rujuk folder business/

Untuk sebarang tugasan yang melibatkan pelanggan, produk atau teks, ejen perlu terlebih dahulu membuka business/INDEX.md dan fail berkaitan yang dirujuk di situ. CLAUDE.md saya menyatakan dengan jelas: “Apabila mengusahakan UI atau teks, semak dahulu business/audience/avatar.md dan business/assets/brand-guidelines.md.”

Tanpa peraturan ini, Claude menulis teks dalam “gaya umum laman web berkualiti.” Dengannya, teks menepati gaya anda dan keperluan pelanggan anda, tanpa perkataan yang dilarang.

Peraturan 5. Tambah peraturan selepas setiap kesilapan ejen

Inilah peraturan utama yang memastikan CLAUDE.md terus relevan.

Contoh daripada CLAUDE.md saya yang ditambah selepas kesilapan tertentu:

• “Jangan sekali-kali komit fail WIP orang lain menggunakan git add . - pentaskan fail mengikut nama.”
• “Sebelum menolak ke main, semak git log origin/main..main --oneline - jika hasilnya tidak kosong, jangan tolak.”
• “Jangan reka nilai - dapatkannya daripada .env atau kod. Terutamanya URL, nama pengguna dan token.”

Setiap baris ini ialah jejak kejadian tertentu. Pernah sekali, ejen mengomit cabang rakan kongsi yang belum selesai. Pernah sekali, saya memasukkan komit orang lain yang belum ditolak. Pernah sekali, ejen mereka URL yang tidak wujud. Setiap kesilapan menjadi peraturan, dan luka yang ditimbulkan sendiri itu tidak berulang.

Peraturan 6. Letakkan keselamatan dalam .claude/settings.json, bukan CLAUDE.md

Dalam CLAUDE.md, anda boleh menulis “jangan sentuh .env,” tetapi itu hanyalah permintaan; Claude mungkin melanggarnya kerana CLAUDE.md dimuatkan sebagai mesej pengguna, bukannya undang-undang. Untuk keselamatan kritikal, gunakan .claude/settings.json, yang membolehkan anda menyekat arahan tertentu dengan tegas.

Senarai sekatan yang saya tambah pada setiap projek baharu:

• rm -rf (pemadaman fail secara rekursif).
• Membaca keseluruhan .env (Read .env).
• export dan curl dalam arahan yang sama (corak untuk membocorkan rahsia ke luar).
• git push --force tanpa kelulusan jelas.

Cari panduan lain di Ailoot.

Bagaimanakah struktur CLAUDE.md dalam perniagaan aktif (anatomi fail 280 baris)?#

Kebanyakan contoh CLAUDE.md dalam talian ialah templat teknikal untuk pembangun: “Gunakan TypeScript,” “Jangan tulis ujian yang lebih panjang daripada 50 baris.” Bagi usahawan, CLAUDE.md seperti ini tidak berguna - ia tidak merangkumi aspek perniagaan.

Di bawah ialah struktur CLAUDE.md yang saya gunakan. Saya membuang peraturan dan laluan khusus kerana semuanya mencerminkan operasi dalaman saya. Namun, struktur dan logik bahagiannya boleh digunakan untuk mana-mana projek: masukkan keadaan anda sendiri dan anda akan mendapat fail yang boleh digunakan.

1. Penerangan ringkas projek (15 baris). Perkara yang kami lakukan, khalayak kami dan produk yang kami tawarkan. Bukan ringkasan laman pemasaran, tetapi ringkasan untuk ejen supaya ia memahami “hala tuju kita.”

2. Tentang saya (10 baris). Rujukan kepada folder about-me/ - gambaran digital tentang cara saya berfikir. Nada, nilai, prinsip, perkataan yang dilarang. Apabila Claude menulis teks “bagi pihak saya,” ia membaca folder ini dahulu supaya suaranya sepadan.

3. Struktur repositori (20 baris). Pepohon dengan ulasan: lokasi kod, konteks perniagaan, rancangan dan refleksi. Tanpa peta ini, Claude mencari fail secara rambang setiap kali.

4. Jadual “Tempat mencari perkara” (25 baris). Penghalaan daripada “soalan → fail.” Contohnya, bagi agensi hartanah, arahan mungkin berbunyi “perlukan syarat gadai janji → business/products/mortgage.md,” atau “perlukan nada suara untuk hantaran → business/assets/voice.md.” Gantikan dengan fail anda sendiri. Jadual ini ialah inti CLAUDE.md. Tanpanya, ejen meneka fail yang mengandungi jawapan. Dengannya, ejen terus ke sumber.

5. Prinsip utama projek (40 baris, 10-15 perkara). Bahagian ini terkumpul secara beransur-ansur dan memerlukan usaha paling banyak. Setiap perkara ialah jejak kesilapan tertentu. Contohnya, bagi kedai dalam talian, peraturannya mungkin “jangan sekali-kali masukkan harga dan masa penghantaran secara terus dalam kod,” “jangan terbitkan produk tanpa arahan jelas,” dan “semak gaya dengan glosari jenama sebelum menerbitkan senarai produk.” Bahagian ini ialah “perlembagaan projek.”

6. Perancangan operasi (20 baris). Jadual pencetus yang memetakan “frasa pengguna → tindakan.” Contohnya: “Apabila saya berkata ‘rancang minggu ini,’ buka ops/monthly.md dan cipta fail minggu ini.” Ini menjadikan Claude pembantu operasi yang memahami konteks arahan.

7. Alat (5 baris). Teknologi. Ringkas, tanpa isi kosong.

8. Penerbitan (15 baris). Proses langkah demi langkah untuk menerbitkan perubahan ke produksi: arahan yang perlu dijalankan, susunannya dan perkara yang perlu diperiksa. Dahulu saya menerangkannya setiap kali. Kini Claude sudah tahu.

9-12. Keselamatan (35 baris). Empat subseksyen berasingan: peraturan penggunaan .env, akses kepada pangkalan data produksi, arahan selamat untuk demo (rakaman skrin, penstriman, tangkapan skrin supaya token tidak terdedah secara tidak sengaja), serta peraturan penggiliran rahsia.

13. Folder plans/ (10 baris). Piawaian rancangan: nama fail, struktur fasa dan perkara yang perlu dimasukkan dalam blok ringkasan.

14. Folder retrospectives/ (5 baris). Piawaian refleksi: templat, nama fail dan kandungannya.

15. Data pangkalan data langsung (15 baris). Peraturan untuk menandakan “data terkini”: apabila fail menyatakan bahawa angka mesti terkini, ejen mendapatkannya daripada sumber dan bukannya menggunakan angka lama. Ini menghapuskan risiko Claude menggunakan angka semalam.

16. Bahasa (3 baris). “Sentiasa balas dalam bahasa pilihan pengguna. Gunakan tanda sempang sahaja, bukan tanda pisah em.”

Jumlahnya kira-kira 280 baris. Itu melebihi sasaran keringkasan tetapi tidak menjadikan fail tidak sah. Dalam contoh ini ia masih berguna; keputusan mengekalkannya patut bergantung pada penggunaan konteks yang diukur dan pemeriksaan tugasan yang mewakili penggunaan sebenar. Jadual tidak semestinya menggunakan kurang token daripada prosa.

Apakah yang dilakukan oleh arahan /init, dan mengapa ia tidak mencukupi?#

Anthropic menerangkan arahan itu begini dalam dokumentasinya:

Perkara yang dilakukan dengan baik oleh /init:

• Mengenal pasti alat daripada package.json, Cargo.toml dan pyproject.toml.
• Menyenaraikan arahan binaan dan ujian.
• Mengesan konvensyen daripada fail sedia ada (.eslintrc, .prettierrc).
• Mengesan peraturan Cursor sedia ada (.cursorrules, .cursor/rules/) dan peraturan Copilot, lalu memasukkan bahagian yang berkaitan. Ia mengesan AGENTS.md dalam mod CLAUDE_CODE_NEW_INIT=1.

Perkara yang tidak akan dilakukan oleh /init:

• Ia tidak akan tahu siapa pelanggan anda.
• Ia tidak akan memasukkan perkataan yang dilarang untuk penulisan teks.
• Ia tidak akan menambah peraturan tentang kesilapan ejen (kerana kesilapan itu belum berlaku).
• Ia tidak akan mencipta jadual “tempat mencari perkara” untuk struktur perniagaan anda.

Jadi aliran kerja yang betul ialah:

1. Jalankan /init dalam Claude Code

   Anda akan mendapat CLAUDE.md permulaan sepanjang 30-50 baris yang mengandungi alat dan arahan. Inilah asas teknikalnya.

2. Tambahkan templat daripada artikel ini

   Gunakan bahagian “CLAUDE.md minimum dalam 5 minit.” Tambahkan bahagian untuk navigasi, penghalaan dan prinsip.

3. Isikan medan dalam kurungan siku

   Berikan Claude arahan “baca projek saya dan isikan templat.” Jika folder business/ dan about-me/ belum wujud, Claude akan bertanya soalan penjelasan.

4. Jalankan ujian tekanan

   Beritahu Claude, “Baca CLAUDE.md saya dan cari 10 perkara yang kabur sehingga anda sebagai ejen mungkin tersalah faham.” Anda akan mendapat senarai pembetulan.

5. Kemudian, gunakan fail itu

   Tambah satu baris selepas setiap kesilapan ejen. Dalam sebulan, anda akan mempunyai CLAUDE.md yang terus berkembang dan disesuaikan dengan perniagaan anda.

Arahan untuk langkah keempat:

I have a CLAUDE.md. Tomorrow I’ll be building a feature based on it.

Your task is to stress-test it. Find 10 reasons we could potentially fail:

where CLAUDE.md is ambiguous and you, as an agent, might misunderstand it

where there are gaps that would force you to make things up

where rules contradict one another

where I overestimate how much can be done in one day

where I underestimate things (this is even worse)

Don’t hold back. Criticize it harshly. I want to find these issues now, not in production.
At the end, give me a list of specific changes: what to change and how, so these problems don’t happen.

CLAUDE.md vs AGENTS.md vs MEMORY.md: siapa membaca fail yang mana pada 2026?#

Soalan utama yang mengelirukan pengguna baharu ialah: adakah Claude Code membaca AGENTS.md? Sebelum September 2026, jawapannya “tidak”: dokumentasi Anthropic menyarankan supaya mencipta CLAUDE.md yang mengimport AGENTS.md. Sejak versi 2.1.277 (dikeluarkan pada 18 September 2026), Claude Code membaca AGENTS.md sendiri, tetapi hanya jika tiada CLAUDE.md, .claude/CLAUDE.md atau CLAUDE.local.md dalam folder kerja atau di atasnya.

Jika projek mempunyai CLAUDE.md, Claude Code secara lalai hanya membaca fail itu dan melangkau AGENTS.md. Anda boleh mengubahnya dalam /config, di bawah Project instructions: sebagai contoh, tetapan claude-md-and-agents-md akan membuatnya membaca kedua-dua fail. Satu lagi cara yang berfungsi dalam mana-mana versi: tambah import dalam CLAUDE.md:

@AGENTS.md

## Claude Code

Additional rules for Claude Code that other agents don’t need.

Sintaks @filename mengimport fail lain. Claude membacanya dan memuatkannya ke dalam konteks bersama CLAUDE.md. Import itu tidak menyebabkan fail dibaca dua kali, walaupun Claude Code boleh membaca AGENTS.md dengan sendirinya.

Bila anda memerlukan AGENTS.md. Jika anda bekerja serentak dengan Claude Code dan Codex CLI, Cursor atau Copilot, cipta AGENTS.md sebagai sumber kebenaran tunggal, letakkan @AGENTS.md dalam CLAUDE.md, dan tambahkan peraturan khusus Claude di atasnya. Jika tiada peraturan sedemikian, anda tidak perlu mencipta CLAUDE.md: sejak versi 2.1.277, Claude Code akan membaca AGENTS.md sendiri. Jika anda hanya menggunakan Claude Code, anda tidak memerlukan AGENTS.md; gunakan satu CLAUDE.md sahaja. Untuk semua pilihan, langkah demi langkah, lihat panduan menggunakan AGENTS.md dan CLAUDE.md dalam satu projek.

Apakah MEMORY.md? Sejak kemas kini baru-baru ini, Claude Code menyimpan nota tentang anda secara automatik dalam ~/.claude/projects/<project-name>/memory/MEMORY.md. Nota ini termasuk tabiat perbualan (“pengguna lebih suka jawapan ringkas”), frasa berulang (“melarang emoji dalam kod”) dan pemerhatian tingkah laku (“bekerja pada macOS, menggunakan zsh”).

Ini sistem ingatan yang berasingan daripada CLAUDE.md. Anda tidak menulisnya sendiri; Claude menulisnya berdasarkan perbualan anda. Jika MEMORY.md mengandungi sesuatu yang patut menjadi peraturan, pindahkannya ke CLAUDE.md. Jika kandungannya tidak perlu atau salah, anda boleh memadamkannya secara manual; ia hanyalah fail teks.

Berapakah saiz CLAUDE.md yang berguna, dan bagaimana menyemak fail panjang?#

Dalam setiap tetingkap Claude Code, beberapa lapisan dimuatkan ke dalam konteks: gesaan sistem Anthropic (dianggarkan puluhan ribu token), CLAUDE.md anda, fail yang diimport dengan @, MEMORY.md, sejarah sembang semasa dan kandungan fail yang dibuka Claude. Semua ini perlu muat dalam konteks model (200K token untuk Sonnet, 1M untuk Opus).

Semakin besar CLAUDE.md, semakin kurang ruang untuk kerja semasa. Fail 1,000 baris bersamaan kira-kira 8,000 token dan diulang dalam setiap sesi. Dengan langganan Pro (mengikut pengalaman saya, sekitar 10-12 arahan “berat” sehari), ini mengurangkan kapasiti anda sebanyak satu perempat.

Kos hanyalah satu kebimbangan. Pematuhan boleh merosot apabila arahan panjang, tidak relevan atau bercanggah; tiada bilangan arahan dipatuhi yang sejagat. Uji beberapa tugasan yang mewakili penggunaan sebenar dan melibatkan peraturan kritikal, catat kegagalan serta bandingkan tingkah laku selepas suntingan terarah.

Jadi, berikut ialah panduan umum tentang saiz:

• 80-120 baris - julat permulaan yang mudah untuk peta projek ringkas, bukan skor pematuhan yang dijamin.
• 150-200 baris - petunjuk berguna untuk menyemak kerelevanan dan memindahkan prosedur terperinci ke fail berpaut.
• 200-300 baris - periksa jumlah token, penduaan dan hasil tugasan; contoh perniagaan 280 baris di atas mungkin masih berfungsi dengan baik.
• 400+ baris - sebab kukuh untuk semakan terarah, bukan bukti fail tidak boleh digunakan. Kekalkan batasan penting dan pindahkan butiran hanya selepas memeriksa pautan dan peraturan masih berfungsi.

Bilangan baris sahaja tidak dapat membuktikan kejayaan atau kegagalan. Selepas menyunting, ulang tugasan perwakilan yang sama dan sahkan peraturan penting, bukan menetapkan peratus pematuhan rekaan.

Anthropic memberikan ujian langsung dalam dokumentasinya:

Gunakan ujian ini pada setiap baris. Jika jawapannya “ia tetap akan melakukannya dengan betul,” buang baris itu. CLAUDE.md bukan tempat untuk dokumentasi, sejarah keputusan atau falsafah. Fail ini hanya untuk peraturan yang diperlukan ejen supaya tidak melakukan kesilapan.

Apakah 7 kesilapan yang menjadikan CLAUDE.md tidak berguna?#

Kesilapan 1. “Jadilah jurutera yang baik”

Kesilapan paling biasa. Orang menulis harapan umum dalam CLAUDE.md: “tulis kod yang kemas,” “gunakan amalan terbaik,” “berfikir seperti jurutera kanan.”

Kata-kata ini tidak bermakna apa-apa. Claude sudah menulis “kod kemas” secara umum. Baris-baris ini menggunakan ruang konteks tanpa mempengaruhi sebarang keputusan.

Gantikan “tulis kod yang kemas” dengan “gunakan inden 2 ruang,” “jangan gunakan any dalam TypeScript,” atau “fungsi mestilah tidak melebihi 30 baris.” Khusus dan boleh disahkan.

Kesilapan 2. Mengulang perkara yang sudah diketahui Claude

Penerangan tentang konvensyen bahasa standard (“dalam JavaScript, fungsi ialah warga kelas pertama,” “TypeScript mempunyai penaipan statik”). Penerangan tentang cara npm, git atau docker berfungsi.

Claude sudah mempelajari semua ini semasa latihan. Mengulangnya dalam CLAUDE.md tidak menambah apa-apa; ia hanya mengurangkan ruang konteks anda.

Kesilapan 3. Arahan langkah demi langkah yang panjang dalam CLAUDE.md

Arahan panjang tentang “cara melancarkan projek,” “cara menulis migrasi pangkalan data,” atau “cara menyediakan komponen baharu.” Berpuluh-puluh baris langkah demi langkah.

Ini bukan tempat untuk arahan langkah demi langkah yang panjang. Fail ini untuk peraturan satu baris. Letakkan arahan panjang dalam skills/ (mekanisme Claude Code berasingan yang dimuatkan apabila diperlukan) atau dalam docs/. Dalam CLAUDE.md, gunakan pautan satu baris: “Apabila mencipta migrasi baharu, buka docs/migrations.md.”

Kesilapan 4. Peraturan yang sudah diperiksa oleh penganalisis kod automatik

“Gunakan koma bertitik,” “jangan tinggalkan import yang tidak digunakan,” “jangan gunakan var.” ESLint, Prettier dan Biome mengesan semua ini - semuanya linter (alat semakan kod automatik).

Linter bersifat deterministik: ia berjalan, mengesan ralat dan membetulkannya. Peraturan CLAUDE.md bersifat kebarangkalian; ejen mungkin terlupa. Tidak perlu mengulangnya - lebih mudah untuk mengkonfigurasi linter.

Kesilapan 5. Rahsia dalam CLAUDE.md

Saya pernah melihat kata laluan akaun ujian, token API kotak pasir dan pautan ke panel pentadbir yang memerlukan pengesahan. Semuanya berada dalam fail yang dikomitkan ke git dan dimuatkan ke dalam konteks model Anthropic.

Jangan sekali-kali. Rahsia disimpan dalam .env, yang berada dalam .gitignore. Paling banyak, CLAUDE.md patut menyatakan: “Jangan baca keseluruhan .env; gunakan grep untuk pemboleh ubah tertentu.”

Kesilapan 6. Fail pembuangan 500+ baris yang tidak dibersihkan selama enam bulan

CLAUDE.md semakin panjang, mengulang separuh kandungan docs/, bercanggah dengan dirinya sendiri di beberapa tempat, dan tiada siapa ingat kandungannya. Ejen mula mengabaikan kebanyakannya. Pasukan mengadu bahawa “Claude tidak mengikut arahan” lalu menambah lebih banyak peraturan, menjadikan keadaan lebih buruk.

Tanda CLAUDE.md diabaikan: lebih daripada 300 baris, peraturan yang diulang dalam bahagian berlainan, pautan lapuk ke fail yang sudah tiada, dan nota “sejarah” seperti “pada 2024 kita memutuskan untuk melakukan begini, kemudian mengubah fikiran.”

Penyelesaiannya: setiap dua minggu, minta Claude menyemaknya dengan ujian Anthropic, “Jika baris ini dibuang, adakah ejen akan melakukan kesilapan?” Padamkan apa-apa yang jawapannya “tidak.”

Kesilapan 7. CLAUDE.md dicipta lalu dilupakan

Ini bertentangan dengan kesilapan sebelumnya. Fail itu disediakan sekali dua bulan lalu dan tidak disentuh sejak itu. Sementara itu, alat telah berubah, folder baharu ditambah dan kesilapan ejen baharu berlaku. CLAUDE.md tidak mengetahui semua ini kerana tiada siapa mengemas kininya.

Tanda yang jelas: anda mengulangi arahan yang sama dalam setiap sesi. “Jangan buat X,” “jangan sentuh Y,” “ingat Z.” Jika anda sudah mengulangnya lebih daripada dua kali, peraturan itu patut dimasukkan ke CLAUDE.md, bukannya disimpan dalam fikiran.

Bagaimanakah anda menjadikan CLAUDE.md belajar sendiri dengan peraturan “kemas kini pada akhir sesi”?#

CLAUDE.md saya mempunyai bahagian ringkas:

## 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.

Selepas bahagian ini ditambah pada CLAUDE.md, Claude mula bertanya pada akhir setiap sesi: “Adakah sesuatu yang baharu patut direkodkan?” Jika ada, Claude mencadangkan draf peraturan, saya menjelaskannya, lalu satu fail dicipta.

Selepas dua bulan bekerja dengan cara ini, saya mempunyai lebih daripada dua dozen fail dalam about-me/feedback/ - peraturan yang dipelajari daripada kesilapan tertentu. Setiap fail ialah satu halaman dalam format Peraturan → Sebab → Cara. Folder itu menjadi “ingatan kedua” yang merekodkan pilihan dan pantang larang peribadi saya.

Setiap kesilapan tidak diulang kerana ia menjadi peraturan, dan peraturan terkumpul serta saling menguatkan. Selepas enam bulan, Claude lebih memahami projek saya daripada ingatan saya sendiri selepas berehat sebulan.

Bagaimanakah anda menambah peraturan undang-undang, pemasaran dan operasi pada CLAUDE.md?#

Bagi kebanyakan pasukan, CLAUDE.md ialah dokumen teknikal semata-mata: alat, arahan binaan, konvensyen pengekodan. Itu berguna, tetapi hanya satu pertiga daripada nilainya.

Apabila usahawan menyelenggara CLAUDE.md, menambah bahagian perniagaan memang wajar. Tiga bahagian paling penting:

Peraturan undang-undang (untuk pasaran terkawal)

Jika anda menerbitkan teks dalam industri terkawal (kewangan, perubatan, pengiklanan ubat, produk kanak-kanak), perkataan yang dilarang mempunyai implikasi undang-undang dan patut dimasukkan ke CLAUDE.md sebagai peraturan yang jelas. Bukan dalam fikiran seseorang, bukan dalam tangkapan skrin penyunting - tetapi dalam fail yang dilihat ejen dalam setiap sesi.

Contoh untuk projek fintech tanpa lesen perbankan:

Nota editorial: Berikut ialah format peraturan dalaman bagi projek tertentu. Ini bukan kebenaran umum untuk menggunakan istilah yang disenaraikan: sama ada sesuatu pernyataan boleh diterima bergantung pada undang-undang yang terpakai dan status syarikat.

🚨 KRITIKAL - istilah kewangan dilarang. Dalam bahan untuk pelanggan, jangan gunakan: “deposit,” “pulangan terjamin” atau “produk pelaburan.” Gunakan: “akaun simpanan,” “pulangan dijangka” dan “produk kadar berubah.” Sebabnya ialah keperluan undang-undang yang terpakai kepada pengiklanan perkhidmatan kewangan bagi projek ini.

Blok ini dalam CLAUDE.md melakukan sesuatu yang mudah: setiap kali anda meminta Claude menulis teks untuk pelanggan, ejen menyemaknya berdasarkan larangan ini. Tanpa peraturan itu, perkataan terlarang muncul dalam setiap kempen ketiga. Dengannya, anda tidak perlu memikirkannya lagi.

Pendekatan yang sama berfungsi untuk:

• Projek perubatan (tiada dakwaan bahawa sesuatu “merawat” atau “menyembuhkan”).
• Pengiklanan ubat (tiada dakwaan “paling berkesan”; amaran yang diwajibkan).
• Mana-mana industri terkawal yang mempunyai peraturan pengiklanan tersendiri.

Gaya pemasaran dan format teks

Jika anda kerap menerbitkan teks (media sosial, surat berita, laman web), dokumentasikan formatnya dalam satu perenggan CLAUDE.md. Berikut contoh yang mungkin ditulis oleh pempengaruh atau agensi yang mengendalikan saluran pemesejan:

Apabila menulis hantaran saluran, rujuk style/posts.md. Gunakan penanda pemformatan yang dibenarkan oleh saluran dan elakkan aksara khas yang “berbahaya.” Akhiri dengan CTA yang mempunyai tag UTM mengikut konvensyen ini: utm_source=<channel>&utm_medium=<type>&utm_campaign=<slug>.

Dahulu Claude menulis hantaran dalam “gaya umum laman web pemasaran.” Kini ia mengikut format anda, menggunakan UTM anda dan tidak mendedahkan bahawa teks itu ditulis oleh AI.

Tabiat operasi

Jadual pencetus. Apabila anda menyebut frasa tertentu, ejen tahu fail yang perlu dibuka dan tindakan yang perlu dilakukan. Berikut contoh untuk pasukan yang membuat perancangan mingguan:

“Rancang minggu ini” → buka ops/monthly.md, cipta YYYY-WNN.md dalam folder yang sama, dan pindahkan tugasan daripada ops/backlog.md ke bawah hari yang sesuai. “Apa yang ada dalam senarai tertunggak?” → baca ops/backlog.md dan paparkannya sebagai senarai. “Tutup minggu ini” → isikan bahagian “Ringkasan minggu” dalam fail minggu semasa.

Dengan jadual seperti ini, Claude berubah daripada “pembantu yang menulis kod” menjadi “pengendali” yang memahami rutin perniagaan anda. Setiap Isnin, saya berkata “mari rancang minggu ini,” lalu Claude membuka fail yang betul, membaca matlamat bulanan dan mencadangkan cara membahagikan kerja.

Bagaimanakah anda menyemak CLAUDE.md menggunakan senarai semak 12 perkara dalam 5 minit?#

1. Saiz. Adakah fail ini ringkas, dengan kira-kira 200 baris sebagai sasaran semakan dan bukan had lulus/gagal?
2. Nama. Adakah namanya tepat CLAUDE.md dengan huruf besar, bukannya claude.md?
3. Lokasi. Adakah fail ini di akar projek atau dalam ./.claude/CLAUDE.md?
4. Penerangan projek. Adakah 5 baris pertama menjelaskan projek itu dan khalayak sasarannya?
5. Alat. Adakah teknologi disenaraikan dengan jelas dan tanpa isi kosong?
6. Struktur. Adakah terdapat rajah repositori berserta penerangan?
7. Penghalaan. Adakah terdapat jadual “soalan → fail” yang menunjukkan tempat mencari jawapan?
8. Prinsip. Adakah terdapat bahagian dengan peraturan yang bermula dengan “jangan sekali-kali” dan “sentiasa”?
9. Kekhususan. Adakah setiap peraturan boleh disahkan? (“Gunakan 2 ruang,” bukannya “tulis dengan indah.”)
10. Kemas kini sendiri. Adakah terdapat peraturan untuk “memeriksa perkara yang perlu ditambah pada akhir sesi”?
11. Refleksi. Adakah terdapat peraturan untuk “merekodkan ringkasan sesi dalam retrospectives/”?
12. Keselamatan. Adakah larangan kritikal (.env, rm -rf) turut dimasukkan dalam .claude/settings.json?

Jika anda menjawab “tidak” lebih daripada lima kali, buka Claude dan berikan arahan ini:

Read my CLAUDE.md and compare it with the checklist below. For each item, say: yes / no / partly, and what specifically to fix.

Checklist:

Cukup ringkas untuk tugasan; semak sekitar 200 baris tanpa menganggapnya had tegas

Project description in the first 5 lines

Tools listed explicitly

Repository structure diagram included

“Question → file” table included

Principles section with rules included

Every rule is specific and verifiable

“Update at the end of the session” rule included

“Reflect at the end of the session” rule included

Critical prohibitions included in .claude/settings.json

No duplicates of the same rule in different sections

No dangling links to files that no longer exist

After the audit, give me a list of specific changes that will make the file living.

Apakah yang patut digunakan selepas CLAUDE.md: Plan Mode, Skills atau sub-ejen?#

CLAUDE.md ialah asasnya. Selepas ia berfungsi, anda boleh menambah tiga mekanisme Claude Code yang saling menguatkan.

Plan Mode. Mod yang membolehkan Claude menyediakan rancangan perubahan dahulu, menunggu kelulusan anda, kemudian barulah mula bekerja. Aktifkannya dengan Shift+Tab atau arahan /plan. Mod ini menangani masalah utama vibe coding: “Saya meminta Claude membetulkan satu perkara, tetapi ia menulis semula separuh daripada projek.” Perkara itu tidak akan berlaku dalam Plan Mode - anda melihat rancangan sebelum ejen menyentuh sebarang fail.

Skills. Fail .md berasingan dalam folder .claude/skills/ yang mengandungi pengetahuan untuk jenis tugasan tertentu. Contohnya, kemahiran “cara menulis migrasi pangkalan data” mengandungi prosedur khusus, templat dan contoh. Pengetahuan itu tidak diletakkan dalam CLAUDE.md kerana terlalu panjang. Namun, apabila Claude menemui tugasan seperti “tulis migrasi,” ia memuatkan kemahiran berkaitan dan mengikutinya.

Sub-ejen. Apabila tugasan memerlukan banyak konteks (contohnya, menyemak ciri besar), Claude boleh memulakan sub-ejen berasingan dalam konteks bersihnya sendiri. Sub-ejen itu melakukan kerja dan memulangkan hasil tanpa menyemakkan konteks sembang utama anda.

Ketiga-tiga mekanisme menggunakan CLAUDE.md sebagai titik permulaan: semuanya membacanya pada permulaan kerja untuk memahami konteks projek. Itulah sebabnya ciri-ciri ini turut berfungsi dengan buruk tanpa CLAUDE.md yang sentiasa dikemas kini. Kukuhkan asas dahulu, kemudian tambah lapisan di atasnya.

Langkah seterusnya. Cipta fail CLAUDE.md di akar projek, salin templat dari awal artikel ini dan isikan medan dalam kurungan siku menggunakan arahan pembantu. Kemudian gunakan fail itu: jadikan setiap kesilapan ejen satu baris baharu. Selepas dua atau tiga minggu, CLAUDE.md berhenti menjadi “dokumen yang ditulis lalu dilupakan” dan menjadi sesuatu yang benar-benar dirujuk Claude dalam setiap sesi.

Jika anda mahu membina rangka kerja lengkap di sekitar CLAUDE.md - folder business/ untuk Otak Kedua, folder about-me/ untuk gambaran digital diri anda, kemahiran asas dan Plan Mode yang dikonfigurasi - gunakan langkah dan contoh dalam artikel ini. Panduan Ailoot.

Teruskan membaca panduan Ailoot.