Prinsip dalam Memperbaiki Kode Warisan (Legacy Code) dengan Agen Pengodean AI
makedream2026년 4월 25일
0
Computing/Software
Comments (0)
Log in to leave a comment
No posts yet
makedreammakedreamLog in to leave a comment
No posts yet
Membiarkan agen berkeliaran di komputer Anda itu berbahaya. Terutama jika Anda membiarkan kunci API terbuka di variabel lingkungan, ada kemungkinan agen tidak sengaja mencatat kunci tersebut ke dalam log atau mengirimkannya ke pihak luar. Gunakan 1Password CLI. Ini adalah metode di mana kunci hanya dimasukkan ke dalam memori untuk sementara saat perintah dijalankan.
Untuk mencegah agen menyentuh file inti secara tidak sengaja, Anda harus mengisolasi sistem file. Buat file .cursorignore dan hapus kunci SSH, hasil build, dan file konfigurasi sensitif dari daftar. Hanya dengan meletakkan file ini di root proyek, kemungkinan agen memodifikasi file yang salah akan berkurang sebesar 80 persen. Jika memungkinkan, jalankan agen di dalam kontainer Docker. Ini adalah cara paling pasti untuk mencegah agen menyentuh sistem host secara langsung.
Jika Anda membiarkan agen membaca seluruh proyek, biaya API bulanan akan membengkak tak terkendali. Terutama membiarkan agen membaca folder node_modules atau .git adalah tindakan yang membuang-buang uang.
Berikan hanya kode yang diperlukan kepada agen. Semakin besar skala proyek, semakin penting untuk mempersempit cakupan pengindeksan. Jika menggunakan Aider, periksa berapa banyak yang Anda gunakan secara waktu nyata dengan perintah /tokens. File yang pekerjaannya sudah selesai harus segera dikeluarkan dari konteks dengan perintah /drop. Hanya dengan melakukan ini, Anda dapat mengurangi konsumsi token yang tidak perlu hingga lebih dari 70 persen. Jika Anda memilih model yang mendukung context caching dari Anthropic, Anda bisa mendapatkan diskon tambahan sekitar 75 persen untuk struktur kode yang berulang, jadi periksa tagihan API Anda dan pertimbangkan untuk mengganti model.
Kode warisan (legacy code) memiliki ketergantungan yang rumit, sehingga jika Anda menyerahkannya begitu saja kepada agen, seluruh sistem bisa rusak. Jangan suruh agen menulis kode secara membabi buta. Anda harus memberikan konteks kepada agen dengan menggunakan tag XML. Tuliskan dengan jelas fungsi mana yang akan diperbaiki dan aturan apa yang harus dipatuhi.
Jangan langsung melakukan merge pada kode. Paksa agen untuk memberikan rencana perbaikan terlebih dahulu. Ini adalah cara di mana pengembang harus menyetujui rencana tersebut sebelum agen diizinkan menulis kode. Pastikan untuk menjalankan kode yang telah diperbaiki oleh agen di lingkungan pengujian lokal. Jika Anda melemparkan log kegagalan CI kembali ke agen, ia akan memperbaiki bug dengan sendirinya. Ada hasil penelitian yang menunjukkan bahwa melalui proses ini, kesalahan dapat diperbaiki dengan probabilitas 84 persen tanpa intervensi tambahan.
Jika Anda ingin memeriksa seberapa cepat Anda dengan penerapan agen, lupakan kecepatan penulisan kode. Cycle time adalah kuncinya. Anda harus mengukur total waktu yang dibutuhkan mulai dari penulisan kode, peninjauan (review), perbaikan, hingga penyebaran (deployment).
Pertama, catat berapa hari yang dibutuhkan dari commit pertama hingga penyebaran nyata dalam proyek saat ini. Kesalahan yang berulang kali dilakukan oleh agen harus dirangkum dalam file AGENTS.md dan dijadikan sebagai konvensi pengodean. Jika ada modul di mana kualitas kode yang ditulis AI secara khusus rendah, itu bukan kesalahan AI, melainkan masalah struktur sistem. Periksa rasio pengerjaan ulang (rework) per PR setiap minggu. Alat hanyalah alat. Memperlakukan agen sebagai rekan kerja dan menyesuaikan infrastruktur agar sesuai dengan alur kerja tim adalah hal yang menentukan daya saing tim pengembang.