Audit Agent Konteks : Ketika Governance Anda sendiri menjadi masalah — dan Cara Memperbaikinya tanpa Kehilangan Apa pun

30 April 2026, 16:00. Saya tengah dalam sesi`magic-stick`, proyek saya membangun ISO Linux live. Agen Opencode telah memuat otomatis file-file Eager saya seperti biasa —AGENT.adoc, PROMPT_REPRISE.adoc, .agents/INDEX.adoc. Semua normal.

Tapi jawaban-nya lemah. Agen memakan waktu dua detik lebih untuk berpikir. Ia melupakan detail yang baru saja dia lihat tiga pesan sebelumnya. Ini bukan crash, bukan kesalahan — ini adalah degradasi perlahan, jenis yang tidak langsung terlihat.

Saya sudah pernah mengalami hal itu pada sesi 048, ketika saya menemukan bahwa file-file tata kelola memiliki 5200 baris secara kumulatif. Saya kemudian mengonseptualisasikan mekanisme Hot/Warm/Cold dengan window geser sebesar 10 sesi, gelombang dinginnya yang identik, serta sensor-nya dengan dua pemicu. Masalah tersebut sudah teratasi. Dalam teori.

Tapi di sini, kita berada di sesi 051. Rotasi backup telah terjadi dengan baik — file-file EAGER berubah dari 2087 menjadi 500 baris. Namun, konteks masih berat. Ada yang terlepas dariku.

Saya membuka terminal dan saya mengetik :

1414 baris. Rotasi backup telah memangkas dengan baik di INDEX, SESSIONS_HISTORY dan COMPLETED_TASKS — mereka bersih. Tapi ada seekor gajah di ruangan yang belum saya lihat :627 barisdalam satu file.AGENT_MODUS_OPERANDI.adoc.

File ini adalah file yang saya telah tulis di sesi 1 untuk mendokumentasikan strategi Eager/Lazy. Ini adalah manual metode. Dan ia sendiri telah menjadi 44% dari konteks EAGER.

Ironi itu total. File yang dirancang untuk menghemat konteks telah menjadi konsumen utama konteks. Seolah-olah manual penggunaan mobil Anda lebih berat daripada mesin.

Saya memutuskan untuk melakukan audit bagian demi bagian. Bukan untuk menghapus — untuk memahami yang layak berada di EAGER dan yang mungkin bisa tinggal di tempat lain tanpa kehilangan pengetahuan.

Berikut adalah struktur tepat dari`AGENT_MODUS_OPERANDI.adoc`dan yang saya temukan di sana:

Putusannya tanpa rayuan:

Pada 627 baris,382 adalah derau. Dan 382 baris ini dimuat di awal setiap sesi, dikonsumsi oleh agen, mengurangi perhatiannya bahkan sebelum saya menyapa.

Diagram ini adalah kunci dari segalanya. Duplikasi (kuning) adalah noise murni — agen membaca mereka dua kali, dalam dua file berbeda. Yang tidak pernah dikonsultasi (merah) adalah dokumentasi mati — ditulis dengan teliti, tidak pernah digunakan. Hanya hijau yang berisi pengetahuan yang tidak dapat ditemukan oleh agen di tempat lain.

Pada tahap ini, saya memiliki bukti di depan mata saya: saya harus mengurangi`AGENT_MODUS_OPERANDI.adoc`. Tapi saya ragu.

File ini, saya tulis dengan tangan. Setiap bagian adalah hasil dari pelajaran yang dipelajari dalam sesi nyata. Bagian P3 lahir dari sebuah`rm -rf`aksidental di`bakery-plugin`yang menghabiskan token Firebase nyata. Bagian P4 adalah hasil dari lima belas sesi di mana saya lupa mengarsip dan kehilangan alur. Prosedur dalam 6 langkah bukanlah hasil dari sebuah buku — ia adalah hasil dari kesakitan.

Menghapus bagian-bagian ini, akan menjadi membuang sejarah dari rekayasa saya sendiri. Pelajaran yang menciptakannya, sesi-sesi ketika saya menemukannya, kesalahan yang saya tidak ingin pernah lagi mengulangi. Bukan itu teks — ini adalah pengalaman yang terkristal.

Itulah tempat saya merumuskan prinsip yang akan memandu solusi:

_ Jangan pernah menghapus. Selalu relokasi.Pengetahuan tidak harus menghilang dari proyek. Ia hanya perlu tidak dimuat secara otomatis ketika tidak diperlukan. _

Model yang saya ajukan sederhana dan terinspirasi dari cara Wikipedia berkembang: ketika suatu artikel menjadi terlalu panjang, kita tidak memotongnya — kita membuat artikel terperinci dan menyimpan rangkuman dalam artikel utama.

untuk`AGENT_MODUS_OPERANDI.adoc`, itu memberi :

Nama`encyclopedies/`Tidak sembarangan. Sebuah ensiklopedia bukanlah berkas arsip — itu merupakan koleksi pengetahuan yang terorganisir, dapat diakses tapi tidak dapat dibawa. Tidak ada yang membaca Ensiklopedia Universalis di metro. Kita menyimpannya di perpustakaan, dan kita pergi ke sana saat kita memiliki pertanyaan yang spesifik.

Ini adalah peran tepat dari folder ini: sebuah perpustakaan referensi yang dingin, terstruktur, komprehensif — yang tidak disentuh secara otomatis oleh agen.

Ini adalah tampilan konkret dari file baru.LAZY_EAGER_ESSENTIALS.adoc, diekstrak dan dikompres dari P1 dan P2 :

Lima puluh baris. Itulah semua yang dibutuhkan agen untuk memahami mekaniknya. Sisanya — riwayat pelajaran, analogi terperinci, prosedur langkah demi langkah, lampiran — berada di dalam ensiklopedia.

Dan yang terpenting:Tidak ada yang dihapus. 627 baris teknik masih ada, di`.agents/encyclopedies/LAZY_EAGER_ENCYCLOPEDIE.adoc`. Mereka hanya disimpan di perpustakaan alih-alih di atas meja kerja.

Sebelum split :

Setelah split :

Pengguna terbesar (AGENT_MODUS_OPERANDI, 627 baris) telah diganti dengan sebuah file berukuran 50 baris. Manfaatnya segera terasa : 577 baris konteks telah dibebaskan. Agen tersebut bisa bernapas.

Dan di`.agents/encyclopedies/`, file asli dari 627 bar menunggu. Utuh. Dengan semua bagiannya — termasuk yang merupakan duplikat, termasuk yang belum pernah digunakan. Karena suatu hari nanti, sebuah model yang lebih baik atau seorang data scientist manusia akan ingin menggabungkan sudut-sudut ini, redundansi yang diasumsikan, pelajaran yang telah dipelajari. Dan hari itu, bahan mentah akan ada.

Pemilihan nama tidak bersifat kosmetik. Ia mengkodekan filosofi mekanisme.

Sebuah arsip (archives/) mengandung data historis yang diatur secara kronologis — seperti COMPLETED_TASKS bulanan. Sebuah backup (backup/) adalah snapshot berlabel waktu — sebuah cadangan dari keadaan masa lalu.

Encyclopédie, itu hal lain. Ini adalah kumpulan pengetahuan bersifat tematik, terstruktur berdasarkan subjek, lengkap namun tidak linier. Kita tidak membaca sebuah ensiklopedi dari awal sampai akhir. Kita menyelam ke dalamnya untuk menjawab pertanyaan spesifik.

Ini adalah tepat kontrak dari berkas ini:

Perbedaan ini menghindari kerumitan. Setiap file tahu di mana ia harus berada sesuai dengan apa yang berisi, bukan sesuai dengan kapan ia dibuat.

Jika Anda telah membaca dua artikel pertama, ini cara tiga bagian bersatu:

Artikel pertama telah membangun struktur. Artikel kedua telah menambahkan mekanisme penuaan. Artikel ketiga melakukan audit konten — dan menemukan bahwa metodologi itu sendiri telah menjadi masalah.

Dengan memandang kembali, saya melihat kesalahan desain awal.`AGENT_MODUS_OPERANDI.adoc`telah dibuat sebagai dokumen tunggal — sebuah manifesto. Itu adalah pendekatan yang tepat untuk formalisasi pemikiran. Namun setelah pemikiran formalisasi, dokumen seharusnya langsung dipisahkan: intinya dalam EAGER, yang komprehensif dalam cold.

Saya tidak melakukannya karena saya bangga dengan dokumen tersebut. 627 baris rekayasa murni, ditulis tangan, setiap bagian merupakan hasil pelajaran sesi. Itu adalah karyaku. Dan seperti setiap penulis, saya kesulitan memotongnya.

Pelajaran:Bukan karena sebuah dokumen bagus berarti harus dimuat otomatis.. Kualitas konten tidak memiliki hubungannya dengan relevansinya untuk konteks langsung agen.

Hari ini, aturannya sederhana : semua dokumen yang lebih dari 100 baris dalam konteks EAGER adalah seorang tersangka. Dia layak mendapatkan audit. Bukan hukuman — audit. Dan pertanyaan tidak pernah « haruskah ia dihapus? » tetapi « haruskah ia dimuat dalam setiap sesi ?

Jika Anda telah mengikuti dua artikel pertama dan menata tata kelola Eager/Lazy Anda sendiri, berikut adalah prosedur audit dalam lima langkah :

Prosedur ini membutuhkan 15 menit. Pada sebuah proyek dengan 50 sesi, ia menghemat ratusan token per sesi masa depan. ROI-nya langsung.

Apa yang diajarkan oleh rangkaian tiga artikel ini adalah bahwa tata kelola agen bukanlah produk yang selesai. Ini adalahorganisme hidup. Ia tumbuh bersama proyek. Ia mengidap penyakit pertumbuhan. Ia memerlukan pemeriksaan rutin.

Sesi 048 menunjukkan bahwa arsip membengkak. Sesi 051 menunjukkan bahwa metodologi itu sendiri membengkak. Sesi 060 mungkin akan mengungkapkan hal lain. Ini normal. Ini sehat. Pemerintahan yang tidak pernah menanyakan diri sendiri adalah pemerintahan yang mati.

Tiga mekanisme yang diterapkan — Eager/Lazy, Hot/Warm/Cold, split encyclopédique — membentuk sistem pertahanan dalam lapisan terhadap kejenuhan konteks. Tidak satu pun yang cukup sendirian. Bersama-sama, mereka melengkapi satu sama lain:

Dengan tiga lapisan ini, konteks agen pada`magic-stick`berubah dari 2087 baris menjadi sekitar 800 baris — pembagian sebanyak 2,6. Tanpa kehilangan satu baris dokumentasi, satu arsip sesi, satu pelajaran yang dipelajari.

Semua ada di sana. Lebih rapi saja.

Ilmu tidak perlu menghilang. Ia hanya perlu tidak dimuat ketika tidak diperlukan.