Tulis sendiri deskripsi commit-mu, meski agent yang menulis kodenya

Seorang developer yang menulis di yedhu.me mengajukan argumen sederhana tapi praktis lewat tulisan ini: meski agent yang menulis kodemu, kamu tetap sebaiknya menulis deskripsi commit sendiri. Alasannya, badan commit yang baik tak pernah soal mencatat apa yang berubah, karena diff sudah menunjukkannya, tapi soal menjelaskan kenapa, sekaligus memaksamu memastikan bahwa kamu benar-benar paham perubahan itu. Sebelum ada agent, penulisnya menghabiskan lima sampai sepuluh menit untuk ini, mengumpulkan konteks yang berserakan dan menimbang keputusan.

Agent merusak kebiasaan ini diam-diam. Mereka bisa menghasilkan pesan commit yang terdengar masuk akal, tapi tak punya konteks yang tersebar di chat, tiket, dan obrolan sekilas, sehingga alasan yang mereka buat bisa mengada-ada dan kadang bertentangan dengan pendorong sebenarnya. Menulisnya sendiri adalah uji yang murah: kalau kamu tak bisa menjelaskan perubahannya, berarti kamu belum cukup paham untuk merilisnya. Tulisan itu menyoroti satu jenis catatan yang hampir tak pernah ditangkap agent, yaitu keputusan sementara dengan syarat berakhir, ditulis seperti "saya melakukan ini sampai kita...", yang merekam kenapa sebuah workaround ada dan kapan seharusnya dihapus. Baris seperti itu jarang tersimpan di tempat lain, dan justru itulah yang dibutuhkan orang yang merawat kode nanti.

Kenapa ini penting

Kalau kamu bekerja dengan coding agent, memegang sendiri deskripsi commit adalah cara cepat menangkap perubahan yang tampak benar tapi meleset dari maksudnya, sekaligus meninggalkan alasan yang tak mungkin diketahui agent.