Blog

Otak Kedua dalam Claude Code: Cara Membina Strukturnya dalam Masa Sejam

Markdown

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.

Baca artikel penuh

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

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 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/<project>/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: 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:

PeringkatLokasiTujuan
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.mdPeraturan peribadi yang terpakai merentas semua projek. “Jawab dalam bahasa pilihan saya,” “jangan gunakan tanda pisah panjang.”
Project./CLAUDE.md di akar projekPeraturan untuk projek tertentu: susunan teknologi, struktur folder, peraturan perniagaan. Disimpan dalam git.
Local./CLAUDE.local.mdNota 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/<project-name>/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:

FolderKandunganTujuan
CLAUDE.mdPeraturan projek, susunan teknologi, struktur fail, penghalaan folder, bahasa komunikasiIni 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 kesilapanGambaran 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, contohFail 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 semakPlan 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 diperbaikPembelajaran kendiri sistem. Kesilapan menjadi peraturan dalam ai-clone/feedback/.
+ gitSejarah versi semua failMesin 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:

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

---
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:

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

## 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/:

    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:

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

Sumber

Teruskan meneroka Ailoot di ailoot.ai.

Butiran lanjut

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.

Semua artikel