Blog

Otak Kedua di Claude Code: Cara Membangun Strukturnya dalam Satu Jam

Markdown

Cara membangun otak kedua untuk Claude Code: hierarki memori, struktur folder lima bagian, dan git agar agen mengingat semua hal tentang proyek Anda di antara sesi.

Baca artikel lengkap

Poin utama

Otak kedua Claude Code bukan satu file, melainkan struktur lima folder ditambah git. CLAUDE.md menetapkan aturan dan rute, business/ menyimpan pengetahuan tentang proyek, ai-clone/ menyimpan informasi tentang Anda sebagai pengambil keputusan, plans/ berisi rencana teknis, dan retrospectives/ berisi pelajaran dari sesi sebelumnya. Agen memulai dengan CLAUDE.md dan mengikuti tautan ke folder yang tepat untuk permintaan tertentu. Artikel ini membahas hierarki memori dalam dokumentasi resmi Claude Code, struktur lima bagian, dan cara membangunnya langkah demi langkah dalam satu jam.

Dokumentasi referensi Ailoot: ailoot.ai/docs/.

Mengapa Claude Code membutuhkan otak kedua, dan apa yang penting?

Poin utama

Satu file CLAUDE.md mencakup aturan dasar, tetapi tidak dapat menangani memori bisnis. Setelah sebulan, Anda lupa mengapa harga dinaikkan. Setelah tiga bulan, Anda lupa mengapa pembayaran cicilan ditolak. Pengetahuan berada di empat tempat sekaligus: kepala Anda, obrolan Telegram, dokumen Google, dan kepala karyawan. Otak kedua mengumpulkan semuanya ke dalam satu folder berisi file markdown di samping proyek, dan Claude dapat membuka folder itu sendiri.

Anda membuka Claude Code pada hari Selasa. Anda menjelaskan: ini proyeknya, ini audiensnya, jangan lakukan ini. Anda bekerja bersama. Pada hari Kamis, ada obrolan baru, dan Anda harus menjelaskan semuanya lagi.

Jika Anda memiliki CLAUDE.md, Anda sudah mengatasi frustrasi tahap pertama. Aturan dasar dan deskripsi proyek berada dalam satu file dan dimuat ke setiap sesi. Saya menjelaskan cara kerja file ini dalam panduan CLAUDE.md saya - Anda dapat membacanya terlebih dahulu untuk menyiapkan fondasinya.

Namun, CLAUDE.md adalah buku petunjuk bagi karyawan baru. Cara berpakaian, nada bicara dengan klien, perintah yang digunakan untuk publikasi. Itu tidak cukup untuk mengambil keputusan yang baik tentang proyek. Keputusan membutuhkan pengetahuan: apa produknya, siapa audiensnya, bagaimana ekonominya berjalan, apa yang sudah Anda coba dan apa yang tidak berhasil.

Dalam pengalaman penulis yang diceritakan di sini, pengetahuan itu dahulu berada di empat tempat: kepala mereka, obrolan Telegram, dokumen Google, dan kepala karyawan. Sebulan setelah suatu keputusan dibuat, tak seorang pun ingat alasannya. Orang baru akan menghabiskan satu jam untuk bertanya kepada tim agar memahami pekerjaan. Claude sama sekali tidak memiliki konteks itu.

Sebelum memiliki otak kedua, menurut pengalaman penulis yang diceritakan, setiap sesi berarti menjelaskan lagi siapa kliennya, bagaimana penawaran disusun, dan penyedia mana yang menangani pembayaran. Dengan business/, saya membuka obrolan dan berkata, “perbarui penawaran untuk paket harga baru” - Claude sendiri membuka business/company/legal.md, membaca persyaratannya, lalu membuka business/products/pricing.md, melihat paket harga baru, dan menyarankan perubahan dalam satu kali pengerjaan. Pemanasan tidak lagi diperlukan; konteks dimuat secara otomatis.

Catatan

Ini bukan masalah memori Claude. Ini masalah arsitektur. Jendela konteks agen adalah memori kerjanya. Agen hanya memuat hal-hal yang secara eksplisit Anda tunjukkan. Semua yang lain berada di luar jendela dan dimuat sesuai kebutuhan. Otak kedua menyimpan “semua yang lain” itu dengan cara terstruktur agar Claude dapat menemukan jalannya.

Anthropic menyebut masalah ini context rot dalam blog rekayasanya:

Semakin banyak token di jendela konteks, semakin buruk kemampuan model mengingat informasi dari konteks tersebut secara akurat.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Dengan kata lain, semakin banyak yang Anda masukkan ke jendela, semakin buruk agen menangani detail spesifik. Solusinya adalah memelihara struktur file eksternal yang dapat dibuka Claude sendiri sebagai respons terhadap permintaan tertentu. Itulah otak kedua.

Apa itu otak kedua, dan bagaimana penerapannya pada Claude?

Poin utama

Idenya sederhana: pikiran Anda digunakan untuk berpikir, bukan untuk menyimpan pikiran. Untuk Claude Code, otak kedua bergeser dari metode produktivitas menjadi arsitektur agen: folder catatan eksternal yang dapat diakses agen secara langsung melalui sistem file.

Biasanya, otak kedua berkaitan dengan produktivitas secara umum: orang membuat vault Obsidian dan menambahkan kutipan dari buku, catatan dari panggilan, serta ide proyek.

Ketika penulis menerapkan gagasan ini pada pekerjaan dengan Claude Code, fokusnya bergeser dari produktivitas menjadi arsitektur agen.

Dalam pendekatan klasik, otak kedua adalah milik Anda dan Anda mengaksesnya secara manual. Saat bekerja dengan Claude Code, otak kedua menjadi dua arah: Anda dan agen sama-sama mengaksesnya. Hal itu mengubah persyaratan formatnya.

Karena agen mengaksesnya sendiri, file harus dalam format yang dipahaminya tanpa integrasi terpisah. Markdown ideal: teks, hierarki judul, dan tautan antarfail. Notion dan Google Docs tidak cocok. Anda dapat menghubungkannya melalui MCP, tetapi itu menambahkan lapisan lain, satu token lagi untuk setiap permintaan, dan satu titik kegagalan lagi.

Karena file berada di sistem file bersama proyek, file tersebut otomatis dapat dijangkau Claude Code. Tidak perlu penyiapan. Mulai agen di folder proyek dan agen dapat melihat semua file di dalamnya. Gratis dan langsung berfungsi.

Tips

Anda dapat menyimpan otak kedua di Obsidian - saya juga membukanya di sana agar lebih mudah melihat grafik koneksi. Namun, file itu sendiri berada di folder biasa bersama kode. Obsidian hanyalah pembungkus yang bagus untuk file markdown. Claude dapat melihatnya tanpa Obsidian. Anda dapat menggunakan editor apa pun; yang penting file tersimpan di disk, bukan di layanan cloud dengan formatnya sendiri.

Hierarki memori apa yang tersedia di Claude Code?

Poin utama

Claude Code dapat membaca empat tingkat CLAUDE.md secara bawaan (enterprise, user, project, dan local), dan sejak versi 2.1.59 Claude memiliki auto memory sendiri di ~/.claude/projects/<project>/memory/. Itu cukup untuk memori dasar, tetapi bukan konteks bisnis - tempatkan konteks tersebut di folder terpisah bersama proyek.

Sebelum menambahkan sesuatu sendiri, mari kita lihat apa yang dapat diingat Claude tanpa bantuan Anda. Anthropic menjelaskan dua mekanisme dalam dokumentasi resminya: CLAUDE.md (aturan yang Anda tulis) dan auto memory (pelajaran yang ditulis Claude sendiri). Keduanya dimuat pada awal setiap sesi.

CLAUDE.md dicari di empat tempat sekaligus:

TingkatLokasiTujuan
Enterprise/Library/Application Support/ClaudeCode/CLAUDE.md (macOS), /etc/claude-code/CLAUDE.md (Linux), C:\Program Files\ClaudeCode\CLAUDE.md (Windows)Aturan yang diterapkan admin untuk seluruh tim melalui MDM. Individu tidak memerlukan ini.
User~/.claude/CLAUDE.mdAturan pribadi yang berlaku di semua proyek. “Jawab dalam bahasa pilihan saya,” “jangan gunakan em dash.”
Project./CLAUDE.md di akar proyekAturan untuk proyek tertentu: stack, struktur folder, aturan bisnis. Di-commit ke git.
Local./CLAUDE.local.mdCatatan pribadi Anda untuk proyek ini, yang tidak di-commit ke git. Ada di .gitignore.

Keempat file dimuat ke dalam konteks. Semakin spesifik tingkatnya, semakin tinggi prioritasnya. File local dibaca terakhir, sehingga aturannya mengesampingkan semua yang lain.

File CLAUDE.md juga dapat berada di folder mana pun di dalam proyek. Saat Claude membaca file dari subfolder, Claude memuat CLAUDE.md subfolder itu sesuai kebutuhan. Ini berguna dalam monorepo: aturan frontend berada di frontend/CLAUDE.md, aturan backend berada di backend/CLAUDE.md, dan aturan itu hanya dimuat saat agen bekerja pada bagian terkait.

Auto memory muncul di Claude Code 2.1.59. Ini adalah file yang ditulis Claude tentang Anda:

~/.claude/projects/<project-name>/memory/
├── MEMORY.md          # Indeks, dimuat di setiap sesi (200 baris atau 25KB)
├── debugging.md       # Catatan terperinci (dimuat sesuai kebutuhan)
├── api-conventions.md
└── ...

Anthropic menjelaskannya seperti ini dalam dokumentasi resmi:

Claude tidak menyimpan sesuatu di setiap sesi. Claude memutuskan apa yang layak diingat berdasarkan apakah informasi itu mungkin berguna dalam percakapan mendatang.
— Anthropic, code.claude.com/docs/en/memory

Auto memory diaktifkan dengan flag autoMemoryEnabled di ~/.claude/settings.json. Claude memutuskan apa yang akan ditulis di sana. Anda dapat membaca MEMORY.md dan mengeditnya secara manual - isinya markdown biasa.

Peringatan

Auto memory berguna, tetapi bukan pengganti otak kedua. Claude menulis kesimpulan taktis tentang alat dan pola kode di sana. “Skrip ini gagal tanpa flag X,” “nama tabel basis data ini adalah ini.” Claude tidak menulis strategi bisnis di sana. Jika Anda ingin agen mengingat siapa audiens Anda dan mengapa Anda memilih harga tertentu, Anda perlu menaruhnya sendiri di folder konteks terpisah.

CLAUDE.md atau otak kedua - di mana batasnya?

Poin utama

CLAUDE.md adalah buku petunjuk bagi karyawan baru: cara bertindak, perintah yang digunakan, dan hal yang tidak boleh dilakukan. Otak kedua adalah wiki perusahaan: apa yang Anda lakukan, untuk siapa, bagaimana ekonominya berjalan, dan apa yang pernah dicoba. Satu file aturan perilaku ditambah struktur pengetahuan eksternal. CLAUDE.md adalah indeks; otak kedua adalah arsip. Tanpa indeks, agen tidak tahu arsip itu ada. Tanpa arsip, agen hanya mengetahui aturan, bukan konteks bisnis.

Berikut analogi yang saya gunakan dalam ceramah: bayangkan Anda merekrut karyawan baru. Apa yang Anda berikan pada hari pertamanya?

Buku petunjuk: cara berpakaian, kapan datang, nada bicara dengan klien, sistem yang digunakan untuk publikasi. Dokumen ini singkat. Isinya tidak menjelaskan apa yang Anda lakukan atau alasannya. Dokumen itu hanya menjelaskan cara bertindak.

Lalu, secara terpisah, akses ke wiki perusahaan. Wiki itu menjelaskan apa produknya, untuk siapa, siapa audiensnya, berapa harganya dan mengapa, siapa pesaingnya, serta kesalahan apa yang pernah dibuat. Ini arsip yang luas. Tak seorang pun membaca semuanya - Anda membuka bagian yang diperlukan untuk pertanyaan tertentu.

CLAUDE.md = buku petunjuk. Otak kedua = wiki. Anda membutuhkan keduanya.

Perbedaannya sederhana. Taruh semua yang relevan untuk setiap tugas di CLAUDE.md:

  • Siapa agen dalam proyek ini (pembantu, pemimpin, asisten)
  • Bahasa untuk menjawab
  • Stack alat
  • Perintah publikasi
  • Larangan (jangan gunakan em dash, jangan jalankan git push --force)
  • Rute: tempat mencari konteks bisnis dan prinsip

Taruh semua yang hanya dibutuhkan sesuai permintaan di otak kedua:

  • Produk, audiens, ekonomi, dan tujuan
  • Pesaing dan pasar
  • Keputusan terdahulu dan alasannya
  • Contoh klien dan ulasan
  • Prinsip dan metodologi

Anthropic membuat pembedaan yang sama dalam dokumentasinya:

CLAUDE.md dimuat di setiap sesi, jadi sertakan hanya hal-hal yang berlaku secara luas. Untuk pengetahuan domain atau alur kerja yang hanya kadang diperlukan, gunakan skills. Claude memuatnya sesuai kebutuhan tanpa membebani setiap percakapan.
— Anthropic, code.claude.com/docs/en/best-practices

Skills adalah salah satu cara menyimpan pengetahuan episodik. Folder business/ bersama proyek adalah cara lainnya. Saya menggunakan keduanya dan akan menjelaskannya lebih terperinci di bawah.

Apa saja bagian otak proyek - 5 bagian ditambah mesin waktu

Poin utama

Otak proyek terdiri dari lima folder dengan git di atasnya. CLAUDE.md menetapkan aturan dan rute. ai-clone/ menyimpan proyeksi digital Anda: prinsip, nada, dan umpan balik setelah kesalahan. business/ menyimpan pengetahuan tentang proyek. plans/ berisi rencana teknis per tahap. retrospectives/ berisi refleksi setelah sesi. Git mengubah semuanya menjadi mesin waktu: setahun kemudian, Anda dapat membuka file apa pun dan melihat isinya saat suatu keputusan dibuat.

Contoh arsitektur dari pengalaman penulis yang diceritakan:

FolderIsinyaTujuan
CLAUDE.mdAturan proyek, stack, struktur file, rute folder, bahasa komunikasiIni buku petunjuk agen. Dimuat di setiap sesi. Di bawah 200 baris, idealnya 80-120.
ai-clone/Siapa saya, prinsip saya, nada saya, gaya pengambilan keputusan saya, umpan balik setelah kesalahanProyeksi digital saya sebagai pengambil keputusan. Ia tahu apa yang akan langsung saya tolak, gaya penyampaian saran saya, dan aturan yang saya pelajari dari kesalahan.
business/Produk, audiens, tujuan, ekonomi, pemasaran, keputusan terdahulu, contohFile markdown yang saling ditautkan dengan wiki link. Setiap file terhubung ke file lain melalui tautan [[...]]. Agen membukanya untuk pertanyaan tertentu.
plans/Satu rencana untuk setiap fitur. File YYYY-MM-DD-feature.md dengan tahap dan kotak centangPlan Mode hanya ada dalam satu percakapan dan hilang setelah /clear. Folder plans/ berada di repositori - agen mana pun dapat melanjutkan rencana kapan saja.
retrospectives/Refleksi setelah setiap sesi: apa yang dilakukan, apa yang perlu diingat, apa yang bisa diperbaikiPembelajaran mandiri sistem. Kesalahan menjadi aturan di ai-clone/feedback/.
+ gitRiwayat versi semua fileMesin waktu. Buka file apa pun dan jalankan git log untuk melihat kapan dan mengapa file itu berubah.

Hal metodologis yang utama adalah memisahkan ai-clone/ dan business/.

business/ menjawab pertanyaan “apa yang kita lakukan?” Produk, audiens, harga, pesaing. Isinya tentang proyek. Jika besok Anda menyerahkan proyek kepada rekan, folder ini ikut diserahkan.

ai-clone/ menjawab pertanyaan “bagaimana saya mengambil keputusan?” Prinsip, nada, keterampilan, dan kata-kata yang harus dihindari. Isinya tentang saya. Jika besok saya memulai proyek baru, folder ini ikut bersama saya.

Apa yang sebaiknya masuk ke business/, dan apa yang tidak?

Poin utama

Masukkan fakta proyek yang berubah paling sering sekali seminggu ke business/: positioning, audiens, produk dan harga, sasaran triwulanan, serta keputusan utama. Jangan masukkan korespondensi obrolan, bahan mentah yang belum diproses, informasi yang sudah ada di kode, tangkapan layar, dan angka dinamis. Ganti angka dengan penanda LIVE dan tautan ke kueri SQL - penjelasannya ada di bagian terpisah di bawah.

Struktur tingkat teratas business/ dalam proyek penulis yang diceritakan:

business/
├── INDEX.md              ← peta folder, baca dahulu
├── company/              ← misi, badan hukum, nilai, kebijakan hukum
├── products/             ← produk, program, harga
├── audience/             ← profil klien, segmen, keberatan
├── goals/                ← sasaran tahunan, triwulanan, bulanan, metrik
├── economics/            ← ekonomi unit, pendapatan, pengeluaran, proyeksi
├── marketing/             ← kanal, corong, materi, pesaing
├── execution/            ← perencanaan mingguan, backlog
└── assets/               ← sistem desain, ulasan, bank teks

Ini adalah contoh dari proyek penulis yang diceritakan, bukan aturan baku. Saya membuat folder sesuai kebutuhan. Saya mulai dengan tiga (products/, audience/, goals/); yang lainnya ditambahkan setelah 2-3 bulan, ketika mulai tidak jelas harus menaruh hal baru di mana.

File utama folder ini adalah INDEX.md. Isinya sebuah peta. File ini memiliki tabel “pertanyaan → file” yang digunakan Claude untuk memahami ke mana harus pergi. Tanpanya, agen menghabiskan token dengan membaca setiap file satu demi satu.

Contoh cuplikan dari INDEX.md:

### Tempat menemukan sesuatu

| Yang Anda perlukan | Tempat mencari |
|---|---|
| Siapa klien kita dan apa masalah mereka | `business/audience/avatar.md` |
| Produk, paket, dan harga | `business/products/` |
| Sasaran dan metrik | `business/goals/` |
| Ekonomi (pendapatan, pengeluaran, ekonomi unit) | `business/economics/` |
| Kanal dan materi promosi | `business/marketing/` |

Satu baris di CLAUDE.md sudah cukup: “Untuk pertanyaan bisnis, baca business/INDEX.md dan ikuti petanya.” Agen tidak memuat seluruh folder ke dalam konteks. Agen memuat petanya, memilih file yang tepat, dan hanya membaca file tersebut.

Daftar periksa hal-hal yang tidak boleh dimasukkan ke business/:

  • Korespondensi obrolan mentah tanpa pemrosesan. Jika ada wawasan, uraikan dan tuliskan. Jika tidak ada, jangan sertakan.
  • Informasi yang sudah ada di kode. “Pembayaran diproses melalui CloudPayments” tidak diperlukan; agen dapat melihatnya di kode.
  • Tangkapan layar dan gambar. Keduanya memperbesar ukuran folder dan tidak diuraikan model teks tanpa langkah tambahan.
  • Angka dinamis. “Hari ini ada 423 pembayaran untuk produk ini” akan kedaluwarsa dalam seminggu. Gunakan penanda LIVE dan tautan ke kueri basis data.
  • Informasi sensitif atau meragukan. Jika repositori besok diunggah ke YouTube di hadapan 100 ribu orang asing, simpan hanya hal-hal yang bersedia Anda perlihatkan. Karyawan, agen, dan kadang kontraktor eksternal membaca folder ini.

Peringatan

Jika repositori bersifat publik, folder business/ juga publik. Saya memperlakukan otak kedua seolah-olah repositori dapat menjadi publik besok, meskipun sekarang privat. Jangan cantumkan nama klien tanpa persetujuan, angka pendapatan bulanan, atau kata sandi. Kebiasaan ini mengurangi banyak stres.

Mengapa memiliki folder ai-clone terpisah, dan mengapa tidak mencampurnya dengan business?

Poin utama

ai-clone/ menyimpan proyeksi digital Anda: prinsip, nada, kata-kata yang harus dihindari, dan umpan balik setelah kesalahan. Setiap kesalahan agen menjadi aturan di ai-clone/feedback/ dengan rumus “aturan → alasan → cara menerapkan.” Folder ini ikut bersama Anda dari satu proyek ke proyek lain. business/ tetap bersama proyek. Pisahkan keduanya: di proyek baru, business/ akan berbeda, tetapi prinsip dan gaya Anda tetap sama.

Idenya sederhana: bisnis tahu apa yang kita lakukan. Clone tahu bagaimana saya mengambil keputusan.

Struktur ai-clone/ dalam proyek penulis yang diceritakan:

ai-clone/
├── INDEX.md           ← peta folder
├── role.md            ← siapa saya, latar belakang, hal yang penting
├── identity/          ← nilai, visi, misi
├── thinking/          ← model mental dari ceramah
├── voice/             ← nada, kosakata, gaya
├── principles/        ← keyakinan tentang produk, kode, bisnis
├── feedback/          ← aturan yang dipelajari dari kesalahan ← folder utama
├── style/             ← kata-kata yang harus dihindari, format Telegram
└── reference/         ← alat, lingkungan

Folder yang paling berguna adalah feedback/. Isinya aturan spesifik yang saya pelajari dari kesalahan agen. Setiap aturan disimpan dalam file terpisah dengan format berikut:

---
name: short-name
description: satu baris - isi file dan kapan menerapkannya
type: feedback
---

Aturan singkat dalam satu kalimat.

**Alasan:** alasan aturan ini ada. Konteks, insiden, pengamatan.

**Cara menerapkan:** pemicu spesifik kapan aturan ini berlaku.

Tanpa bagian “Alasan”, aturan itu tidak berguna - agen tidak akan menerapkannya pada situasi serupa. Tanpa “Cara menerapkan”, kapan aturan itu digunakan tidak jelas.

Contoh dari folder saya: aturan “tanda hubung, bukan em dash.” Aturan ini muncul karena em dash — merupakan penanda visual utama teks yang dihasilkan. Aturan ini berlaku untuk semua teks yang ditujukan kepada publik. Filenya ada di ai-clone/feedback/no-em-dashes.md.

Saya melakukannya dengan sedikit berbeda: saya menulis aturan di ai-clone/feedback/, bukan di CLAUDE.md. CLAUDE.md adalah file proyek, tetapi aturan tentang nada dan gaya bersifat pribadi. Aturan itu ikut dengan saya ke proyek berikutnya. CLAUDE.md tetap bersama proyek.

Catatan

Ukuran kematangan pendekatan ini: berapa kali seminggu Anda mengatakan kepada agen “tidak, bukan seperti itu” tentang hal yang sama? Dalam sistem yang matang, jawabannya nol. Setiap kesalahan menjadi aturan di feedback/, dan agen tidak mengulanginya pada kesempatan berikutnya.

Apa itu Live Metrics, dan mengapa angka tidak boleh ditulis tetap di file?

Poin utama

Angka dalam file otak kedua menjadi usang dalam hitungan hari. “1,000 klien” hari ini menjadi 1,050 besok dan 2,000 dalam sebulan. Jika Anda menuliskannya secara tetap, sebulan kemudian agen akan menyarankan sesuatu berdasarkan data kemarin. Solusinya adalah penanda LIVE dalam file ditambah dokumen live-metrics.md terpisah yang berisi kueri SQL siap dijalankan. Saat agen melihat LIVE, agen membuka basis data, mengambil angka terkini, dan membuat pertimbangan berdasarkan data terbaru.

Salah satu jebakan utama saat memulai otak kedua adalah mengisinya dengan angka usang. Anda menulis “kami punya 320 klien,” lalu dua minggu kemudian jumlahnya sudah 410. Anda menulis “pendapatan bulanan 4.7 juta,” lalu sebulan kemudian angka itu kehilangan konteks: apakah itu target, hasil aktual, atau proyeksi?

Dalam contoh penulis, cara kerjanya seperti ini. Di file business/products/practicum.md, ada penanda sebagai pengganti angka:

## Cohorts

> **LIVE** - jalankan kueri di `live-metrics.md`, bagian “Penjualan”
> untuk melihat pembayaran terkini berdasarkan cohort.

| Cohort | Tanggal | Membayar |
|-------|------|------------|
| 1 | 10-12 Maret 2026 | LIVE |
| 2 | 24-26 Maret 2026 | LIVE |

File live-metrics.md terpisah berisi kueri SQL siap dijalankan dan deskripsi hasil yang dikembalikan:

## Penjualan (pembayaran berdasarkan cohort)

```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;
```

Saat saya bertanya kepada agen, “berapa banyak pembayaran yang kita miliki untuk cohort kedua?”, agen:

  1. Membaca business/products/practicum.md
  2. Melihat penanda LIVE di sebelah angka
  3. Membuka live-metrics.md
  4. Menemukan bagian “Penjualan”
  5. Menjalankan kueri terhadap basis data produksi
  6. Menjawab menggunakan data terbaru

Ini menyelesaikan dua masalah sekaligus. Angka tidak menjadi usang. Dan keputusan dibuat berdasarkan keadaan terkini, bukan tahun lalu.

Peringatan

Dalam pendekatan penulis yang diceritakan, hanya agen tepercaya yang memiliki akses ke basis data produksi. Akses tersebut hanya diberikan melalui wrapper yang mencatat kueri dan tidak membuka kata sandi. Menaruh perintah psql langsung dengan kata sandi teks biasa di live-metrics.md adalah ide buruk. Buat wrapper yang mengambil kata sandi dari variabel lingkungan dan tidak menampilkannya dalam output. Itu lapisan teknis terpisah, tetapi tanpanya LIVE menjadi celah keamanan.

Bagaimana AI menavigasi otak kedua untuk satu permintaan?

Poin utama

Jalur permintaannya selalu sama: Claude membaca CLAUDE.md, melihat peta (business/INDEX.md, ai-clone/INDEX.md), membuka INDEX yang relevan, mengikutinya ke file tertentu, dan jika perlu mengambil angka melalui LIVE. Itu berarti 5-6 operasi baca, alih-alih memasukkan seluruh folder ke konteks. Jendela tetap tersedia untuk penalaran, dan token tidak terbuang untuk file yang tidak relevan.

Permintaan tertentu, misalnya: “buat draf email kepada peserta tentang cohort baru.”

  1. Claude memulai dengan jendela kosong. Claude memuat CLAUDE.md (aturan, stack, rute).
  2. Dari rute di CLAUDE.md, Claude melihat: “ai-clone/INDEX.md - selalu baca pada awal sesi.” Claude membuka file itu dan mempelajari siapa saya, bagaimana nada saya, dan kata-kata apa yang harus saya hindari.
  3. Claude melihat dalam rute: “templat email - src/lib/email/layout.ts.” Claude membuka file itu dan memahami formatnya.
  4. Claude melihat: “konteks produk - business/products/practicum.md.” Claude membuka file itu dan membaca tentang produk.
  5. Claude melihat penanda LIVE di file dan rujukan ke live-metrics.md. Claude membuka file itu dan menemukan SQL siap dijalankan. Jika membutuhkan angka terkini, Claude menjalankan kueri. Jika tidak, Claude menandai “ambil angka ini saat pengiriman.”
  6. Claude melihat aturan nada di ai-clone/style/telegram-format.md, larangan em dash di ai-clone/feedback/no-em-dashes.md, dan tingkat konversi corong di business/marketing/funnel.md.

Claude menulis email dengan nada saya, menggunakan angka terbaru dan tanpa em dash atau penanda AI.

Anthropic menyebut pendekatan ini just-in-time context dalam blog rekayasanya:

Agen yang dibangun dengan pendekatan 'just in time' menyimpan pengenal yang ringan (jalur file, kueri tersimpan, tautan, dan sebagainya) dan menggunakan tautan tersebut untuk menarik data secara dinamis ke dalam konteks saat berjalan melalui alat.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Dengan kata lain, Claude membawa penunjuk ke data, bukan datanya sendiri. Cara ini jauh lebih hemat token dan jauh lebih akurat, karena hanya informasi yang relevan yang masuk ke konteks. Jendela tetap lapang untuk penalaran.

5 antipola otak kedua - apa yang harus dihindari?

Poin utama

Kesalahan utama pemula saat membuat otak kedua: 1) CLAUDE.md membengkak hingga 500+ baris, bukan menjadi pengarah singkat; 2) folder penyimpanan serbaguna berubah menjadi tempat pembuangan; 3) menduplikasi hal-hal yang sudah diketahui Claude dari bahasa atau kode; 4) menulis angka secara tetap sehingga cepat usang tanpa LIVE; 5) membiarkan konteks tidak dapat diakses agen atau gagal mengarahkannya ke sana, baik pada repositori yang sama maupun penyimpanan privat terpisah.

Antipola 1. CLAUDE.md yang membengkak. 500 baris instruksi “alih-alih menaruh semuanya di satu tempat.” Anthropic berbicara langsung:

Jaga agar tetap singkat. Untuk setiap baris, tanyakan: 'Jika saya menghapus ini, apakah Claude akan mulai membuat kesalahan?' Jika tidak, hapus. File CLAUDE.md yang membengkak membuat Claude mengabaikan instruksi Anda yang sebenarnya!
— Anthropic, code.claude.com/docs/en/best-practices

Panjang sasaran adalah 80-120 baris. Taruh semua yang lain di file terpisah dan buat rute ke sana.

Antipola 2. Folder serbaguna. Anda melemparkan semuanya ke otak kedua: korespondensi obrolan mentah, tangkapan layar yang tidak berguna, laporan yang tak akan dibaca siapa pun. Sebulan kemudian, folder itu membengkak, agen menghabiskan token untuk membaca hal tidak berguna, dan Anda tidak ingat letak apa pun. Aturannya: setiap file di otak kedua harus menjawab pertanyaan tertentu. Jika tak seorang pun membukanya selama enam bulan, hapus atau pindahkan ke arsip.

Antipola 3. Duplikasi. “Pembayaran diproses melalui CloudPayments, di src/lib/payment/cloudpayments.ts; penyedia dikonfigurasi dalam .env.” Agen dapat melihat semua ini dalam kode. Jangan duplikasi di business/. Salinan akan menjadi usang: kode berubah, business/ tidak diperbarui, dan agen bekerja berdasarkan informasi usang.

Antipola 4. Angka yang ditulis tetap. “Kami punya 1,247 klien, dengan tingkat konversi 6.3%” - bayangkan ini angka dari suatu startup fintech abstrak. Semua angka semacam ini akan usang dalam seminggu. Gunakan penanda LIVE dan live-metrics.md. Bagian tentang hal ini ada di atas.

Antipola 5. Konteks tanpa jalur yang dapat diakses. Jika otak kedua berada di lokasi lain dan agen tidak memiliki izin atau petunjuk ke sana, memulai dari folder kode tidak cukup. Untuk catatan bersama yang tidak sensitif, menaruh business/ dan ai-clone/ dalam repositori merupakan tata letak praktis. Untuk konteks privat, simpan di lokasi yang dikendalikan terpisah dan konfigurasikan akses yang diizinkan serta peruteannya secara eksplisit. Kemudahan folder tidak mengalahkan kerahasiaan.

Tips

Cabang terpisah (context atau business-context) mengatur pekerjaan tetapi bukan batas akses: filenya tetap merupakan objek Git dalam repositori yang sama dan mungkin dipublikasikan bersama cabang atau riwayat. Untuk konteks bisnis privat, gunakan repositori privat terpisah atau penyimpanan eksternal dengan kontrol akses eksplisit serta perutean agen yang diizinkan. Submodule dapat menunjuk repositori privat terpisah, tetapi privasinya berasal dari izin repositori itu, bukan submodule sendiri. Pilihan lain adalah folder lokal yang sengaja diabaikan dengan cadangan tersendiri; mengabaikan jalur tidak menghapus file yang sudah terlacak Git atau riwayat yang pernah dipublikasikan. Simpan hanya konteks yang boleh dibagikan bersama kode.

Cara membangun otak kedua dalam satu jam - panduan langkah demi langkah

Poin utama

Anda dapat menyiapkan otak kedua minimal dalam satu jam: buat folder akar business/ dan ai-clone/, buat peta INDEX.md di masing-masing folder, tambahkan deskripsi singkat produk di business/products/, deskripsi klien di audience/, dan deskripsi tentang diri Anda di ai-clone/role.md. Tambahkan rute ke folder-folder ini di CLAUDE.md. Kemudian kembangkan sambil bekerja: setelah setiap kesalahan agen, tambahkan aturan di ai-clone/feedback/; setelah setiap keputusan, tambahkan catatan di business/.

  1. Buat dua folder akar

    Di akar proyek, 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 adalah tabel “pertanyaan → file”. Mulailah dengan setidaknya 5 baris dan tambahkan lagi sambil berjalan. Lakukan hal yang sama di ai-clone/INDEX.md.

  3. Tambahkan deskripsi singkat tentang produk dan klien

    business/products/main.md - apa produknya, untuk siapa, berapa harganya, dan apa yang membuatnya berbeda. 30-50 baris. business/audience/avatar.md - siapa kliennya, apa masalah mereka, dan apa yang mereka beli. 30-50 baris. Jangan deskripsikan klien ideal - deskripsikan klien nyata. Jika Anda tidak tahu sesuatu, tandai “perlu diklarifikasi” dan lanjutkan.

  4. Deskripsikan diri Anda di ai-clone/role.md

    Siapa Anda, apa yang Anda lakukan, dan apa yang penting bagi Anda. 20-30 baris. Itu cukup untuk memulai. Tambahkan nada, prinsip, dan kata-kata yang harus dihindari saat Anda mendapati agen menulis dengan gaya yang bukan milik Anda.

  5. Tambahkan rute ke CLAUDE.md

    Buka CLAUDE.md dan tambahkan bagian:

    ## Peta proyek
    
    - Konteks bisnis → `business/INDEX.md`
    - Konteks tentang saya → `ai-clone/INDEX.md`
    - Rencana teknis → `plans/YYYY-MM-DD-*.md`
    - Refleksi sesi terdahulu → `retrospectives/`
    
    Selalu baca `ai-clone/INDEX.md` dan `business/INDEX.md` pada awal sesi.
    
  6. Mulai Claude Code dan periksa

    Buka agen. Tanyakan: “ceritakan tentang produk dan audiens saya.” Jika jawabannya berasal dari konteks folder, berarti ini berfungsi. Jika agen mengarang sesuatu, periksa apakah folder berada bersama proyek, apakah nama file benar, dan apakah rute di CLAUDE.md ditulis dengan tepat.

Setelah itu, otak kedua tumbuh berdasarkan dua prinsip.

Pertama: setiap kali agen membuat kesalahan, tambahkan aturan. Setelah 3-4 minggu, ai-clone/feedback/ akan berisi 15-20 file aturan, dan agen akan berhenti membuat sebagian besar kesalahan umum.

Kedua: setiap kali Anda membuat keputusan bisnis, catat di business/. Jika Anda menaikkan harga, tambahkan catatan ke business/products/pricing.md beserta tanggal dan alasannya. Jika Anda mengubah positioning, tambahkan catatan ke business/company/about.md. Enam bulan kemudian, Anda akan memiliki arsip yang mengingat “mengapa.”

Prompt: Prompt siap pakai untuk pembaruan otak kedua pada malam hari

Kita telah menyelesaikan banyak pekerjaan bersama minggu ini.

Analisis semua perubahan kode dari minggu ini, semua commit yang kita buat.
Informasi berharga apa dari sini yang sebaiknya disimpan di business/ - tuliskan ke file yang sesuai
dengan wiki link ke file-file di sekitarnya agar konteksnya tidak hilang.

Jika ada keputusan dalam kode yang belum saya jelaskan, tanyakan alasannya kepada saya
lalu catat alasan tersebut di file yang sesuai dengan tanggalnya.

Jangan duplikasi hal yang sudah jelas dari kode. Sertakan hanya hal-hal yang tidak akan diketahui agen
pada sesi berikutnya tanpa business/.

Apa selanjutnya - Skills, Subagents, dan context engineering

Poin utama

Otak kedua ditambah CLAUDE.md adalah fondasinya. Di atasnya, tambahkan Skills (pengetahuan prosedural yang dimuat sesuai kebutuhan berdasarkan deskripsi tugas), Subagents (instance Claude terisolasi dengan jendela konteks masing-masing untuk tugas berat), dan context engineering (mengelola apa yang masuk ke jendela). Inilah tiga lantai di atas fondasi. Semuanya tidak berfungsi tanpa fondasi - agen tidak memiliki apa pun untuk dibaca.

Setelah otak kedua siap, ada tiga alat lain yang dijelaskan Anthropic sebagai tiga tingkat optimasi konteks yang berbeda.

Skills adalah pengetahuan prosedural. Jika Anda memiliki alur kerja yang berulang (menulis panduan pembelajaran, menyusun kiriman Telegram, mengaudit situs web), Anda dapat mengodekannya dalam file SKILL.md dengan deskripsi tugas. Pada awal sesi, Claude memindai nama dan deskripsi skill, lalu memuat hanya yang sesuai dengan tugas saat ini. Ini menghemat token dan menjaga fokus.

Subagents adalah instance Claude terisolasi dengan jendela konteksnya sendiri. Mulai subagent untuk tugas berat (membaca 30 file dan menyusun ringkasan), dan subagent bekerja di jendelanya sendiri lalu hanya mengembalikan hasilnya. Jendela utama Anda tetap lapang. Anthropic menulis:

Subagen khusus dapat menyelesaikan tugas terfokus dalam jendela konteks yang bersih. [...] Setiap subagen dapat menjelajah secara luas, menggunakan puluhan ribu token atau lebih, tetapi hanya mengembalikan ringkasan terkompresi dan tersaring dari pekerjaannya (sering kali 1,000-2,000 token).
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents

Context engineering adalah mengelola apa yang masuk ke jendela. Anthropic menyebutnya keterampilan mendasar untuk bekerja dengan agen pada 2025, satu tingkat di atas rekayasa prompt. Rekayasa prompt adalah memilih kata-kata. Context engineering adalah memilih file, rute, skill, dan subagent.

Otak kedua adalah blok bangunan pertama context engineering. Tanpanya, Skills membaca ruang kosong, Subagents tidak punya tujuan, dan jendela agen dipenuhi informasi acak. Dengannya, ketiga alat tersebut mulai berfungsi.

Langkah berikutnya. Buat dua folder bersama proyek: business/ dan ai-clone/. Tambahkan INDEX.md ke masing-masing dengan 5 baris sebagai peta. Tambahkan empat baris rute ke CLAUDE.md. Dalam satu jam, Anda akan memiliki kerangka otak kedua yang berfungsi. Lalu kembangkan dengan aturan “setiap kali agen membuat kesalahan, tambahkan satu baris ke ai-clone/feedback/.” Saya menjelaskan templat CLAUDE.md lengkap yang akan Anda gunakan untuk mengarahkan agen ke otak kedua dalam panduan Cara menyiapkan CLAUDE.md dengan benar.

Sumber

Lanjutkan menjelajahi Ailoot di ailoot.ai.

Rincian selengkapnya

Pertanyaan tentang Otak Kedua di Claude Code: Cara Membangun Strukturnya dalam Satu Jam

Apakah menaruh konteks bisnis pada cabang Git lain menjaganya tetap privat?

Tidak. Cabang merupakan bagian dari repositori yang sama dan filenya dapat dibagikan bersama objek serta riwayat repositori. Gunakan penyimpanan privat dengan kontrol terpisah, atau folder lokal yang sengaja diabaikan dengan cadangan; mengabaikan jalur tidak menghapus riwayat yang sudah terlacak.

Bagaimana agen menemukan konteks privat di luar repositori kode?

Berikan petunjuk eksplisit dan hanya izin akses yang diperlukan tugas. Pertahankan indeks singkat yang mengarahkan ke dokumen relevan, dan verifikasi bahwa agen dapat membaca file yang diizinkan; lokasi privat tanpa perutean tidak otomatis menyediakan konteks.

Semua artikel