"Masih Nggak Nangkep" — Setelah Lihat Kode
Momen paling merendahkan di dunia explaining adalah mendengar "aku masih nggak ngerti" — yang keluar setelah orangnya lihat kode dan analogi level kode. Respons refleks kita: jelaskan ulang dengan kode tambahan. Hasilnya makin buruk. 😅
Momen berulang itulah alasan playbook real-world-analogy ada di repo agent-playbooks-ku. Premisnya: kalau penjelasan berbasis kode gagal nyampe, bagian yang hilang biasanya bukan kode tambahan — melainkan cerita yang strukturnya itu sistemnya.
Ini sibling-nya cross-lang-analogy yang memetakan bahasa → bahasa ("goroutines itu kayak async/await"). Kalau yang ini memetakan sistem → dunia fisik ("Redis itu meja berisi sticky notes ber-timer").
Metafora Bukan Analogi
Prinsip inti playbook ini blak-blakan: kualitas sebuah analogi ditentukan oleh mapping table-nya.
Metafora itu cuma vibes ("cache itu kayak memori jangka pendek"). Analogi itu punya daftar cast di mana setiap bagian bergerak dari sistem asli punya satu padanan persis di cerita, dan setiap interaksi di cerita punya korespondensi nyata di sistem. Bagian yang tidak bisa dipetakan adalah persis titik di mana analoginya berbohong — dan playbook ini mewajibkan kita mengumumkannya sebelum learner menemukannya sendiri dan berhenti percaya.
Workflow-nya
- Diagnosis gap. Catat pertanyaan persis si learner, verbatim. Analogi yang menjawab pertanyaan lain itu performance, bukan pelajaran.
- Pilih setting yang fisikanya cocok. Cache + TTL butuh benda yang kedaluwarsa (sticky notes ber-timer, roti kemarin). Index butuh buku ber-tab. Rate limiting butuh bouncer.
- Susun cast — mapping table dulu, cerita belakangan. Tabelnya wajib. Kalau ada baris yang tidak bisa menjaga invariant sistem, setting-nya salah — ganti.
- Jalankan skenario — termasuk pertanyaan persis si learner sebagai satu scene, dengan beban kerja dihitung keras-keras.
- Pecahkan analoginya dengan jujur. Sebutkan di titik mana ceritanya berhenti memetakan.
- Punchline + bridge back. Satu kalimat yang nempel, lalu daftar yang memetakan setiap tokoh cerita balik ke nama teknisnya.
Lihat Bekerjanya: Meja Informasi Stasiun
Konkret: seorang learner bertanya kenapa project kereta commuter butuh Postgres dan Redis — "kenapa nggak satu array besar saja terus difilter?" Playbook ini memilih meja informasi stasiun (kedekatan budaya mengalahkan kepintaran).
Cast-nya:
- 📕 Buku jadwal dengan pembatas tab → Postgres + index B-tree
- 🗒️ Sticky note dengan timer 2 menit → key Redis dengan TTL
- 🧹 Petugas kebersihan pengumpul note kadaluarsa → TTL eviction
- 🧑💼 Petugas meja info → service backend
Lalu scenenya. Lima puluh penumpang bertanya tentang lintasan yang sama. Desain A: petugas membuka buku jadwal 52 halaman untuk SETIAP penumpang — lima puluh kali lima puluh halaman. Desain B: setelah pencarian pertama, petugas mencoret jawabannya di sticky note ber-timer 2 menit; empat puluh sembilan penumpang berikutnya membaca note-nya gratis. Begitu timer habis, petugas kebersihan membuang note-nya, dan penanya berikutnya berkonsultasi ke buku sekali lagi.
Itulah cache-aside dengan TTL — tapi sekarang aritmetikanya terlihat memihak cache, dan expiry yang di dokumen terasa arbitrer itu tinggal... sticky note yang basi.
Analoginya pecah di mana? Playbook bilang apa adanya: kertas hampir gratis dan petugas kebersihan datang tepat waktu, sementara key Redis asli memakan memori dan TTL tidak menunggu siapa-siapa. Mengumumkan patahan ini sebelum learner menemukannya menjaga kepercayaan tetap utuh.
Punchlinenya nempel: "Redis menyimpan jawaban jadi, bukan bahan mentah." Dan daftar bridge-back memastikan learner pulang membawa dua kosakata sekaligus — sticky note dan SET key value EX 120.
Lessons Learned
- Mapping table adalah pembeda antara analogi dan vibes. Susun sebelum kalimat pertama cerita.
- Satu konsep, satu cerita. Konsep kedua dapat cerita kedua; digabung malah merusak strukturnya.
- Hitung beban kerja dengan suara keras. Analogi meyakinkan saat aritmetikanya terlihat.
- Umumkan di mana analoginya pecah. Setiap analogi berbohong di suatu titik; mengaku duluan lebih murah daripada ketahuan.
Kalau penjelasanmu terus gagal nyampe ke seseorang, coba minta daftar cast daripada sampel kode tambahan. Semoga membantu momen "aku masih nggak ngerti" berikutnya. 😄