Cara Praktis Menggunakan Agen untuk Menganalisis Kode Basis Warisan (Legacy Codebase)
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
Seorang insinyur yang menangani proyek warisan (legacy) berskala besar menghabiskan waktu 2 jam setiap hari untuk membedah tumpukan kode. Metode mengejar string dengan grep kini telah mencapai batasnya. Meskipun ingin mengadopsi agen AI, kenyataannya banyak yang bingung bagaimana cara mengintegrasikannya ke dalam alur kerja. Tulisan ini membahas prosedur teknis konkret untuk menjadikan agen bukan sekadar chat bot, melainkan alat untuk meningkatkan produktivitas kerja.
Jika Anda memberikan seluruh basis kode kepada agen, konteksnya akan tercemar. Mempelajari data yang tidak perlu akan menghasilkan jawaban yang melenceng dan hanya membuang-buang biaya token. Mempersempit cakupan pengindeksan saja sudah cukup untuk membuat kecepatan respons terasa jauh lebih cepat.
Segera terapkan 3 hal berikut:
.cursorignore di direktori root proyek. Kecualikan artefak build yang besar seperti /dist, /build, /target, dan node_modules tanpa kompromi.*.gen.ts yang dibuat secara otomatis. Ini dapat mencegah agen menghasilkan kode yang mengabaikan kompatibilitas mundur.Pencarian berbasis teks tidak akan pernah bisa menemukan hubungan pewarisan (inheritance) yang kompleks. Anda perlu menganalisis Abstract Syntax Tree (AST) dari kode tersebut dengan alat seperti ast-grep. Jika Anda memasukkan ini ke dalam prompt, Anda dapat membuat kueri yang jauh lebih canggih daripada pencarian sederhana.
ast-grep.@codebase dan pola ini bersama-sama kepada agen. Pada tahap ini, tambahkan instruksi untuk mempersempit cakupan agar hanya mencari hubungan pewarisan antar modul internal dan mengabaikan pustaka eksternal.Perbaikan yang disarankan oleh AI setengahnya mengandung eror. Jika Anda langsung menggabungkannya (merge), utang teknis hanya akan menumpuk. Tanamkan Test Impact Analysis (TIA) ke dalam pipeline CI Anda untuk mengotomatisasi siklus verifikasi.
--findRelatedTests pada Jest.Dengan membangun siklus ini, Anda dapat meningkatkan akurasi validasi sintaks secara signifikan. Anda tidak perlu membuang semua toolchain yang ada. ripgrep masih lebih cepat 10 kali lipat daripada agen untuk pencarian sederhana. Memisahkan peran sesuai dengan karakteristik alat adalah tugas yang sebenarnya dari seorang insinyur senior.