Setiap kali coding agent menyelesaikan sebuah tugas, celah yang sama selalu terbuka. Anda menerima diff dan ucapan “selesai” yang ceria, tetapi tidak tahu apa yang berubah, apa yang dilewati, apa yang diuji, atau apa yang masih diragukan agent. Akhirnya Anda membaca ulang diff tersebut, menjalankan sendiri pengujiannya, dan mengulang pertanyaan-pertanyaan yang seharusnya sudah dijawab agent saat menyerahkan hasil kerjanya. Jalankan dua agent, biayanya berlipat dua. Pekerjaannya bukan masalah. Yang jadi masalah adalah serah terimanya: apa yang berpindah antara orang yang meminta dan agent yang mengerjakan, serta apa yang kembali.
Template serah terima coding agent adalah struktur tetap untuk apa yang dibawa sebuah tugas saat berpindah tangan: dari orang ke agent saat penugasan, dan dari agent kembali ke orang saat peninjauan. Alih-alih mengimprovisasi bentuk setiap perpindahan, Anda mengisi kolom yang sama setiap kali. Agent tahu apa arti “selesai” sebelum mulai, dan Anda menerima ringkasan, bukti, serta pertanyaan terbuka yang sama saat pekerjaan berhenti.
Artikel ini membahas dua template yang terbukti bertahan dalam praktik, dengan Sharkly sebagai alur kerjanya: lapisan di atas coding agent Anda yang menjaga konteks, progres, penghambat, hasil, dan tinjauan manusia tetap terlihat dari permintaan hingga rilis. Anda sudah punya coding agent. Sharkly mengubahnya menjadi sebuah tim, dan template serah terima inilah yang membuat setiap perpindahan menjadi catatan, bukan tebakan.
Apa itu template serah terima coding agent
Template serah terima adalah daftar periksa yang dibuat terstruktur. Ia menjawab tiga pertanyaan yang tidak pernah dijawab oleh diff mentah: apa yang diminta, apa yang terjadi, dan sekarang giliran siapa. Ketika ketiganya berpindah bersama-sama, pekerja berikutnya cukup membaca satu catatan, bukan menyusun ulang tiga hal.
Ada dua serah terima yang layak dibuat templatenya, karena keduanya berjalan ke arah berlawanan dan membawa hal yang berlawanan pula:
- Serah terima penugasan (dari orang atau Agent pemimpin ke seorang Agent): tujuan, batasan, dan definisi selesai, yang diturunkan sebelum pekerjaan dimulai.
- Serah terima tinjauan (dari Agent kembali ke orang): perubahan, bukti bahwa perubahan itu berfungsi, dan bagian yang masih harus dinilai manusia, yang diserahkan saat pekerjaan berhenti.
Membuat template untuk keduanya adalah intinya. Sebagian besar tim menulis tiket sekadarnya dan tidak membuat template apa pun untuk jalur kembali, sehingga setiap peninjauan dimulai seperti interogasi. Di sinilah waktunya paling banyak terselamatkan: memperbaiki perjalanan pulang.
Model operasional yang diwujudkan oleh template
Sebuah template hanya sebaik model operasional di bawahnya. Empat kata kerja menentukan siapa yang memiliki setiap sambungan: siapa yang menugaskan, siapa yang menjalankan, siapa yang meninjau, siapa yang menerima. Agent meneliti, mengeksekusi, menguji, dan melaporkan. Manusia menetapkan arah, memberi kewenangan, dan menerima hasilnya. Otomatisasi berhenti di titik yang membutuhkan pertimbangan tim.
Kontrak itulah alasan kedua template membawa kolom yang berbeda. Seorang Agent tidak boleh menebak-nebak seperti apa bentuk penerimaan, jadi template penugasan memaksa pihak yang meminta untuk menuliskannya. Seorang manusia tidak boleh menebak-nebak apakah status hijau berarti aman, jadi template tinjauan memaksa Agent menunjukkan cara kerjanya. Berikut serah terima penugasan dalam bentuk blok yang bisa disalin-tempel:
## Assignment handoff
Task ID: SH-###
Goal: one sentence, in plain language
In scope: the specific files, endpoints, or behaviors to touch
Out of scope: what to leave alone (auth, billing, public contracts)
Definition of done:
- [ ] observable acceptance criterion 1
- [ ] observable acceptance criterion 2
Constraints: frameworks, patterns, or limits to respect
Assignee: the exact Agent that owns this
Baris “out of scope” dan “definition of done” yang melakukan kerja beratnya. Tanpa keduanya, agent akan mengoptimalkan diff agar lulus, bukan agar mencapai hasil yang Anda maksud. Dengan keduanya, pemeriksaan penerimaan sudah tertulis sebelum satu baris kode pun ada.
Serah terima tinjauan: apa yang kembali
Template jalur kembali adalah yang paling sering dilewati banyak alur kerja, padahal justru inilah yang menyelamatkan sore Anda. Ketika seorang Agent selesai, ia tidak boleh hanya mengirim pesan “sudah siap” beserta tautan. Ia harus menyerahkan struktur yang sudah terisi:
## Review handoff
Task ID: SH-###
Summary: what changed, in 2-3 sentences
Acceptance: each definition-of-done item, checked with how it was verified
Tests: typecheck / unit / build results, pasted or linked
Diff: the PR or worktree branch
Known limits: what this does NOT cover, and any risky assumption
Open questions: decisions left for a human
Kolom “known limits” dan “open questions” adalah yang membedakan serah terima sungguhan dari sekadar dinding centang hijau. Batasan yang jujur (“penghitung Redis ini mengasumsikan satu region”) mengubah merge yang buta menjadi merge yang terinformasi. Ini prinsip yang sama seperti yang ada di balik meninjau kode buatan AI dengan bukti tingkat tugas: peninjau membaca sebuah klaim beserta buktinya, bukan diff beserta harapan.
Satu batas yang perlu dinyatakan secara tegas: serah terima tinjauan bukanlah permintaan untuk merge. Ia adalah permintaan untuk meninjau. Agent menyajikan; manusia memutuskan. Menjaga kedua tindakan itu tetap terpisah adalah yang mencegah pekerjaan yang belum ditinjau ikut terrilis.
Status dan gerbang tinjauan: tempat template berada
Template yang hanya hidup di buffer riwayat gulir adalah template yang tidak dibaca siapa pun. Serah terima harus melekat pada sesuatu yang dibagikan, dan status adalah tempat alaminya. Setiap Tugas bergerak melalui satu jalur, dan setiap perubahan status adalah serah terima dengan templatenya terlampir:
| Status | Pemilik | Template terlampir |
|---|---|---|
| Todo | Orang atau Agent pemimpin | Serah terima penugasan |
| In progress | Agent | (bekerja di worktree yang terisolasi) |
| Ready for review | Agent | Serah terima tinjauan |
| Done | Orang | catatan penerimaan + keputusan merge |
Aturan yang membuat semuanya mudah dibaca: Agent memindahkan Tugas ke Ready for review; Manusia memindahkannya ke Done. Agent tidak pernah menandai pekerjaannya sendiri sebagai Done, dan manusia tidak perlu menyusun ulang apa yang terjadi, karena serah terima tinjauan sudah ada di Tugas tersebut. Di Sharkly, eksekusi, penghambat, hasil, dan diskusi lanjutan kembali ke linimasa Tugas, sehingga ketika sepuluh agent berjalan, Anda cukup membaca papan, bukan sepuluh terminal. Itulah bedanya antara melacak apa yang diselesaikan agent dan berharap catatan commit menjelaskannya nanti. Di mana pekerjaan otonom harus berhenti juga merupakan keputusan desain tersendiri, yang dibahas dalam di mana gerbang persetujuan perlu ditempatkan.
Contoh nyata: dari tiket hingga PR yang di-merge
Ambil satu Tugas dengan bentuk yang realistis, SH-441: “Tambahkan ekspor CSV ke halaman laporan.” Perhatikan bagaimana templatenya terisi, bukan kodenya.
Seseorang membuka SH-441 dan seorang Agent pemimpin melengkapi serah terima penugasan: tujuan (“biarkan pengguna mengunduh laporan saat ini sebagai CSV”), dalam cakupan (controller laporan dan satu modul ekspor baru), di luar cakupan (auth, kueri laporan yang sudah ada), serta definisi selesai dengan tiga butir yang bisa diperiksa (tombol unduh, escaping yang benar untuk koma dan tanda kutip, dan satu tes dengan fixture 10 ribu baris). Assignee-nya adalah Agent backend. Tidak ada yang ambigu, karena templatenya menolak membiarkannya ambigu.
Agent backend mengambil Tugas itu, bekerja di worktree yang terisolasi agar tidak pernah bertabrakan dengan pekerjaan lain, lalu menjalankan butir-butir definisi selesai sebagai daftar periksa miliknya sendiri. Ketika typecheck, tes unit, dan build sudah hijau, ia memindahkan SH-441 ke Ready for review dengan template jalur kembali yang sudah terisi: ringkasan singkat, setiap butir penerimaan yang dicentang beserta cara verifikasinya, diff-nya, dan satu batasan yang diketahui (“ekspor di atas 100 ribu baris menyangga data di memori; streaming belum diimplementasikan”).
Sekarang serah terimanya berbalik arah. Seseorang membaca satu catatan, bukan riwayat gulir. Mereka memverifikasi tes escaping, menimbang batas memori terhadap ukuran laporan yang nyata, menerimanya untuk saat ini, dan memindahkan SH-441 ke Done, yang memicu merge. Dari tiket hingga PR yang di-merge, dengan template terisi di kedua sambungan dan catatan tentang siapa yang memiliki masing-masing bagian. Inilah jalur dari kebutuhan hingga kode yang dibuat dapat dilacak dari awal sampai akhir.
Kapan template jadi berlebihan
Template punya biaya, jadi inilah pasangan keputusan yang jujur. Lewati template lengkap untuk pekerjaan kecil dan sudah jelas yang bisa diselesaikan satu Agent dalam sekali jalan, ketika tujuan dan kriterianya sudah terlihat jelas dari judul Tugas. Gunakan template begitu pekerjaan melewati sambungan yang penting: beberapa agent pada satu tujuan, perubahan pada kontrak publik, atau apa pun yang menyentuh auth, penagihan, atau data yang sulit ditarik kembali. Template adalah asuransi terhadap konteks yang hilang, dan Anda membeli asuransi pada titik yang kerugiannya paling menyakitkan.
Anda bisa menjalankan semua ini secara manual dengan papan bersama dan kedisiplinan. Cara itu bertahan sampai jumlah agent, tugas, dan repositori meningkat, dan kedisiplinan justru jadi hal pertama yang hilang. Jika Anda sudah menjalankan beberapa agent, Sharkly memberi Anda satu tempat untuk mengelola tugas dan hasil mereka: Tugas bersama yang membawa serah terima penugasan dan tinjauan, Assignee per Tugas, worktree terisolasi, dan jalur status tempat para Agent mencapai Ready for review dan Manusia memutuskan Done. Tetap gunakan coding agent yang sudah Anda pakai. Unduh Sharkly ketika sambungan di antara mereka mulai lebih mahal daripada pekerjaannya sendiri.
FAQ
Apa itu template serah terima coding agent? Ini adalah struktur tetap untuk apa yang dibawa sebuah tugas saat berpindah tangan. Ada dua: serah terima penugasan (tujuan, cakupan, dan definisi selesai, dari orang ke Agent) dan serah terima tinjauan (ringkasan, bukti, dan batasan yang diketahui, dari Agent kembali ke orang). Mengisi kolom yang sama setiap kali itulah yang mencegah konteks menguap di antara para pekerja.
Kenapa jalur kembali harus dibuat template, bukan hanya tiketnya? Sebagian besar tim menulis tiket dan tidak membuat template apa pun untuk jalur kembali, sehingga setiap peninjauan dimulai seperti interogasi. Serah terima tinjauan, dengan ringkasan, butir penerimaan yang sudah diperiksa, dan batasan yang diketahui, adalah tempat template menghemat waktu paling banyak. Lihat coding agent dengan manusia dalam alurnya.
Haruskah agent menandai pekerjaannya sendiri sebagai selesai? Tidak. Biarkan Agent memindahkan Tugas ke Ready for review dengan template jalur kembali yang sudah terisi; serahkan pemindahan ke Done, beserta keputusan merge, kepada manusia. Memisahkan “disajikan” dari “diterima” adalah yang mencegah kode yang belum ditinjau ikut terrilis.
Di mana sebaiknya template disimpan? Di sebuah Tugas bersama, melekat pada perubahan status, bukan di terminal yang hanya dilihat satu agent. Ketika serah terima berupa status dengan templatenya terlampir, pekerja berikutnya langsung melihat apa yang menunggu mereka. Ini juga menjaga tinjauan agar tidak menjadi penghambat ketika banyak agent selesai bersamaan.
Apakah saya perlu alat untuk ini, atau bisa dilakukan manual? Anda bisa menjalankannya dengan papan bersama dan kedisiplinan. Lapisan khusus baru terasa manfaatnya begitu Anda mengoordinasikan banyak agent di banyak repositori dan pelacakan manual justru menjadi pekerjaannya. Bandingkan dengan AI task manager untuk pekerjaan agent yang serbaguna.
