# Otak Kedua dalam Claude Code: Cara Membina Strukturnya dalam Masa Sejam > Cara membina otak kedua untuk Claude Code: hierarki memori, struktur folder lima bahagian dan git supaya ejen mengingati segala-galanya tentang projek anda antara sesi. Source: https://ailoot.ai/blog/ms/claude-code-second-brain/ Canonical: https://ailoot.ai/blog/ms/claude-code-second-brain/ Language: ms Publisher: Ailoot (https://ailoot.ai/) Translation: guide-233 Revision: sha256-a863c39c4e2cdcd456b8bcf20074614d01e6db4ea323fbdfa7cda64e3f61c2c3
Perkara utama Otak kedua Claude Code bukan satu fail; ia ialah struktur lima folder bersama git. CLAUDE.md menetapkan peraturan dan laluan, `business/` menyimpan pengetahuan tentang projek, `ai-clone/` menyimpan maklumat tentang anda sebagai pembuat keputusan, `plans/` mengandungi pelan teknikal, dan `retrospectives/` menyimpan pengajaran daripada sesi terdahulu. Ejen bermula dengan CLAUDE.md dan mengikuti pautan ke folder yang sesuai untuk permintaan tertentu. Artikel ini membincangkan hierarki memori dalam dokumentasi rasmi Claude Code, struktur lima bahagian dan cara membinanya langkah demi langkah dalam masa sejam.
Dokumentasi rujukan Ailoot: [ailoot.ai/docs/](https://ailoot.ai/docs/). ## Mengapa Claude Code memerlukan otak kedua, dan apakah yang penting?
Perkara utama Satu fail CLAUDE.md merangkumi peraturan asas, tetapi tidak dapat mengendalikan memori perniagaan. Selepas sebulan, anda sudah lupa sebab anda menaikkan harga. Selepas tiga bulan, anda sudah lupa sebab anda menolak pembayaran ansuran. Pengetahuan berada serentak di empat tempat: dalam fikiran anda, sembang Telegram, dokumen Google dan fikiran pekerja. Otak kedua mengumpulkan semuanya dalam satu folder fail markdown bersama projek, dan Claude boleh mengaksesnya sendiri.
Anda membuka Claude Code pada hari Selasa. Anda menerangkan: inilah projeknya, inilah khalayaknya, jangan buat perkara ini. Anda bekerja bersama. Pada hari Khamis, anda membuka sembang baharu dan perlu menerangkan semuanya sekali lagi. Jika anda mempunyai CLAUDE.md, anda sudah menyelesaikan pusingan pertama kekecewaan. Peraturan asas dan penerangan projek berada dalam satu fail dan dimuatkan ke dalam setiap sesi. Saya menerangkan cara fail ini berfungsi dalam [panduan CLAUDE.md](https://ailoot.ai/blog/ms/claude-md-template/) saya - anda boleh membacanya dahulu untuk menyediakan asas. Namun, CLAUDE.md ialah manual arahan untuk pekerja baharu. Cara berpakaian, nada yang digunakan dengan pelanggan, arahan yang digunakan untuk menerbitkan sesuatu. Itu tidak mencukupi untuk membuat keputusan yang baik tentang projek. Keputusan memerlukan pengetahuan: apakah produk itu, siapa khalayaknya, bagaimana ekonominya berfungsi, apakah yang telah anda cuba dan apakah yang tidak berhasil. Dalam pengalaman penulis yang diterangkan di sini, pengetahuan itu dahulu berada di empat tempat: dalam fikirannya, sembang Telegram, dokumen Google dan fikiran pekerja. Sebulan selepas sesuatu keputusan dibuat, tiada sesiapa mengingati sebabnya. Orang baharu perlu menghabiskan sejam menyoal pasukan untuk memahami keadaan. Claude langsung tidak mempunyai konteks tersebut. Sebelum otak kedua diwujudkan, dalam pengalaman penulis yang diterangkan, setiap sesi bermakna perlu menerangkan semula siapa pelanggan itu, bagaimana tawaran disusun dan penyedia mana yang mengendalikan pembayaran. Dengan `business/`, saya membuka sembang dan berkata, “kemas kini tawaran untuk pelan harga baharu” - Claude sendiri pergi ke `business/company/legal.md`, membaca keperluan, kemudian pergi ke `business/products/pricing.md`, melihat pelan harga baharu dan mencadangkan suntingan dalam satu laluan. Persediaan awal itu hilang; konteks dimuatkan secara automatik.
Nota Ini bukan masalah memori Claude. Ini masalah seni bina. Tetingkap konteks ejen ialah memori kerjanya. Ejen hanya memuatkan perkara yang anda tunjukkan secara jelas. Semua yang lain berada di luar tetingkap dan dimuatkan apabila diperlukan. Otak kedua menyimpan “semua yang lain” itu secara tersusun supaya Claude dapat mencari maklumat yang diperlukan.
Anthropic menyebut masalah ini sebagai pereputan konteks dalam blog kejuruteraannya:
Semakin banyak token dalam tetingkap konteks, semakin lemah keupayaan model untuk mengingati maklumat daripada konteks itu dengan tepat.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
Dengan kata lain, semakin banyak yang anda sumbat ke dalam tetingkap, semakin lemah keupayaan ejen untuk mengendalikan butiran. Penyelesaiannya ialah mengekalkan struktur fail luaran yang boleh dikunjungi Claude sendiri apabila menerima permintaan tertentu. Itulah otak kedua. ## Apakah itu otak kedua, dan bagaimana konsep ini terpakai kepada Claude?
Perkara utama Ideanya mudah: fikiran anda digunakan untuk berfikir, bukan untuk menyimpan perkara. Bagi Claude Code, otak kedua beralih daripada kaedah produktiviti kepada seni bina ejen: folder nota luaran yang boleh diakses terus oleh ejen melalui sistem fail.
Lazimnya, otak kedua berkaitan produktiviti secara umum. Pengguna mencipta peti besi Obsidian dan menambah petikan daripada buku, nota panggilan dan idea projek. Apabila penulis menerapkan idea ini dalam kerja dengan Claude Code, ia tidak lagi berkaitan produktiviti, sebaliknya menjadi seni bina ejen. Dalam pendekatan klasik, otak kedua itu milik anda dan anda mengaksesnya secara manual. Apabila bekerja dengan Claude Code, otak kedua menjadi **dua hala**: anda dan ejen sama-sama mengaksesnya. Hal itu mengubah keperluan formatnya. Oleh sebab ejen mengaksesnya sendiri, fail perlu menggunakan format yang difahaminya tanpa integrasi berasingan. Markdown amat sesuai: teks, hierarki tajuk dan pautan antara fail. Notion dan Google Docs tidak sesuai. Anda boleh menyambungkannya melalui MCP, tetapi itu menambah satu lapisan, satu token lagi bagi setiap permintaan dan satu lagi titik kegagalan. Oleh sebab fail berada dalam sistem fail bersama projek, fail itu secara automatik berada dalam jangkauan Claude Code. Tiada persediaan diperlukan. Mulakan ejen dalam folder projek dan ia dapat melihat semua fail di dalamnya. Percuma dan terus berfungsi.
Petua Anda boleh menyimpan otak kedua dalam Obsidian - saya juga membukanya di sana supaya lebih mudah melihat graf hubungan. Namun, fail itu sendiri berada dalam folder biasa bersama kod. Obsidian hanyalah pembungkus yang menarik untuk fail markdown. Claude dapat melihatnya tanpa Obsidian. Anda boleh menggunakan mana-mana penyunting; yang penting ialah fail berada pada cakera, bukannya dalam perkhidmatan awan dengan formatnya sendiri.
## Apakah hierarki memori yang tersedia dalam Claude Code secara lalai?
Perkara utama Claude Code boleh membaca empat peringkat CLAUDE.md secara lalai (enterprise, user, project dan local), dan sejak versi 2.1.59 ia mengekalkan memori automatiknya sendiri dalam `~/.claude/projects//memory/`. Ini mencukupi untuk memori asas, tetapi bukan konteks perniagaan - simpan konteks itu dalam folder berasingan bersama projek.
Sebelum menambah apa-apa sendiri, mari lihat perkara yang boleh diingati Claude tanpa bantuan anda. Anthropic menerangkan dua mekanisme dalam [dokumentasi rasminya](https://code.claude.com/docs/en/memory): CLAUDE.md (peraturan yang anda tulis) dan memori automatik (pengajaran yang ditulis Claude sendiri). Kedua-duanya dimuatkan pada permulaan setiap sesi. CLAUDE.md dicari di empat tempat serentak: | Peringkat | Lokasi | Tujuan | |----|----|----| | **Enterprise** | `/Library/Application Support/ClaudeCode/CLAUDE.md` (macOS), `/etc/claude-code/CLAUDE.md` (Linux), `C:\Program Files\ClaudeCode\CLAUDE.md` (Windows) | Peraturan yang digunakan pentadbir untuk seluruh pasukan melalui MDM. Individu tidak memerlukannya. | | **User** | `~/.claude/CLAUDE.md` | Peraturan peribadi yang terpakai merentas semua projek. “Jawab dalam bahasa pilihan saya,” “jangan gunakan tanda pisah panjang.” | | **Project** | `./CLAUDE.md` di akar projek | Peraturan untuk projek tertentu: susunan teknologi, struktur folder, peraturan perniagaan. Disimpan dalam git. | | **Local** | `./CLAUDE.local.md` | Nota peribadi anda untuk projek ini, yang tidak disimpan dalam git. Dimasukkan dalam `.gitignore`. | Keempat-empat fail dimuatkan ke dalam konteks. Semakin khusus peringkatnya, semakin tinggi keutamaannya. Fail local dibaca terakhir, jadi peraturannya mengatasi semua yang lain. Fail CLAUDE.md juga boleh berada dalam mana-mana folder di dalam projek. Apabila Claude membaca fail daripada subfolder, ia memuatkan CLAUDE.md subfolder itu apabila diperlukan. Ini berguna dalam monorepo: peraturan frontend berada dalam `frontend/CLAUDE.md`, peraturan backend dalam `backend/CLAUDE.md`, dan masing-masing hanya dimuatkan apabila ejen mengusahakan bahagian yang berkenaan. Memori automatik muncul dalam Claude Code 2.1.59. Fail-fail ini ditulis oleh Claude tentang anda: ``` ~/.claude/projects//memory/ ├── MEMORY.md # Indeks, dimuatkan dalam setiap sesi (200 baris atau 25KB) ├── debugging.md # Nota terperinci (dimuatkan apabila diperlukan) ├── api-conventions.md └── ... ``` Anthropic menerangkannya begini dalam dokumentasi rasmi:
Claude tidak menyimpan sesuatu dalam setiap sesi. Ia menentukan perkara yang patut diingati berdasarkan sama ada maklumat itu mungkin berguna dalam perbualan akan datang.
— Anthropic, code.claude.com/docs/en/memory
Memori automatik didayakan dengan bendera `autoMemoryEnabled` dalam `~/.claude/settings.json`. Claude menentukan perkara yang hendak ditulis di situ. Anda boleh membaca MEMORY.md dan menyuntingnya secara manual - ia markdown biasa.
Amaran Memori automatik berguna, tetapi bukan pengganti otak kedua. Claude menulis pengajaran taktikal tentang alat dan corak kod di situ. “Skrip ini rosak tanpa bendera X,” “nama jadual pangkalan data ini begini.” Claude tidak menulis strategi perniagaan di situ. Jika anda mahu ejen mengingati siapa khalayak anda dan sebab anda memilih harga tertentu, anda perlu meletakkannya sendiri dalam folder konteks berasingan.
## CLAUDE.md atau otak kedua - di manakah sempadannya?
Perkara utama CLAUDE.md ialah manual arahan untuk pekerja baharu: cara berkelakuan, arahan yang perlu digunakan dan perkara yang tidak boleh dilakukan. Otak kedua ialah wiki syarikat: perkara yang anda lakukan, untuk siapa, cara ekonomi berfungsi dan perkara yang telah anda cuba. Satu fail peraturan tingkah laku bersama struktur pengetahuan luaran. CLAUDE.md ialah indeks; otak kedua ialah arkib. Tanpa indeks, ejen tidak tahu arkib itu wujud. Tanpa arkib, ejen hanya tahu peraturan, bukan konteks perniagaan.
Inilah analogi yang saya gunakan dalam ceramah: bayangkan anda telah mengambil pekerja baharu. Apakah yang anda berikan kepadanya pada hari pertama? Manual arahan: cara berpakaian, masa tiba, nada yang digunakan dengan pelanggan, sistem yang digunakan untuk menerbitkan sesuatu. Dokumennya ringkas. Ia tidak menerangkan perkara yang anda lakukan atau sebabnya. Ia hanya menyatakan cara berkelakuan. Selain itu, berikan akses kepada wiki syarikat. Wiki menerangkan apakah produk itu, untuk siapa, siapa khalayaknya, berapakah harganya dan sebabnya, siapa pesaingnya dan kesilapan yang pernah anda lakukan. Ini arkib yang luas. Tiada sesiapa membaca semuanya - anda pergi ke sana untuk mencari jawapan kepada soalan tertentu. CLAUDE.md = manual arahan. Otak kedua = wiki. Anda memerlukan kedua-duanya. Perbezaannya mudah. Letakkan semua perkara yang **relevan untuk setiap tugasan** dalam CLAUDE.md: - Siapakah ejen dalam projek ini (pembantu, ketua, asisten) - Bahasa yang digunakan untuk menjawab - Susunan alat - Arahan penerbitan - Larangan (jangan gunakan tanda pisah panjang, jangan jalankan `git push --force`) - Penghalaan: tempat mencari konteks perniagaan dan prinsip Letakkan semua perkara yang **diperlukan apabila diminta** dalam otak kedua: - Produk, khalayak, ekonomi dan matlamat - Pesaing dan pasaran - Keputusan terdahulu dan sebabnya - Contoh dan ulasan pelanggan - Prinsip dan metodologi Anthropic membuat perbezaan yang sama dalam dokumentasinya:
CLAUDE.md dimuatkan dalam setiap sesi, jadi sertakan hanya perkara yang terpakai secara meluas. Untuk pengetahuan domain atau aliran kerja yang hanya diperlukan sekali-sekala, gunakan skills. Claude memuatkannya apabila diperlukan tanpa membebankan setiap perbualan.
— Anthropic, code.claude.com/docs/en/best-practices
Skills ialah salah satu cara menyimpan pengetahuan episodik. Folder `business/` bersama projek ialah cara lain. Saya menggunakan kedua-duanya dan akan menerangkannya dengan lebih terperinci di bawah. ## Apakah kandungan otak projek - 5 bahagian serta mesin masa
Perkara utama Otak projek terdiri daripada lima folder dengan git di atasnya. CLAUDE.md menetapkan peraturan dan laluan. `ai-clone/` menyimpan gambaran digital anda: prinsip, nada dan maklum balas selepas kesilapan. `business/` menyimpan pengetahuan tentang projek. `plans/` mengandungi pelan teknikal mengikut fasa. `retrospectives/` menyimpan renungan selepas sesi. Git menjadikan semuanya mesin masa: setahun kemudian, anda boleh membuka mana-mana fail dan melihat kandungannya ketika sesuatu keputusan dibuat.
Contoh seni bina daripada pengalaman penulis yang diterangkan: | Folder | Kandungan | Tujuan | |----|----|----| | **`CLAUDE.md`** | Peraturan projek, susunan teknologi, struktur fail, penghalaan folder, bahasa komunikasi | Ini manual arahan ejen. Dimuatkan dalam setiap sesi. Kurang daripada 200 baris, sebaik-baiknya 80-120. | | **`ai-clone/`** | Siapa saya, prinsip, nada, gaya membuat keputusan, maklum balas selepas kesilapan | Gambaran digital saya sebagai pembuat keputusan. Ia tahu perkara yang akan saya tolak serta-merta, gaya saya mencadangkan sesuatu dan peraturan yang saya pelajari daripada kesilapan. | | **`business/`** | Produk, khalayak, matlamat, ekonomi, pemasaran, keputusan terdahulu, contoh | Fail markdown yang dipautkan dengan pautan wiki. Setiap fail bersambung kepada fail lain melalui pautan `[[...]]`. Ejen pergi ke situ untuk mencari jawapan kepada soalan tertentu. | | **`plans/`** | Satu pelan untuk setiap ciri. Fail `YYYY-MM-DD-feature.md` dengan fasa dan kotak semak | Plan Mode hanya wujud dalam satu perbualan dan hilang selepas `/clear`. Folder `plans/` berada dalam repositori - mana-mana ejen boleh menyambung pelan itu pada bila-bila masa. | | **`retrospectives/`** | Renungan selepas setiap sesi: perkara yang dilakukan, perkara yang perlu diingati, perkara yang boleh diperbaik | Pembelajaran kendiri sistem. Kesilapan menjadi peraturan dalam `ai-clone/feedback/`. | | **`+ git`** | Sejarah versi semua fail | Mesin masa. Buka mana-mana fail dan jalankan `git log` untuk melihat bila dan sebab fail itu berubah. | Perkara metodologi yang utama ialah **mengasingkan `ai-clone/` dan `business/`**. `business/` menjawab soalan “apakah yang kita lakukan?” Produk, khalayak, harga, pesaing. Folder ini berkaitan projek. Jika esok anda menyerahkan projek kepada rakan kongsi, folder ini ikut bersama projek. `ai-clone/` menjawab soalan “bagaimanakah saya membuat keputusan?” Prinsip, nada, kemahiran dan kata larangan saya. Folder ini berkaitan diri saya. Jika esok saya memulakan projek baharu, folder ini ikut bersama saya. Bersama-sama, kedua-duanya membentuk apa yang saya panggil Syarikat Seorang. Seorang individu bersama konteks berstruktur dan AI yang membaca konteks itu. Mahu bukan sahaja menyediakan folder kedua, tetapi juga membina sistem yang menjadikan Claude konsisten? Itu sahaja tidak mencukupi. Tanpa `ai-clone/`, ejen menjawab bagi pihak semua orang, bukannya untuk anda. Tanpa kejuruteraan konteks, ejen merayau dalam seluruh folder dan membazirkan token. Ketiga-tiga perkara ini berguna jika digabungkan: **otak kedua + klon AI + kejuruteraan konteks**. Inilah **tiga tonggak** yang diperlukan supaya AI tidak berhalusinasi. ## Apakah yang patut dan tidak patut dimasukkan dalam business/?
Perkara utama Letakkan fakta projek yang berubah sekali seminggu atau kurang kerap dalam `business/`: kedudukan, khalayak, produk dan harga, matlamat suku tahunan serta keputusan penting. Jangan masukkan surat-menyurat sembang, bahan mentah yang belum diproses, maklumat yang telah digandakan dalam kod, tangkap layar dan nombor dinamik. Gantikan nombor dengan penanda LIVE dan pautan ke pertanyaan SQL - saya menerangkannya dalam bahagian berasingan di bawah.
Struktur peringkat teratas `business/` dalam projek penulis yang diterangkan: ``` business/ ├── INDEX.md ← peta folder, baca dahulu ├── company/ ← misi, entiti undang-undang, nilai, dasar undang-undang ├── products/ ← produk, program, harga ├── audience/ ← profil pelanggan, segmen, bantahan ├── goals/ ← matlamat tahunan, suku tahunan, bulanan, metrik ├── economics/ ← ekonomi unit, pendapatan, perbelanjaan, ramalan ├── marketing/ ← saluran, corong, bahan, pesaing ├── execution/ ← perancangan mingguan, tunggakan kerja └── assets/ ← sistem reka bentuk, ulasan, bank teks ``` Ini contoh daripada projek penulis yang diterangkan, bukannya peraturan tetap. Saya mencipta folder apabila diperlukan. Saya bermula dengan tiga (`products/`, `audience/`, `goals/`); yang lain ditambah selepas 2-3 bulan, apabila tidak jelas lagi tempat untuk meletakkan perkara baharu. Fail utama folder ini ialah `INDEX.md`. Ia sebuah peta. Fail ini mengandungi jadual “soalan → fail” yang digunakan Claude untuk menentukan tempat yang perlu dituju. Tanpanya, ejen membazirkan token dengan membaca setiap fail mengikut turutan. Contoh petikan daripada `INDEX.md`: ```markdown ### Tempat mencari maklumat | Perkara yang diperlukan | Tempat mencari | |---|---| | Siapa pelanggan kita dan masalah yang dihadapinya | `business/audience/avatar.md` | | Produk, pelan dan harga | `business/products/` | | Matlamat dan metrik | `business/goals/` | | Ekonomi (pendapatan, perbelanjaan, ekonomi unit) | `business/economics/` | | Saluran dan bahan promosi | `business/marketing/` | ``` Kemudian satu baris dalam `CLAUDE.md` sudah memadai: “Untuk soalan perniagaan, baca `business/INDEX.md` dan ikut petanya.” Ejen tidak memuatkan seluruh folder ke dalam konteks. Ejen memuatkan peta, memilih fail yang sesuai dan membaca fail itu sahaja. **Senarai semak perkara yang tidak patut diletakkan dalam `business/`:** - Surat-menyurat sembang mentah tanpa pemprosesan. Jika ada pandangan penting, rumuskan dan catatkannya. Jika tiada, jangan masukkannya. - Maklumat yang digandakan dalam kod. “Pembayaran diproses melalui CloudPayments” tidak diperlukan; ejen boleh melihatnya dalam kod. - Tangkap layar dan imej. Bahan ini membesarkan folder dan tidak dihuraikan oleh model teks tanpa langkah tambahan. - Nombor dinamik. “Hari ini terdapat 423 pembayaran untuk produk itu” akan lapuk dalam seminggu. Gunakan penanda LIVE dan pautan ke pertanyaan pangkalan data. - Maklumat sensitif atau yang meragukan. Jika repositori itu disiarkan di YouTube esok kepada 100 ribu orang yang tidak dikenali, simpan hanya perkara yang anda sanggup tunjukkan. Pekerja, ejen dan kadangkala kontraktor luaran membaca folder itu.
Amaran Jika repositori itu umum, folder `business/` juga umum. Saya menganggap otak kedua itu seolah-olah repositori tersebut mungkin menjadi umum esok, walaupun kini bersifat peribadi. Jangan sertakan nama pelanggan tanpa kebenaran, angka pendapatan bulanan atau kata laluan. Tabiat ini mengelakkan banyak tekanan.
## Mengapa perlu ada folder ai-clone yang berasingan, dan mengapa ia tidak patut dicampur dengan business?
Perkara utama `ai-clone/` menyimpan gambaran digital anda: prinsip, nada, kata larangan dan maklum balas selepas kesilapan. Setiap kesilapan ejen menjadi peraturan dalam `ai-clone/feedback/` mengikut formula “peraturan → sebab → cara menerapkannya.” Folder ini dibawa bersama anda dari satu projek ke projek lain. `business/` kekal bersama projek. Asingkan kedua-duanya: dalam projek baharu, `business/` akan baharu, tetapi prinsip dan gaya anda kekal sama.
Ideanya mudah: perniagaan tahu perkara yang kita lakukan. Klon tahu cara saya membuat keputusan. Struktur `ai-clone/` dalam projek penulis yang diterangkan: ``` ai-clone/ ├── INDEX.md ← peta folder ├── role.md ← siapa saya, latar belakang, perkara yang penting ├── identity/ ← nilai, visi, misi ├── thinking/ ← model mental daripada ceramah ├── voice/ ← nada, kosa kata, gaya ├── principles/ ← kepercayaan tentang produk, kod, perniagaan ├── feedback/ ← peraturan yang dipelajari daripada kesilapan ← folder utama ├── style/ ← kata larangan, format Telegram └── reference/ ← alat, persekitaran ``` Folder yang paling berguna ialah `feedback/`. Folder ini mengandungi peraturan khusus yang saya pelajari melalui kesilapan ejen. Setiap peraturan disimpan dalam fail berasingan menggunakan format berikut: ```markdown --- name: short-name description: one line - what’s in the file and when to apply it type: feedback --- Peraturan ringkas dalam satu ayat. **Sebab:** sebab peraturan ini wujud. Konteks, insiden, pemerhatian. **Cara menerapkannya:** keadaan khusus yang memerlukan peraturan ini. ``` Tanpa `Sebab`, peraturan itu tidak berfungsi - ejen tidak akan menggunakannya dalam situasi serupa. Tanpa `Cara menerapkannya`, tidak jelas bila peraturan itu perlu digunakan. Contoh daripada folder saya: peraturan “tanda sempang, bukan tanda pisah panjang.” Peraturan itu diwujudkan kerana tanda pisah panjang `—` ialah penanda visual utama teks yang dijana. Peraturan ini terpakai kepada semua teks untuk umum. Failnya berada di `ai-clone/feedback/no-em-dashes.md`. Saya melakukannya dengan cara yang sedikit berbeza: saya menulis peraturan dalam `ai-clone/feedback/`, bukan dalam `CLAUDE.md`. CLAUDE.md ialah fail projek, tetapi peraturan tentang nada dan gaya bersifat peribadi. Peraturan itu ikut bersama saya ke projek seterusnya. `CLAUDE.md` kekal bersama projek.
Nota Ukuran kematangan pendekatan ini ialah: berapa kali seminggu anda memberitahu ejen “bukan begitu” tentang perkara yang sama? Dalam sistem yang matang, jawapannya sifar. Setiap kesilapan menjadi peraturan dalam `feedback/`, dan ejen tidak mengulanginya pada kali seterusnya.
## Apakah itu Live Metrics, dan mengapa nombor tidak patut ditetapkan terus dalam fail?
Perkara utama Nombor dalam fail otak kedua menjadi lapuk dalam beberapa hari. “1,000 pelanggan” hari ini menjadi 1,050 esok dan 2,000 dalam sebulan. Jika anda menetapkannya terus dalam fail, sebulan kemudian ejen akan mencadangkan sesuatu berdasarkan data semalam. Penyelesaiannya ialah penanda LIVE dalam fail serta dokumen `live-metrics.md` berasingan yang mengandungi pertanyaan SQL sedia dijalankan. Apabila ejen melihat LIVE, ia pergi ke pangkalan data, mendapatkan nombor semasa dan membuat penaakulan berdasarkan data terkini.
Salah satu perangkap utama apabila mula membina otak kedua ialah mengisinya dengan nombor lapuk. Anda menulis “kita mempunyai 320 pelanggan,” dan dua minggu kemudian jumlahnya sudah 410. Anda menulis “pendapatan bulanan ialah 4.7 juta,” dan sebulan kemudian nombor itu kehilangan konteks: adakah itu sasaran, angka sebenar atau ramalan? Dalam contoh penulis, caranya begini. Dalam fail `business/products/practicum.md`, terdapat penanda dan bukannya nombor: ```markdown ## Kumpulan > **LIVE** - jalankan pertanyaan dalam `live-metrics.md`, bahagian “Jualan” > untuk melihat pembayaran semasa mengikut kumpulan. | Kumpulan | Tarikh | Membayar | |-------|------|------------| | 1 | 10-12 Mac, 2026 | LIVE | | 2 | 24-26 Mac, 2026 | LIVE | ``` Fail `live-metrics.md` yang berasingan mengandungi pertanyaan SQL sedia dijalankan serta penerangan tentang hasil yang dipulangkan: ````markdown ## Jualan (pembayaran mengikut kumpulan) ```sql SELECT c.name, COUNT(p.id) AS paid, SUM(p.amount) AS revenue FROM purchases p JOIN cohorts c ON c.id = p.cohort_id WHERE p.status = 'paid' GROUP BY c.name ORDER BY c.starts_at DESC; ``` ```` Apabila saya bertanya kepada ejen, “berapa banyak pembayaran yang kita ada untuk kumpulan kedua?”, ejen akan: 1. Membaca `business/products/practicum.md` 2. Melihat penanda LIVE di sebelah nombor 3. Membuka `live-metrics.md` 4. Mencari bahagian “Jualan” 5. Menjalankan pertanyaan terhadap pangkalan data produksi 6. Menjawab menggunakan data terkini Ini menyelesaikan dua masalah serentak. Nombor tidak lapuk. Keputusan juga dibuat berdasarkan gambaran semasa, bukannya tahun lalu.
Amaran Dalam pendekatan penulis yang diterangkan, hanya ejen dipercayai mempunyai akses kepada pangkalan data produksi. Akses itu hanya diberikan melalui pembalut yang merekodkan pertanyaan dan tidak mendedahkan kata laluan. Meletakkan arahan `psql` terus dengan kata laluan teks biasa dalam `live-metrics.md` ialah idea yang tidak baik. Buat pembalut yang mendapatkan kata laluan daripada pemboleh ubah persekitaran dan tidak mendedahkannya dalam output. Ini lapisan teknikal yang berasingan, tetapi tanpa lapisan itu LIVE menjadi kelemahan keselamatan.
## Bagaimanakah AI menavigasi otak kedua untuk satu permintaan?
Perkara utama Laluan permintaan sentiasa sama: Claude membaca CLAUDE.md, melihat peta (`business/INDEX.md`, `ai-clone/INDEX.md`), pergi ke INDEX yang berkaitan, mengikutnya ke fail tertentu dan, jika perlu, mendapatkan nombor melalui LIVE. Ini melibatkan 5-6 operasi membaca berbanding memasukkan seluruh folder ke dalam konteks. Tetingkap kekal lapang untuk penaakulan dan token tidak dibazirkan pada fail yang tidak berkaitan.
Permintaan khusus, contohnya: “draf e-mel kepada peserta tentang kumpulan baharu.” 1. Claude bermula dengan tetingkap kosong. Claude memuatkan CLAUDE.md (peraturan, susunan teknologi, penghalaan). 2. Daripada penghalaan dalam CLAUDE.md, Claude melihat: “`ai-clone/INDEX.md` - sentiasa baca pada permulaan sesi.” Claude membuka fail itu dan mengetahui siapa saya, nada yang saya gunakan serta kata larangan saya. 3. Claude melihat dalam penghalaan: “templat e-mel - `src/lib/email/layout.ts`.” Claude membuka fail itu dan memahami formatnya. 4. Claude melihat: “konteks produk - `business/products/practicum.md`.” Claude membuka fail itu dan membaca tentang produk. 5. Claude melihat penanda LIVE dalam fail serta rujukan kepada `live-metrics.md`. Claude membuka fail itu dan mencari SQL sedia dijalankan. Jika nombor semasa diperlukan, Claude menjalankan pertanyaan. Jika tidak, Claude menandakan “dapatkan nombor ini pada waktu penghantaran.” 6. Claude melihat peraturan nada dalam `ai-clone/style/telegram-format.md`, larangan tanda pisah panjang dalam `ai-clone/feedback/no-em-dashes.md` dan kadar penukaran corong dalam `business/marketing/funnel.md`. Claude menulis e-mel mengikut nada saya, dengan nombor terkini dan tanpa tanda pisah panjang atau penanda AI. Anthropic menyebut pendekatan ini konteks tepat pada masanya dalam blog kejuruteraannya:
Ejen yang dibina menggunakan pendekatan 'tepat pada masanya' mengekalkan pengecam ringan (laluan fail, pertanyaan tersimpan, pautan dan sebagainya) serta menggunakan pautan ini untuk menarik data secara dinamik ke dalam konteks pada waktu jalan menggunakan alat.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
Dengan kata lain, Claude membawa penunjuk kepada data, bukannya data itu sendiri. Kaedah ini jauh lebih cekap dari segi token dan lebih tepat, kerana hanya maklumat yang berkaitan dimasukkan ke dalam konteks. Tetingkap kekal lapang untuk penaakulan. ## 5 corak anti otak kedua - apakah yang perlu dielakkan?
Perkara utama Kesilapan utama yang dilakukan pemula dengan otak kedua: 1) CLAUDE.md membesar hingga 500+ baris, bukannya menjadi penghala ringkas; 2) folder simpanan serba guna bertukar menjadi tempat pembuangan; 3) menggandakan perkara yang sudah diketahui Claude daripada bahasa atau kod; 4) menetapkan nombor yang menjadi lapuk tanpa LIVE; 5) membiarkan konteks tidak boleh dicapai ejen atau gagal menghalakannya, sama ada dalam repositori sama atau stor peribadi berasingan.
Corak anti 1. **CLAUDE.md yang terlalu panjang.** 500 baris arahan “bukannya meletakkan semuanya di satu tempat.” Anthropic menyatakannya dengan jelas:
Pastikan ia ringkas. Bagi setiap baris, tanya: 'Jika saya membuangnya, adakah Claude akan mula membuat kesilapan?' Jika tidak, padamkannya. Fail CLAUDE.md yang terlalu sarat menyebabkan Claude mengabaikan arahan sebenar anda!
— Anthropic, code.claude.com/docs/en/best-practices
Sasarkan 80-120 baris. Letakkan semua yang lain dalam fail berasingan dan arahkan ejen kepadanya. Corak anti 2. **Folder serba guna.** Anda mencampakkan semuanya ke dalam otak kedua: surat-menyurat sembang mentah, tangkap layar yang tidak berguna, laporan yang tidak akan dibaca sesiapa. Sebulan kemudian, folder itu membengkak, ejen membazirkan token membaca sampah dan anda tidak ingat tempat sesuatu disimpan. Peraturannya: setiap fail dalam otak kedua mesti menjawab soalan tertentu. Jika tiada sesiapa membukanya dalam enam bulan, padamkannya atau pindahkan ke arkib. Corak anti 3. **Penduaan.** “Pembayaran diproses melalui CloudPayments, dalam `src/lib/payment/cloudpayments.ts`; penyedia dikonfigurasi dalam `.env`.” Ejen dapat melihat semuanya dalam kod. Jangan gandakannya dalam `business/`. Pendua menjadi lapuk: kod berubah, `business/` tidak dikemas kini dan ejen bekerja berdasarkan maklumat lama. Corak anti 4. **Nombor yang ditetapkan terus.** “Kita mempunyai 1,247 pelanggan, dengan kadar penukaran 6.3%” - bayangkan ini angka daripada syarikat pemula fintech abstrak. Semua nombor begini akan lapuk dalam seminggu. Gunakan penanda LIVE dan `live-metrics.md`. Bahagian tentang perkara ini ada di atas. Corak anti 5. **Konteks tanpa laluan boleh dicapai.** Jika otak kedua berada di lokasi lain dan ejen tiada kebenaran atau rujukan kepadanya, bermula dalam folder kod tidak mencukupi. Untuk nota bersama tidak sensitif, menyimpan `business/` dan `ai-clone/` dalam repositori ialah susun atur mudah. Untuk konteks peribadi, simpan di lokasi dengan kawalan berasingan serta konfigurasikan akses dibenarkan dan penghalaan secara jelas. Kemudahan folder tidak mengatasi kerahsiaan.
Petua Cabang berasingan (`context` atau `business-context`) menyusun kerja tetapi bukan sempadan akses: failnya masih objek Git dalam repositori sama dan boleh diterbitkan bersama cabang atau sejarah. Untuk konteks perniagaan peribadi, gunakan repositori peribadi berasingan atau stor luaran dengan kawalan akses jelas serta penghalaan ejen dibenarkan. Submodul boleh merujuk repositori peribadi berasingan, tetapi privasinya datang daripada kebenaran repositori itu, bukan submodul sendiri. Pilihan lain ialah folder setempat yang sengaja diabaikan dengan sandaran sendiri; mengabaikan laluan tidak membuang fail yang sudah dijejaki Git atau sejarah pernah diterbitkan. Kekalkan hanya konteks boleh dikongsi bersama kod.
## Cara membina otak kedua dalam masa sejam - panduan langkah demi langkah
Perkara utama Anda boleh menyediakan otak kedua minimum dalam masa sejam: cipta folder akar `business/` dan `ai-clone/`, buat peta `INDEX.md` dalam setiap folder, tambah penerangan ringkas produk di bawah `business/products/`, penerangan pelanggan di bawah `audience/` dan penerangan tentang diri anda dalam `ai-clone/role.md`. Tambah penghalaan ke folder ini dalam `CLAUDE.md`. Kemudian kembangkan sambil bekerja: selepas setiap kesilapan ejen, tambah peraturan dalam `ai-clone/feedback/`; selepas setiap keputusan, tambah nota dalam `business/`.
1. ### Cipta dua folder akar Di akar projek, bersama `src/`: ```bash mkdir -p business/{products,audience,goals,economics,marketing} mkdir -p ai-clone/{identity,voice,principles,feedback,style} ``` 2. ### Buat INDEX.md sebagai peta folder `business/INDEX.md` ialah jadual “soalan → fail”. Mulakan dengan sekurang-kurangnya 5 baris dan tambah lagi sambil anda bekerja. Buat perkara yang sama dalam `ai-clone/INDEX.md`. 3. ### Tambah penerangan ringkas tentang produk dan pelanggan `business/products/main.md` - apakah produk itu, untuk siapa, berapa harganya dan apakah kelainannya. 30-50 baris. `business/audience/avatar.md` - siapa pelanggan itu, masalah yang dihadapinya dan perkara yang dibelinya. 30-50 baris. Jangan huraikan pelanggan ideal - huraikan pelanggan sebenar. Jika anda tidak tahu sesuatu, tandakannya “perlu dijelaskan” dan teruskan. 4. ### Huraikan diri anda dalam ai-clone/role.md Siapa anda, perkara yang anda lakukan dan perkara yang penting bagi anda. 20-30 baris. Itu sudah mencukupi untuk bermula. Tambah nada, prinsip dan kata larangan apabila anda melihat ejen menulis dengan gaya yang bukan gaya anda. 5. ### Tambah penghalaan ke CLAUDE.md Buka `CLAUDE.md` dan tambah bahagian: ```markdown ## Peta projek - Konteks perniagaan → `business/INDEX.md` - Konteks tentang saya → `ai-clone/INDEX.md` - Pelan teknikal → `plans/YYYY-MM-DD-*.md` - Renungan sesi terdahulu → `retrospectives/` Sentiasa baca `ai-clone/INDEX.md` dan `business/INDEX.md` pada permulaan sesi. ``` 6. ### Mulakan Claude Code dan semak Buka ejen. Tanya: “ceritakan tentang produk dan khalayak saya.” Jika jawapannya berdasarkan konteks folder, semuanya berfungsi. Jika ejen mereka-reka sesuatu, periksa bahawa folder itu berada bersama projek, nama fail betul dan penghalaan dalam `CLAUDE.md` ditulis dengan tepat. Selepas itu, otak kedua berkembang mengikut dua prinsip. Pertama: setiap kali ejen membuat kesilapan, tambah satu peraturan. Selepas 3-4 minggu, `ai-clone/feedback/` akan mengandungi 15-20 fail peraturan dan ejen akan berhenti mengulangi kebanyakan kesilapan lazim. Kedua: setiap kali anda membuat keputusan perniagaan, catatkannya dalam `business/`. Jika anda menaikkan harga, tambah nota ke `business/products/pricing.md` berserta tarikh dan sebab. Jika anda mengubah kedudukan, tambah nota ke `business/company/about.md`. Enam bulan kemudian, anda akan mempunyai arkib yang mengingati “sebabnya”.
Arahan: Arahan sedia guna untuk mengemas kini otak kedua pada waktu petang ``` Kita telah melakukan banyak kerja bersama minggu ini. Analisis semua perubahan kod daripada minggu ini, semua komit yang kita buat. Apakah maklumat bernilai daripada kerja ini yang patut disimpan dalam business/? Catatkannya dalam fail yang sesuai berserta pautan wiki ke fail bersebelahan supaya konteks tidak hilang. Jika terdapat keputusan dalam kod yang belum saya jelaskan, tanya saya sebabnya kemudian catat sebab itu dalam fail yang sesuai dengan tarikhnya. Jangan gandakan perkara yang sudah jelas daripada kod. Sertakan hanya perkara yang mungkin tidak diketahui ejen dalam sesi seterusnya tanpa business/. ```
## Langkah seterusnya - Skills, Subagents dan kejuruteraan konteks
Perkara utama Otak kedua bersama CLAUDE.md ialah asasnya. Tambahkan Skills (pengetahuan prosedur yang dimuatkan apabila diperlukan berdasarkan penerangan tugasan), Subagents (instans Claude terpencil dengan tetingkap konteks sendiri untuk tugasan berat) dan kejuruteraan konteks (pengurusan perkara yang dimasukkan ke dalam tetingkap). Inilah tiga tingkat di atasnya. Semuanya tidak berfungsi tanpa asas - ejen tiada apa-apa untuk dibaca.
Setelah otak kedua tersedia, terdapat tiga lagi alat yang diterangkan Anthropic sebagai tiga peringkat pengoptimuman konteks. **Skills** ialah pengetahuan prosedur. Jika anda mempunyai aliran kerja yang diulang (menulis panduan pembelajaran, menyediakan hantaran Telegram, mengaudit laman web), anda boleh mengekodkannya dalam fail `SKILL.md` bersama penerangan tugasan. Pada permulaan sesi, Claude mengimbas nama dan penerangan skill, kemudian memuatkan hanya skill yang sesuai dengan tugasan semasa. Ini menjimatkan token dan mengekalkan fokus. **Subagents** ialah instans Claude terpencil dengan tetingkap konteks sendiri. Mulakan subagent untuk tugasan yang mencabar (baca 30 fail dan sediakan ringkasan), lalu ia bekerja dalam tetingkap sendiri dan hanya memulangkan hasilnya. Tetingkap utama anda kekal lapang. Anthropic menulis:
Sub-ejen khusus boleh menyelesaikan tugasan tertumpu dalam tetingkap konteks yang bersih. [...] Setiap subagent boleh meneroka secara meluas, menggunakan puluhan ribu token atau lebih, tetapi hanya memulangkan ringkasan kerja yang dipadatkan dan dirumuskan (biasanya 1,000-2,000 token).
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
**Kejuruteraan konteks** ialah pengurusan perkara yang dimasukkan ke dalam tetingkap. Anthropic menyebutnya kemahiran asas untuk bekerja dengan ejen pada 2025, satu peringkat di atas kejuruteraan prompt. Kejuruteraan prompt ialah pemilihan kata-kata. Kejuruteraan konteks ialah pemilihan fail, laluan, skills dan subagents. Otak kedua ialah blok binaan pertama kejuruteraan konteks. Tanpanya, Skills membaca ruang kosong, Subagents tiada tempat untuk dituju dan tetingkap ejen dipenuhi maklumat rawak. Dengan otak kedua, ketiga-tiga alat mula berfungsi. **Langkah seterusnya.** Cipta dua folder bersama projek: `business/` dan `ai-clone/`. Tambah `INDEX.md` pada setiap folder dengan 5 baris sebagai peta. Tambah empat baris penghalaan ke `CLAUDE.md`. Dalam masa sejam, anda akan mempunyai rangka kerja otak kedua yang berfungsi. Kemudian kembangkannya dengan peraturan “selepas setiap kesilapan ejen, tambah satu baris dalam `ai-clone/feedback/`.” Saya menerangkan templat CLAUDE.md penuh yang akan digunakan untuk menghala kepada otak kedua dalam panduan [Cara menyediakan CLAUDE.md dengan betul](https://ailoot.ai/blog/ms/claude-md-template/).
### Sumber - [Dokumentasi Memori Claude Code](https://code.claude.com/docs/en/memory) - hierarki memori rasmi Claude Code daripada Anthropic - [Amalan terbaik Claude Code](https://code.claude.com/docs/en/best-practices) - panduan rasmi untuk bekerja dengan CLAUDE.md - [Kejuruteraan konteks yang berkesan untuk ejen AI](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents) - Anthropic Engineering, penerangan tentang pereputan konteks, bajet perhatian dan konteks tepat pada masanya - [Penerangan tentang Skills](https://claude.com/blog/skills-explained) - blog Anthropic: perbezaan antara Skills, Memori, Subagents dan MCP
Teruskan meneroka Ailoot di [ailoot.ai](https://ailoot.ai/). ## Soalan lazim: Otak Kedua dalam Claude Code: Cara Membina Strukturnya dalam Masa Sejam ### Adakah meletakkan konteks perniagaan pada cabang Git lain memastikan ia peribadi? Tidak. Cabang sebahagian repositori yang sama dan failnya boleh dikongsi bersama objek serta sejarah repositori. Gunakan stor peribadi dengan kawalan berasingan, atau folder setempat yang sengaja diabaikan bersama sandaran; mengabaikan laluan tidak memadam sejarah yang sudah dijejaki. ### Bagaimanakah ejen mencari konteks peribadi di luar repositori kod? Berikan rujukan jelas dan hanya kebenaran akses yang diperlukan tugasan. Kekalkan indeks ringkas yang menghala kepada dokumen relevan, serta sahkan ejen boleh membaca fail dibenarkan; lokasi peribadi tanpa penghalaan tidak membekalkan konteks secara automatik. ## Ailoot · Syarikat dan portfolio projeknya Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan. Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan. Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.