Seni Refactoring Codebase Legacy Tanpa Mengundang Bencana
Refactoring bukan cuma soal merapikan fungsi, tapi soal urutan berpikir: pahami konteks, pasang jaring pengaman, dan hadirkan empati lewat PR kecil.
Beberapa hari lalu, Tech Lead-ku mengirimkan sebuah pesan di chat tim yang terus mengendap di kepalaku sampai sekarang:
"…we can start look over the tests and consistency of code and architecture, are there pieces which should be moved around following the Clean Architecture already going on? Where are the technical debts? First thing should be for us to clean up the project to more easily grasp what is going on, but to do this we also need to be wary not to break anything, hence write tests first and make good arguments in PRs to why the changes are made, and make them PRs small and easy to digest for the developers already in the project."
Kodenya sendiri tidak rumit. Yang terus kupikirkan adalah urutan berpikir yang beliau tekankan sebelum kita menyentuh keyboard.
Konteksnya: sebuah library Kotlin Multiplatform yang sudah berumur, menopang Android, iOS, sampai backend, dan dikerjakan banyak orang. Tim sedang migrasi perlahan menuju Clean Architecture.
Saat dihadapkan kode lama yang berantakan, refleks pertama kebanyakan developer adalah langsung bersihkan sekarang juga. Tanpa urutan yang benar, refactoring bisa berubah jadi bencana.
1. Pahami Dulu, Baru Ubah
Sebelum meributkan clean code, test coverage, atau arsitektur idaman, tanyakan dulu: apa tujuan kode ini dibuat, dan siapa yang memakainya?
Pertanyaan ini paling sering diabaikan saat ego teknis kita tersulut lihat kode jelek. Tanpa memahami konteks bisnis dan kompromi masa lalu di balik kode itu, refactor kita berisiko merusak keputusan desain yang sebenarnya sengaja dibuat.
Setelah paham alur komunikasi sistem, kita bisa menilai mana test yang absennya berbahaya, di mana letak inkonsistensi penulisan, dan komponen mana yang layak dipindah rumah.
2. Memetakan Technical Debt Secara Presisi
Seperti disinggung di chat tadi ("Where are the technical debts?"): bilang "project ini penuh utang teknis" itu gampang dan murah. Yang sulit adalah menunjuk hidungnya.
Technical debt yang berguna adalah utang yang punya alamat jelas. Bagian mana yang melanggar batas arsitektur? File mana yang menyembunyikan side effect? Kalau kita belum bisa menunjuk lokasinya secara rinci, kita belum paham masalahnya.
3. Goal Pertama: Buat Kode Mudah Dipahami
Lupakan ambisi 100% Clean Architecture dalam satu sprint. Target seperti itu hampir selalu berakhir kegagalan atau burnout.
Goal yang realistis, seperti pesan Lead-ku: buat codebase itu lebih mudah dibaca daripada saat kita pertama kali membukanya. Ketika alurnya transparan, biaya perbaikan di masa depan turun dengan sendirinya.
4. Jaring Pengaman: Test Dulu, Refactor Kemudian
Goal utama kita adalah memperjelas alur tanpa mengubah perilaku sistem. Risiko merusak feature yang sudah jalan di production tinggi kalau urutannya dibalik.
- Tulis test dulu untuk mengunci perilaku kode saat ini.
- Refactor dengan test itu sebagai jaring pengaman.
- Sertakan alasan kuat di deskripsi Pull Request.
- Pecah PR jadi porsi-porsi kecil.
Di lapangan, orang kerap terburu-buru merapikan kode dan baru panik menulis test ketika aplikasi crash di tangan user. Test-driven refactoring itu asuransi, bukan formalitas.
5. PR Kecil Adalah Bentuk Empati
Poin terakhir dari chat itu yang paling membekas: Pull Request yang baik menghargai waktu rekan tim.
Refactor bukan soal membuat kode tampak indah di mata kita sendiri. Ini soal kemudahan orang lain meninjau, memahami, dan memeliharanya di kemudian hari.
PR raksasa yang mengubah puluhan file sekaligus biasanya ditolak karena membingungkan, atau di-approve asal-asalan karena reviewer sudah lelah scrolling. PR yang kecil, terfokus, dengan alasan yang jernih adalah bentuk hormat tertinggi pada rekan satu tim.
Pelajaran Penting
Pesan dari Lead-ku memberi urutan berpikir yang berlaku untuk project apa pun dengan jejak sejarah panjang: pahami konteks, petakan utang, tulis test, refactor pelan-pelan, ajukan PR kecil.
Perbaikan kode paling berharga bukan perubahan besar yang dramatis. Itu perubahan kecil yang bisa dipercaya tim, dan dilanjutkan dengan tenang setelah kita pindah ke task berikutnya.