Hal paling mahal tentang bekerja dengan agen adalah menjelaskan ulang konteks. Setiap pagi Anda menjelaskan ulang keputusan kemarin, menempelkan pesan commit terakhir, menetapkan kembali bug mana yang menghalangi deploy. Kalikan dengan setiap sesi dan biaya tersembunyi adalah jam per minggu, bukan menit.
STATE.md menghilangkan pajak itu. Satu file, diperbarui di akhir setiap sesi, dimuat di awal sesi berikutnya. Disiplinnya: sebelum Anda menutup sesi, luangkan tiga menit untuk memperbarui file. Besok, tiga menit itu menghemat dua puluh.
STATE.md menyimpan tiga hal, tidak lebih.
Keputusan: apa yang Anda putuskan dan mengapa. Tanpa mengapa, Anda di masa depan membuka kembali keputusan. "Trigger Postgres alih-alih cron untuk ringkasan harian: trigger bersifat transaksional, cron berlomba dengan jalur penulisan."
Dalam proses: apa yang setengah jadi, cukup spesifik untuk diserahkan. "Migrasi 014 ditulis di /migrations/014_add_subscription_columns.sql tetapi belum diterapkan. Harus dijalankan sebelum penangan webhook aktif."
Penghalang: apa yang menghentikan kemajuan, termasuk apa yang Anda coba. "Tanda tangan webhook Stripe gagal di lingkungan pengujian. Mencoba parser body mentah, masih 400. Berikutnya: periksa variabel env di pratinjau Vercel."
Batasi hingga 60-80 baris. Ketika sesuatu selesai, hapus. Ketika sesuatu dikirim, arsipkan.
Disiplin pembaruan. Tambahkan hook Stop untuk mengingatkan diri sendiri:
{
"hooks": {
"Stop": [
{
"command": "echo 'Sebelum Anda menutup: perbarui STATE.md dengan keputusan, dalam proses, dan penghalang dari sesi ini.'"
}
]
}
}Pengingat saja tidak cukup; kebiasaan harus otomatis. Jalur tercepat: lakukan selama lima sesi berturut-turut. Pada sesi keenam, Anda akan merasa salah menutup tanpa memperbarui. Ketidaknyamanan adalah sinyal bahwa kebiasaan telah terbentuk.
MEMORY.md adalah indeks untuk semua yang tahan lama. Setiap entri adalah satu baris yang menunjuk ke file terpisah. Empat jenis:
user_*: fakta tahan lama tentang Anda: zona waktu, konteks karier, preferensi. user_location.md
feedback_*: aturan yang dipelajari dari kesalahan, dengan bidang kepercayaan diri. Mulai dari 0,3, naikkan menjadi 0,5 ketika pola berulang, promosikan ke CLAUDE.md pada 0,9+. feedback_public_endpoints_need_rate_limits.md
project_*: status dan keputusan bertanggal untuk satu proyek. Arsipkan saat dikirim. project_stripe_integration_2026_05.md
reference_*: tabel pencarian untuk orang, alat, API. reference_neon_db_config.md
Jaga setiap baris indeks di bawah 200 karakter dan indeks di bawah 200 baris. Lebih dari itu, entri akan terpotong dan Claude tidak dapat melihatnya.
STATE.md adalah untuk sekarang. MEMORY.md adalah untuk selamanya. Aturan praktisnya: jika Anda akan mengatakannya dalam standup, itu masuk ke STATE.md. Jika Anda akan menuliskannya di wiki atau dokumen orientasi, itu masuk ke file memori. Standup bersifat sementara; wiki bersifat tahan lama.
Ketika sebuah proyek dikirim dan STATE.md masih membawa lima baris tentangnya, pindahkan baris-baris itu ke file memori project_* bertanggal dan bersihkan. Proyek itu tidak berhenti penting; ia berhenti menjadi terkini. Perbedaan itu menjaga STATE.md tetap berguna.
Tulis status, bukan jurnal. Entri jurnal: "Mengerjakan integrasi Stripe. Itu rumit." Entri status: "Endpoint webhook di app/api/webhooks/stripe/route.ts. Verifikasi tanda tangan berfungsi secara lokal, gagal di pratinjau Vercel (format body mentah salah). Berikutnya: periksa konfigurasi middleware rawBody." Satu memberi sesi berikutnya titik awal; yang lain memberinya memoar.
Dua anti-pola lagi: entri dalam proses tanpa tindakan konkret berikutnya yang dapat dieksekusi oleh sesi baru, dan entri duplikat untuk topik yang sama di seluruh sesi. Gabungkan duplikat: satu topik, satu entri, hanya status saat ini.
Pembaruan sesi yang baik adalah sembilan hingga dua belas baris: satu keputusan dengan alasan, satu item dalam proses dengan langkah berikutnya, satu penghalang dengan apa yang Anda coba.
Skala lebih dari 50 file memori: lapisan ringkasan. Setiap baris penunjuk MEMORY.md membutuhkan sekitar 100-150 token. Pada 200 baris itu adalah 20-30K token murni penunjuk. Solusinya: STRATEGY-DIGEST.md, ringkasan 2-3 kalimat dari setiap dokumen utama ditambah bidang "Gunakan saat:":
## q2-positioning.md
Posisi Q2 menargetkan pemberdayaan AI di organisasi penjualan pasar menengah.
Gunakan saat: membahas pelanggan target, harga, atau kualifikasi prospek.Claude membaca ringkasan (sekitar 3K token) dan memuat dokumen lengkap hanya jika relevan. Pada 25 dokumen strategi, itu adalah 3K token alih-alih 50K. Bidang "Gunakan saat:" adalah mekanisme perutean: tulis sebagai kondisi pemicu spesifik, bukan deskripsi file.
STATE.md menangkap status saat ini (keputusan, dalam proses, penghalang) di bawah 80 baris; perbarui di akhir sesi dan arsipkan riwayat dengan segera. MEMORY.md mengindeks pengetahuan yang tahan lama dalam empat jenis (pengguna, umpan balik, proyek, referensi), dibatasi hingga 200 baris. Mulai malam ini dengan tiga baris: satu keputusan, satu item dalam proses, satu penghalang. Tiga baris mengalahkan nol saat kebiasaan terbentuk.