AI
Pola Writer-Reviewer untuk Coding Agent AI
Agustus 20269 menit baca
Ini adalah alur kerja coding yang membagi pekerjaan menjadi dua peran: satu agen menulis perubahan, dan agen terpisah hanya mereview diff terhadap kriteria penerimaan di konteks baru. Karena reviewer tidak pernah melihat alur pikir penulis, ia menilai apa yang sebenarnya dilakukan kode alih-alih apa yang dimaksud penulis, sehingga menemukan bug yang akan terlewat oleh satu agen.
Satu sesi membawa tiap asumsi dan jalan pintas dari fase penulisan ke dalam review, sehingga cenderung membenarkan kerjanya sendiri alih-alih menantangnya. Reviewer baru mulai dari nol tanpa biaya hangus pada pendekatannya, dan justru itulah yang membuatnya bisa menangkap desain salah atau bug halus yang tak terlihat oleh penulis.
Definisikan reviewer sebagai subagent dengan tool read-only seperti read, grep, dan glob, serta system prompt yang menyuruhnya menilai diff terhadap kriteria penerimaan dan mengembalikan daftar temuan konkret berperingkat. Beri ia hanya diff dan kebutuhannya, bukan riwayat chat penulis, agar independensinya terjaga.
Ya, ia kira-kira menggandakan pengeluaran token pada sebuah perubahan karena review adalah langkah kedua atas pekerjaan itu. Biaya itu sepele untuk kode sensitif keamanan, migrasi, atau perubahan API publik, di mana bug terlewat itu mahal, tetapi berlebihan untuk perubahan satu baris di mana sekilas mata manusia lebih cepat dan murah.
Beri loop jalan keluar yang jelas: ia berakhir pada lolos bersih dari reviewer atau ketika menyentuh batas iterasi tetap. Orkestrator juga harus memilah temuan sebelum tiap penulisan baru, mengarahkan hanya isu nyata kembali ke penulis dan membuang positif palsu, sehingga loop konvergen alih-alih terombang-ambing pada derau.
Ringkasan Utama
Pola writer-reviewer membagi coding AI menjadi dua peran: satu agen menyusun perubahan, agen kedua hanya mereview diff terhadap kriteria penerimaan di konteks baru. Karena reviewer tidak pernah melihat alur pikir penulis, ia menangkap bug yang tak terlihat oleh penulis, mengubah satu langkah penuh harapan menjadi loop terperiksa yang mengoreksi diri.
Minta agen AI menulis sebuah fitur dan ia akan menyerahkan kode yang terlihat selesai. Terlihat itulah jebakannya. Model yang sama yang menulis off-by-one halus adalah hakim terburuk untuk menilai apakah off-by-one itu ada, karena ia bernalar dari asumsi cacat yang sama yang menghasilkannya.
Pola writer-reviewer memecah titik buta itu jadi dua. Satu agen menulis; agen terpisah, dengan konteks bersih dan sebuah checklist, mereview. Panduan ini menjelaskan mengapa pemisahan itu bekerja, cara merangkainya di tool coding agentik, dan di mana ia diam-diam gagal jika Anda tidak berhati-hati.
Konteks sebuah agen adalah cara pandangnya. Ketika satu sesi menulis kode lalu mereviewnya, review itu mewarisi setiap asumsi, jalan pintas, dan salah baca kebutuhan dari fase penulisan. Itu seperti pekerjaan rumah yang dinilai oleh murid yang sama yang menulisnya.
Reviewer baru mengubah insentifnya. Beri agen kedua hanya diff dan kriteria penerimaan, dan ia mulai dari nol, tanpa satu pun pembenaran penulis. Jarak itulah yang membuatnya berguna:
Dalam praktik, reviewer adalah subagent dengan tool read-only dan system prompt yang tajam. Penulis menghasilkan diff; orkestrator menyerahkan diff itu beserta kebutuhan awal ke reviewer; reviewer mengembalikan daftar temuan berperingkat, masing-masing dengan berkas, baris, dan perbaikan.
Definisi reviewer minimal menjaga agen tetap jujur dan keluarannya bisa ditindaklanjuti:
---
name: diff-reviewer
description: Reviews a diff against acceptance criteria, returns ranked findings
tools: Read, Grep, Glob
---
You review a diff, not a plan. You are given the diff and the
acceptance criteria only. Return a ranked list of concrete issues,
each as: file:line — severity — one-line fix. Judge the change
against the criteria, not against how you would have written it.
If the diff meets every criterion, say PASS and stop.Paksa reviewer mengembalikan keluaran terstruktur: daftar berperingkat dengan berkas, baris, tingkat keparahan, dan perbaikan satu baris. Agen yang diminta mereview kode menulis esai; agen yang diminta mengembalikan temuan menulis sesuatu yang bisa ditindaklanjuti penulis di giliran berikutnya.
Pola ini hanya sepadan dengan biayanya ketika review mengumpan balik ke penulisan berikutnya. Loop umpan balik itulah mesin yang membuat kedua peran layak dijalankan:
Karena kedua peran terisolasi, keduanya bisa berjalan sebagai sesi terpisah di git worktree terpisah, sehingga review satu perubahan tumpang tindih dengan penulisan berikutnya. Kerja multi-agen Anthropic sendiri bersandar pada bentuk orchestrator-worker ini, di mana agen utama mengoordinasikan spesialis yang masing-masing memegang sepotong tugas.
Tugas orkestrator adalah menulis kontrak: nyatakan tujuan, batasan, dan bentuk keluaran persis untuk tiap peran. Perlakukan tiap delegasi seperti panggilan API, dan versi paralelnya tetap bisa didebug alih-alih berubah jadi kerumunan agen yang saling melewati.
Reviewer tanpa gigi hanyalah pertunjukan. Jika orkestrator meneruskan tiap temuan tanpa saringan, penulis akan terombang-ambing pada positif palsu dan membakar token; jika ia mengabaikan temuan, review itu sia-sia. Seseorang, manusia atau orkestrator, harus memilah temuan mana yang nyata sebelum loop berputar lagi.
Pola ini kira-kira menggandakan pengeluaran token pada sebuah perubahan, jadi simpan untuk pekerjaan yang bug terlewatnya mahal:
Pola writer-reviewer bukan sekadar fitur melainkan disiplin: jangan pernah biarkan agen yang menulis kode menjadi satu-satunya yang menilainya. Mulailah dengan satu subagent reviewer read-only pada perubahan paling berisiko Anda, jaga keluarannya tetap terstruktur, dan biarkan loop mengubah draf penuh harapan menjadi draf terperiksa.