Penguraian Multi-Lintasan

Saat Anda meminta Claude meninjau changeset yang mencakup banyak berkas dalam satu pass, fokus menjadi encer. Model membagi perhatian terbatasnya ke semua berkas sekaligus, sehingga bug halus per berkas terlewat dan masalah lintas berkas yang nyata tertimbun.

Jawaban arsitek adalah dekomposisi multi-pass: bagi pekerjaan menjadi pass lokal per berkas terlebih dahulu, lalu pass integrasi lintas berkas yang terpisah. Setiap pass memiliki satu tugas yang jelas, sehingga fokus tetap tajam.

Kedua pass mengajukan pertanyaan yang pada dasarnya berbeda, dan itulah alasan keduanya tidak boleh digabungkan:

• Pass lokal: "Apakah berkas INI benar secara internal?" — kesalahan logika, penanganan nilai null, penamaan, kode mati, dan gaya dalam batas berkas itu sendiri.
• Pass integrasi: "Apakah berkas-berkas ini bekerja TOGETHER?" — tanda tangan fungsi yang tidak cocok, kontrak yang rusak, dan asumsi yang tidak konsisten di antara batas modul.

Peninjauan satu pass memaksa kedua pertanyaan masuk ke satu perintah yang fokusnya encer. Dua pass menjaga masing-masing tetap fokus.

Pass lokal dimulai dengan penemuan. Gunakan alat bawaan Claude Code secara bertahap: Glob untuk menemukan berkas berdasarkan pola, lalu Read setiap berkas secara terpisah.

Meninjau satu berkas per permintaan membuat konteks tetap kecil dan perhatian tetap terkonsentrasi. Ini kebalikan dari memasukkan seluruh diff ke dalam satu perintah.

Dalam pass lokal, berikan batas yang jelas dan tegas kepada Claude: tinjau hanya berkas ini, dan nilai berdasarkan isinya sendiri. Instruksi samar seperti "bersikap menyeluruh" memberikan hasil yang kurang baik; kriteria eksplisit lebih efektif.

Nyatakan dengan tepat hal yang dianggap sebagai temuan agar model tidak beralih ke spekulasi tentang berkas yang belum dilihatnya.

Minta setiap pass lokal menghasilkan keluaran terstruktur agar temuan dapat digabungkan oleh mesin untuk pass berikutnya. Gunakan tool_choice dengan alat yang didukung skema untuk menjamin JSON yang terbentuk dengan benar.

Penting: tandai suatu bidang sebagai required hanya jika bidang itu selalu ada. Jangan pernah mewajibkan bidang yang mungkin tidak ada — model akan mengarang nilai untuk memenuhi skema.

Setelah setiap berkas melewati peninjauan lokalnya, jalankan pass integrasi yang terpisah. Kini tujuannya beralih: Anda sengaja memuat berkas-berkas yang relevan secara bersamaan dan menanyakan apakah kontraknya selaras.

Cacat integrasi yang umum:

• Pemanggil meneruskan tiga argumen; fungsi yang dipanggil kini mengharapkan empat.
• Satu modul mengembalikan None saat "tidak ditemukan"; konsumen memperlakukannya sebagai daftar kosong.
• Nilai enum yang diganti namanya masih dirujuk oleh berkas saudara.

Pass integrasi meniru investigasi bertahap. Mulailah dari batas-batas dan ikuti penghubungnya: gunakan Grep untuk mencari setiap lokasi pemanggilan nama fungsi yang diubah, lalu gunakan Read pada konsumen tersebut.

Dengan cara ini, pass integrasi berfokus pada sambungan antarberkas — tepat di tempat yang cenderung terlewat dalam peninjauan satu pass.

Jalankan lokal sebelum integrasi, bukan sebaliknya. Jika suatu berkas rusak secara internal, temuan integrasi tentang berkas itu hanyalah gangguan — Anda akan menandai ketidakcocokan kontrak yang hilang setelah bug lokal diperbaiki.

Bersihkan setiap berkas secara terpisah terlebih dahulu. Setelah itu, pass integrasi dapat mempercayai bahwa setiap berkas benar secara lokal dan berfokus sepenuhnya pada cara berkas-berkas tersebut bekerja bersama.

Karena langkah-langkahnya sudah diketahui dan berurutan — menemukan, pass lokal, pass integrasi, melaporkan — pekerjaan ini cocok untuk alur tetap (pengaitan perintah), bukan eksplorasi adaptif yang terbuka.

Simpan dekomposisi adaptif untuk investigasi yang benar-benar terbuka ("mengapa ini tidak stabil?"). Peninjauan multi-pass memiliki bentuk yang jelas, jadi kodifikasikan bentuk tersebut.

Jalankan setiap pass peninjauan dalam sesi baru yang terisolasi, terpisah dari sesi yang menghasilkan kode. Peninjauan independen lebih baik daripada peninjauan mandiri dalam sesi yang sama: pembuat kode tetap terikat pada penalarannya sendiri dan tidak akan menantang asumsinya sendiri.

Dalam CI, jalankan ini tanpa interaksi dengan -p / --print dan --output-format json agar hasilnya dapat diurai. Saat menjalankan ulang, masukkan hasil sebelumnya dan laporkan hanya masalah baru atau yang masih belum diperbaiki.

Untuk changeset berukuran besar, sebarkan pass lokal ke beberapa subagen dalam pola hub-and-spoke: koordinator membagi berkas di antara pekerja paralel, lalu menjalankan pass integrasi sendiri setelah hasilnya kembali.

Ingat aturannya: subagen tidak mewarisi riwayat koordinator. Setiap perintah subagen harus memuat semua konteks yang dibutuhkannya secara eksplisit. Beberapa pemanggilan Task dalam satu respons berjalan secara paralel.

Dekomposisi multi-pass, diringkas:

• Dua pass, dua pertanyaan: lokal = apakah setiap berkas benar secara internal; integrasi = apakah berkas-berkas tersebut bekerja bersama.
• Lokal terlebih dahulu, lalu integrasi — berkas yang rusak membuat temuan integrasi menjadi gangguan.
• Satu berkas per permintaan lokal untuk menjaga fokus tetap tajam; hasilkan keluaran terstruktur agar mudah digabungkan.
• Alur tetap (menemukan → lokal → integrasi → melaporkan), bukan improvisasi adaptif.
• Sesi terisolasi/baru lebih baik daripada peninjauan mandiri dalam sesi yang sama; dalam CI gunakan -p dan --output-format json.
• Skalakan pass lokal ke beberapa subagen paralel — masing-masing memerlukan konteks yang diteruskan secara eksplisit.

Peninjauan multi-berkas satu pass adalah pola anti. Lakukan dekomposisi agar peninjauan Anda menjadi lebih tajam, bukan sekadar lebih panjang.