Cara Antisipasi, Perbaiki,
dan Memetakan Technical Debt dalam Vibecoding
Panduan praktis mengaudit project hasil vibecoding, menilai risiko tiap temuan, dan menyusun roadmap pembayaran hutang teknis sebelum customer pertama datang.
10
agen audit paralel
6
domain yang dicek
2
project production nyata
Ditulis oleh Anjrah Ari Susanto, S.Psi.
Founder & Pengajar Alanotech
Ringkasan Cepat
Technical debt adalah biaya perawatan yang menumpuk karena keputusan cepat saat membangun software. Di era vibecoding, AI menulis kode sepuluh kali lebih cepat, dan hutang teknis ikut menumpuk sepuluh kali lebih cepat. Cara mengatasinya bukan berhenti memakai AI, melainkan mengaudit enam domain (security, database, clean code, UI/UX, routing, SEO/infra), menilai tiap temuan dengan matriks severity dan blast radius, lalu membayar hutang lewat quick win dulu sebelum refactor besar. Artikel ini membedah metodologi audit nyata terhadap dua project SaaS production hasil vibecoding, lengkap dengan prompt audit dan aturan AI yang bisa langsung di-copy.
Ibaratnya
Hutang Teknis itu Seperti Kartu Kredit
Ward Cunningham, penemu wiki pertama, yang menciptakan istilah technical debt. Analoginya sederhana dan masih akurat sampai sekarang.
| Kartu kredit | Technical debt |
|---|---|
| Tarik tunai cepat, langsung bisa dipakai | AI generate fitur, langsung jalan hari itu juga |
| Bunga jalan terus walau tidak dipakai | Bug, lambat, dan takut edit muncul walau fitur tidak ditambah |
| Bayar minimum = cicil pokok sedikit | Patch gejala, akar masalah dibiarkan |
| Gali lubang tutup lubang | Hack di atas hack, sampai takut sentuh file sendiri |
| Lunas = bebas | Refactor tuntas = fitur baru cepat lagi |
Hutang itu sendiri tidak jahat. Berhutang untuk meluncurkan lebih cepat adalah strategi yang sah. Yang jahat adalah hutang yang tidak dicatat, tidak dihitung bunganya, dan tidak pernah dibayar.
Navigasi
Daftar Isi Artikel
Delapan bab dari memahami hutang sampai mencegahnya sejak hari pertama.
Apa Itu Technical Debt dan Kenapa Vibecoding Beda
Technical debt adalah setiap keputusan teknis yang membuat software jalan hari ini, tapi menagih biaya perawatan besok. Bentuknya banyak. File yang membengkak jadi ribuan baris, query yang memindai seluruh tabel tiap kali dipanggil, endpoint yang tidak memeriksa pemilik data, framework yang sudah tidak menerima patch keamanan.
Di era coding manual, hutang menumpuk perlahan karena programmer menulis seratus sampai seribu baris sehari. Di era vibecoding, AI menulis ribuan baris dalam satu sesi prompting. Kecepatannya luar biasa, dan itu justru masalahnya. AI menulis apa yang Anda minta, bukan apa yang Anda butuhkan untuk tiga tahun ke depan. Ia tidak tahu endpoint yang baru saja ia buat akan membocorkan secret lewat parameter URL. Ia tidak tahu fungsi checkout yang ia tulis akan dipanggil seribu kali sehari oleh pelanggan nyata.
Hasilnya adalah pola yang sekarang kami lihat berulang di project hasil vibecoding. Fitur lengkap dan terlihat matang di permukaan, tapi fondasinya rapuh di titik-titik yang tidak terlihat sampai audit dilakukan. Bukan karena AI-nya bodoh, melainkan karena konteks bisnis, skala, dan keamanan tidak pernah ada di prompt.
Prinsip yang perlu dipegang
AI mempercepat penulisan kode, bukan menggantikan tanggung jawab arsitektur. Siapa pun yang mem-prompt tetap pemilik risiko. Technical debt di vibecoding bukan kegagalan, melainkan konsekuensi natural yang harus dikelola sadar.
Studi Kasus Audit Nyata Dua Project Production
Minggu ini kami menjalankan audit menyeluruh terhadap dua project SaaS production yang dibangun sebagian besar lewat vibecoding. Project pertama adalah platform checkout builder tempat member membuat halaman jualan di subdomain sendiri, stack-nya framework PHP lawas ditambah SPA Vue. Project kedua adalah platform edukasi dan membership dengan stack Laravel modern, payment gateway, dan area kursus.
Metodenya sederhana dan bisa ditiru siapa pun. Kami mengerahkan sepuluh agen AI read-only secara paralel, masing-masing diberi satu domain audit, satu codebase, dan format laporan yang sama. Tiap temuan wajib menyertakan lokasi, tingkat keparahan, dampak di skala seribu customer, dan saran satu kalimat. Detail kode sensitif tidak pernah ditampilkan.
Hasilnya mengejutkan sekaligus melegakan. Mengejutkan karena temuan serius ada di kedua project meski keduanya sudah dipakai produksi. Melegakan karena sebagian besar bisa ditambal dalam hitungan hari, bukan bulan.
Temuan paling berat di masing-masing project
Di platform checkout builder, tiga temuan level high langsung teridentifikasi. Pertama, secret member pernah dikirim lewat query string dalam bentuk base64 statis yang tidak pernah kedaluwarsa, artinya link tersebut tercatat di log server dan bisa dipakai siapa pun selamanya. Kedua, output halaman checkout tidak di-escape, membuka pintu stored XSS di halaman yang memproses uang pembeli. Ketiga, update sub-resource produk tidak memverifikasi kepemilikan, sehingga ID anak milik member lain bisa ditimpa lewat payload sendiri.
Di platform edukasi, temuan terberat berbeda jenisnya. Panel admin tidak memiliki policy untuk mayoritas resource, sehingga semua role yang diizinkan masuk panel bisa membuka data customer, invoice, dan halaman berisi credential payment gateway. Selain itu halaman redirect publik merender data pribadi lead lewat ID sekuensial, membuka enumerasi seluruh database lead. Ada juga race condition pada callback pembayaran dan klaim slot kelas yang bisa membuat fulfillment terkirim dua kali atau seat terjual melebihi kuota.
Pelajaran penting dari hasil audit
Kedua project lolos uji fungsional harian dan kelihatan sehat dari luar. Semua temuan berat tadi tidak pernah muncul sebagai error. Mereka hanya muncul saat seseorang atau sesuatu sengaja membacanya dengan kacamata audit. Inilah kenapa technical debt berbahaya, ia diam sampai menjadi insiden.
Enam Domain yang Wajib Diaudit
Audit yang berguna harus menyapu enam domain ini. Melewatkan satu saja berarti ada kelas risiko yang tidak pernah diukur.
1. Keamanan
- SQL injection pada query manual dan kolom sortir dari input user
- IDOR, akses resource orang lain hanya dengan mengganti ID
- XSS, output data user tanpa escape di halaman publik dan admin
- Secret di URL, log, atau bundle frontend yang bisa dibaca siapa pun
- Webhook payment tanpa verifikasi signature dan idempotensi
- Panel admin tanpa pembatasan role
2. Database dan skalabilitas
- Query berbentuk fungsi tanggal di klausa WHERE sehingga index tidak terpakai
- N+1, query di dalam loop yang mengalikan beban dengan jumlah data
- Tabel log dan dedup yang tumbuh selamanya tanpa purge
- Multi-write tanpa transaksi, order plus stok plus komisi yang bisa setengah jadi
- Race condition stok dan slot saat dua transaksi bersamaan
3. Clean code
- File monster di atas seribu baris, apalagi yang menangani jalur uang
- Duplikasi logic di banyak lokasi, termasuk duplikasi lintas repo
- Dead code, file backup, artefak build lama, dan endpoint tanpa pemanggil
- Framework EOL dan dependency yang sudah tidak dipelihara
4. UI dan UX
- Tabel dan DataTables yang memaksa horizontal scroll di HP
- Aksi penting tanpa pesan error saat jaringan gagal
- Komponen dan sistem desain yang duplikat atau saling bertentangan
- Klaim fitur yang tidak benar, misalnya halaman yang bilang auto-update tapi tidak pernah memeriksa status
5. Routing
- Endpoint mutasi yang menerima GET
- Framework default routing yang membuka semua method publik
- Route tanpa throttle di login, kontak, dan form publik
- Endpoint publik versus protected yang tidak terdokumentasi
6. SEO dan infrastruktur
- Sitemap, canonical, noindex yang tidak konsisten dengan niat halaman
- Subdomain member yang auto-index dan berisiko jadi konten farm di mata Google
- Security header, rate limit, dan cache statis di layer nginx
- Backup yang tidak pernah diuji restore, log tanpa rotasi, cron tanpa lock
- Single point of failure, satu mesin untuk web plus database plus queue
Cara cepat memulainya
Kerahkan satu agen AI per domain dengan format laporan yang sama, wajibkan lokasi plus severity plus dampak di skala target, dan minta mereka hanya membaca, tidak mengubah apa pun. Setelah itu Anda sendiri memverifikasi temuan kunci dengan curl, query database, dan cek service. Audit berbasis baca-saja ini aman dijalankan di production.
Prompt audit siap copy
Metodologi tadi bisa langsung dijalankan lewat prompt ini. Copy sekali, ganti bagian dalam kurung siku, lalu tembak satu agen per domain atau beberapa sekaligus kalau tool Anda mendukung paralel.
Kamu adalah auditor kode read-only untuk project ini. Audit codebase untuk domain [NAMA DOMAIN].
Yang wajib dicek
- [Tempel checklist domain terkait dari bab empat artikel ini]
Aturan main
- Hanya membaca. Dilarang mengubah, menghapus, atau menjalankan kode apa pun.
- Tiap temuan wajib menyertakan lokasi file atau route, tingkat keparahan (critical, high, medium, low), dampak bila dipakai seribu customer, dan saran perbaikan satu kalimat.
- Jangan pernah menampilkan isi credential, secret, atau data pribadi di laporan.
- Kalau ragu memilih tingkat keparahan, pilih yang lebih rendah dan jelaskan alasannya.
Enam domain yang diaudit, satu prompt per domain
1. Keamanan
2. Database dan skalabilitas
3. Clean code
4. UI dan UX
5. Routing
6. SEO dan infrastruktur
Cara Menilai Risiko Tiap Temuan
Daftar temuan mentah tidak berguna tanpa bobot. Kami menilai tiap hutang dengan tiga pertanyaan. Seberapa parah dampaknya bila terjadi, seberapa mungkin terjadi, dan seberapa luas ledakannya bila pecah. Gabungan tiga itu menghasilkan empat tingkat.
| Tingkat | Ciri | Contoh nyata dari audit | Aksi |
|---|---|---|---|
| Critical | Kebocoran data atau uang, bisa terjadi sekarang | Panel admin tanpa policy, PII lead terekspos via ID sekuensial | Perbaiki minggu ini, sebelum fitur baru |
| High | Insiden nyata menunggu volume atau satu celah | Stored XSS di checkout, race condition pembayaran, subdomain farm auto-index | Masuk sprint berjalan, batasi 1-2 item |
| Medium | Memperlambat tim atau membesar diam-diam | Cron non-sargable, tabel tumbuh tanpa purge, file monster | Jadwalkan per kuartal, kerjakan saat menyentuh area terkait |
| Low | Ketidakrapihan tanpa dampak langsung | Naming inkonsisten, komentar usang, dead code kecil | Catat, bereskan opportunistik |
Dua trik yang sering dilewatkan. Pertama, severity bukan popularitas. File 9.700 baris terasa menyeramkan tapi risikonya medium karena masih berjalan, sementara satu output tanpa escape di halaman pembayaran adalah high walau cuma satu baris. Kedua, kalikan dengan blast radius. Bug di halaman checkout memukul semua member sekaligus, bug di halaman setting pribadi hanya satu akun.
Yang tidak kalah penting, verifikasi sebelum percaya. Dalam audit ini dua klaim sub-agen terbukti keliru saat dicek langsung. Satu melaporkan security header hilang padahal sudah ada lewat middleware, satu melaporkan Redis memakai policy evict padahal konfigurasi aktual noeviction. Agen AI membaca kode, Anda yang membaca kenyataan. Angka live dari curl, query database, dan status service adalah pengadil terakhir.
Roadmap Membayar Hutang Tanpa Membekukan Fitur
Kesalahan umum adalah reaksi all-or-nothing. Entah mengabaikan semuanya, atau menghentikan semua fitur sebulan penuh untuk refactor. Dua-duanya salah. Roadmap yang bertahan terdiri dari tiga jalur paralel.
Jalur satu, quick win minggu ini
Semua temuan critical dan high yang perbaikannya kecil. Tambahkan policy ke resource admin, escape output di halaman pembayaran, scope-kan update ke pemilik record, throttle endpoint login, hapus secret dari URL. Masing-masing hitungan jam sampai satu hari, dan menghapus risiko terbesar lebih dulu.
Jalur dua, bayar sambil jalan
Untuk debt medium, pakai aturan boy scout. Setiap kali menyentuh file untuk fitur atau bug, rapikan satu hal di sekitarnya. Menyentuh cron, perbaiki query non-sargable-nya. Menyentuh komponen besar, ekstrak satu bagian jadi komponen kecil. Dalam enam bulan file monster menyusut tanpa ada satu sprint pun yang dikorbankan khusus refactor.
Jalur tiga, proyek struktural yang memang perlu
Sedikit hutang yang butuh proyek sendiri. Framework EOL yang harus naik kelas, duplikasi logic lintas repo, konsolidasi empat implementasi webhook menjadi satu service. Jadwalkan satu proyek struktural per kuartal, pilih yang membuka jalan untuk debt lain. Bukan yang paling besar, tapi yang paling membuka.
Aturan prioritas sederhana
Jalur uang dan jalur data pribadi didahulukan. Halaman checkout, callback pembayaran, credential, dan data identitas selalu menang atas kerapian kode mana pun. Setelah itu baru hal yang memperlambat tim, lalu yang sekadar tidak enak dilihat.
Cara Antisipasi Sejak Hari Pertama
Hutang termurah adalah yang tidak pernah dibuat. Lima kebiasaan ini menekan laju penumpukan hutang tanpa mengorbankan kecepatan vibecoding.
- Pasang aturan tertulis untuk AI. File AGENTS.md atau rules setara di root project berisi larangan, konvensi, dan konteks bisnis. AI yang tahu aturannya memproduksi lebih sedikit hutang dari awal. Tanpa ini, setiap sesi baru mengarang konvensi sendiri.
- Pelihara dokumen tracking. File sprint, task berikutnya, dan keputusan arsitektur membuat sesi AI berikutnya melanjutkan alur, bukan memulai dari nol. Ini menjawab masalah konteks hilang di poin dua.
- Verifikasi, jangan percaya. Setiap klaim jalan harus dibuktikan dengan curl, query, atau test. Termasuk klaim dari audit AI itu sendiri.
- Jaga file tetap kecil. Tetapkan batas mental, misalnya delapan ratus baris. Saat lewat, pecah saat itu juga karena menunggu berarti file itu tumbuh jadi monster.
- Audit berkala, bukan sekali seumur. Audit ringan per kuartal dengan cara yang sama seperti artikel ini. Hutang terdeteksi saat masih kecil selalu lebih murah dibayar.
Vibecoding tidak salah. Yang salah adalah memakainya tanpa disiplin yang sama seperti saat coding manual. AI adalah magang tercepat di dunia, dan magang cepat butuh senior yang rajin review. Audit enam domain, penilaian risiko empat tingkat, dan roadmap tiga jalur adalah bentuk review itu.
Contoh aturan tertulis yang bisa langsung dipakai
File aturan tidak harus panjang. Yang penting larangan, konvensi, dan konteks bisnis tercatat. Blok ini bisa langsung di-copy ke AGENTS.md di root project lalu disesuaikan.
# Aturan Project
## Larangan
- Dilarang menaruh credential, API key, atau password di kode. Semua secret lewat environment variable.
- Dilarang membuat endpoint mutasi yang menerima GET.
- Dilarang commit file backup, log, cache, atau file percobaan.
- Dilarang mengubah struktur database tanpa migration baru.
## Konvensi
- Satu file satu tanggung jawab. File yang mendekati 800 baris wajib dipecah.
- Sebelum menulis fungsi baru, cek dulu apakah fungsi serupa sudah ada.
- Semua output ke browser wajib di-escape.
- Semua akses data milik user wajib diverifikasi kepemilikannya, bukan hanya cek login.
- Penulisan ke lebih dari satu tabel wajib dibungkus transaksi.
## Konteks bisnis
- [Isi satu paragraf project ini apa, siapa usernya, dan di mana aliran uangnya]
- Jalur yang menyentuh uang dan data pribadi adalah prioritas keamanan tertinggi.
## Wajib sebelum menganggap selesai
- Verifikasi fitur benar-benar jalan dengan menjalankannya, bukan hanya mengklaim.
- Pastikan tidak ada fitur lama yang rusak.
Template prompt saat minta fitur baru
Kebiasaan yang tidak kalah efektif adalah menempel checklist keamanan di setiap prompt fitur. Simpan blok ini sekali, lalu pakai ulang setiap kali meminta fitur atau menu baru.
Implementasikan fitur [NAMA FITUR] dengan aturan berikut.
- Ikuti konvensi yang sudah ada di project ini, jangan mengarang pola baru.
- Semua input dari luar wajib divalidasi dan semua output ke browser wajib di-escape.
- Setiap akses data user wajib diverifikasi kepemilikannya, bukan hanya cek login.
- Penulisan ke lebih dari satu tabel wajib dibungkus transaksi.
- Endpoint publik wajib punya rate limit.
- Tangani skenario gagal, bukan hanya happy path. Timeout, jaringan putus, dan input kosong harus punya respons yang jelas.
- Setelah selesai, buktikan fitur jalan dengan menjalankannya, jangan hanya mengklaim.
- Kalau ada bagian requirement yang ambigu, tanya dulu sebelum mengarang.
Penutup
Seribu customer tidak akan peduli stack apa yang Anda pakai atau prompt apa yang menulisnya. Mereka peduli checkout tidak gagal, data mereka tidak bocor, dan halaman terbuka cepat di HP. Bayar hutang teknis selagi bunganya masih kecil, dan biarkan kecepatan AI menjadi keunggulan, bukan bom waktu.
Ditulis Oleh
Anjrah Ari Susanto, S.Psi.
Praktisi yang membangun dan mengoperasikan beberapa SaaS production dengan vibecoding. Pengajar Private Vibecoding di Alanotech, membantu pegiat digital membangun software sendiri dengan bantuan AI tanpa kehilangan kendali atas kualitas dan keamanannya.
Baca Juga
Artikel Terkait
AEOS Core, Panduan Lengkap Memahami Vibecoding
Fondasi berpikir sebelum mulai membangun software dengan AI.
Project Brain AEOS, 5 File Otak Setiap Project Vibecoding
Dokumen tracking yang menjaga konteks antar sesi AI.
Product Planning AEOS, Berpikir Sebelum Ngoding
Cara merencanakan fitur agar AI tidak menulis yang tidak perlu.
Membangun Website Membership Sendiri dengan Laravel
Studi kasus membangun platform membership dari ide kosong.
CSS Framework Siap Pakai untuk Vibecoding Pemula
Pilihan framework dari Laravel sampai React untuk pemula.
VPS atau Hosting, Panduan Memilih Buat Pemula dan AI
Keputusan infrastruktur pertama yang menentukan skala.
Audit rutin adalah bagian dari disiplin engineering, bukan tanda project Anda gagal.