Konteks Kedaluwarsa dan Memulai dari Awal

Claude Code memungkinkan Anda melanjutkan pekerjaan dari hari ke hari. --resume <name> membuka kembali sesi bernama dengan seluruh riwayat pesannya tetap utuh: prompt, penalaran model, dan yang terpenting, hasil alat yang diambil saat pertama kali.

Pemutaran ulang itu sangat berguna. Namun, ada sisi yang perlu diwaspadai: hasil alat tersebut adalah rekaman masa lalu, bukan tampilan langsung sistem Anda. Pelajaran ini membahas cara mengenali ketika rekaman itu sudah usang dan apa yang harus dilakukan sebagai gantinya.

Ingat cara kerja API: model tidak memiliki keadaan sendiri. Pada setiap giliran, Anda mengirim riwayat messages lengkap — termasuk blok tool_result sebelumnya. Model bernalar berdasarkan apa pun yang dinyatakan oleh blok-blok tersebut.

Sesi yang dilanjutkan hanya memuat ulang riwayat yang tersimpan itu. Jika Read mengambil isi sebuah file Selasa lalu, model masih menganggap versi hari Selasa itulah yang berlaku hari ini — meskipun file tersebut telah berubah sepuluh kali sejak saat itu.

Konteks usang terjadi ketika hasil alat yang dilanjutkan tidak lagi sesuai dengan kenyataan. Pemicu yang umum:

• Rekan satu tim mengedit file yang sama di antara sesi.
• Migrasi mengubah skema basis data yang telah disimpan dalam ingatan model.
• Pembaruan dependensi mengubah API yang sebelumnya dibaca model.
• Artefak build atau keluaran pengujian yang diambil sebelumnya kini sudah tidak berlaku.

Bahaya yang ditimbulkan: model melanjutkan dengan penuh keyakinan berdasarkan fakta usang dan menghasilkan perubahan yang bertentangan dengan basis kode terkini.

Anda memiliki dua cara pemulihan ketika sesi mulai usang:

• --resume <name> melanjutkan sesi bernama tersebut dengan memutar ulang seluruh riwayat tersimpannya.
• fork_session membuat cabang dari titik bersama — berguna untuk mengeksplorasi alternatif tanpa mengganggu sesi asli.

Keduanya mewarisi hasil alat lama. Ketika basis kode telah banyak bergeser, tidak satu pun menjadi pilihan ideal. Terkadang sesi baru yang diawali dengan ringkasan terstruktur lebih baik daripada melanjutkan sesi, karena memaksa setiap fakta untuk diambil kembali berdasarkan kondisi terkini.

Ajukan satu pertanyaan: apakah fakta dasar telah berubah sejak sesi diambil?

• Hanya sedikit atau tidak ada pergeseran (Anda berhenti selama satu jam, tidak ada orang lain yang menyentuh repositori) → --resume cukup dan hemat.
• Pergeseran signifikan (beberapa hari berlalu, penggabungan telah masuk, skema bermigrasi) → mulai dari sesi baru dan ringkas kembali tujuannya, lalu biarkan model mengambil ulang hasil alat secara langsung.

Ini adalah keputusan keandalan dalam pengelolaan konteks — domain D5 dalam ujian.

"Ringkas ulang" berarti meneruskan niat dan keputusan, tetapi membuang keluaran alat yang membeku agar dapat diperoleh kembali. Anda menulis ringkasan terstruktur yang padat mengenai posisi tugas saat ini, lalu membuka sesi bersih dengan ringkasan tersebut sebagai prompt pembuka.

Model kemudian menjalankan Read, Grep, dan Bash terhadap basis kode terkini — tanpa rekaman usang yang dapat menyesatkannya.

Peringkasan progresif bersifat lossy: proses ini membuat angka, persentase, dan tanggal menjadi samar. Jika ringkasan Anda harus mempertahankan nilai yang tepat — penetapan versi, jumlah baris, tenggat, ID pesanan — jangan masukkan semuanya ke dalam prosa.

Tempatkan semua itu dalam blok "fakta kasus" terpisah yang dipertahankan apa adanya, di luar ringkasan naratif. Ringkasan dapat memadatkan cerita; blok fakta tetap tepat.

Dalam sesi baru, prinsipnya sederhana: selidiki sebelum mengubah. Gunakan pola bertahap — Grep titik masuk, Read file, Grep penggunaan, Read pemanggil — agar setiap perubahan didasarkan pada isi terkini.

Itulah juga alasan Edit menggunakan kontrak pencocokan unik: jika file telah berubah dan teks yang Anda harapkan tidak lagi cocok secara unik, perubahan akan gagal dengan jelas alih-alih merusak file. Jalankan kembali Read dan coba lagi.

/compact memadatkan percakapan saat ini untuk menghemat ruang konteks. Fitur ini berguna, tetapi memiliki risiko kehilangan informasi yang sama: angka dan tanggal dapat menjadi samar. Fitur ini tidak mengatasi keusangan — fakta yang dipadatkan tetap berasal dari pengambilan awal.

Memulai sesi baru berbeda: Anda membuang seluruh hasil alat lama dan mendapatkannya kembali secara langsung. Gunakan /compact untuk sesi yang panjang tetapi masih akurat; mulai sesi baru ketika sistem yang mendasarinya telah berubah.

Pelajaran tentang keusangan ini selaras dengan desain multiagen. Agen subordinat tidak mewarisi riwayat percakapan koordinator — semua konteks harus diteruskan secara eksplisit dalam setiap prompt agen subordinat.

Kebersihan yang sama membantu Anda: ketika Anda memberikan ringkasan terstruktur beserta blok fakta apa adanya kepada sesi baru (atau agen subordinat), Anda secara sengaja melakukan hal yang dilakukan oleh pelanjutan sesi secara tidak sengaja — tetapi Anda mengendalikan fakta mana yang dipertahankan dan memaksa pengambilan ulang fakta lainnya secara langsung.

Sebelum melanjutkan sesi yang sudah usang, lakukan pemeriksaan berikut:

• Pergeseran? Apakah repositori/skema/dependensi berubah sejak pengambilan data? Jika ya → lebih baik gunakan sesi baru.
• Ringkas tujuan, keputusan yang telah dibuat, dan TODO yang tersisa.
• Pertahankan angka/tanggal/ID yang tepat dalam blok fakta apa adanya.
• Ambil ulang secara langsung: Grep → Read sebelum Edit apa pun.
• Verifikasi berdasarkan keadaan terkini, bukan keadaan yang diingat.

Melanjutkan sesi memang hemat ketika tidak ada yang berubah; memulai sesi baru adalah perlindungan murah ketika ada perubahan.

Hal-hal penting:

• Sesi yang dilanjutkan memutar ulang hasil alat yang membeku karena model tidak menyimpan keadaan dan bernalar berdasarkan seluruh riwayat yang tersimpan.
• Ketika sistem telah bergeser (penggabungan, migrasi, pembaruan dependensi), hasil tersebut menjadi usang dan dapat mendorong perubahan yang dilakukan dengan yakin tetapi keliru.
• Jika pergeserannya signifikan, mulai dari sesi baru dan ringkas ulang, bukan menggunakan --resume atau fork_session, karena keduanya mewarisi rekaman lama.
• Simpan angka, tanggal, dan ID yang tepat dalam blok fakta kasus apa adanya; peringkasan membuatnya samar.
• Ambil ulang secara langsung (Grep → Read) sebelum Edit apa pun; /compact menghemat ruang tetapi tidak mengatasi keusangan.