Lewati ke konten utama
AI & VIBECODING

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

Anjrah Ari Susanto, S.Psi.

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.

technical debt vibecoding audit keamanan skalabilitas ai agent refactoring code review

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 kreditTechnical debt
Tarik tunai cepat, langsung bisa dipakaiAI generate fitur, langsung jalan hari itu juga
Bunga jalan terus walau tidak dipakaiBug, lambat, dan takut edit muncul walau fitur tidak ditambah
Bayar minimum = cicil pokok sedikitPatch gejala, akar masalah dibiarkan
Gali lubang tutup lubangHack di atas hack, sampai takut sentuh file sendiri
Lunas = bebasRefactor 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.

01

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.

◆
02

Kenapa Vibecoding Menumpuk Hutang Lebih Cepat

Ada lima mekanisme yang membuat vibecoding memproduksi hutang lebih cepat dari coding konvensional.

  • AI mengulang, bukan merefaktor. Minta fitur baru dan AI cenderung menulis blok baru daripada merapikan yang lama. Dalam audit kami, blok subscribe email yang sama ter-copy ke sepuluh lokasi berbeda karena setiap kali diminta, AI menulis ulang daripada memakai fungsi yang sudah ada.
  • File tidak pernah dipecah. AI nyaman mengedit file yang sudah ada, jadi satu file menampung semua tanggung jawab. Kami menemukan komponen Vue 9.700 baris dan fungsi PHP 1.500 baris, keduanya hasil sesi prompting berturut-turut yang tidak pernah berhenti untuk dipecah.
  • AI tidak membaca seluruh repo. Ia bekerja dari konteks yang Anda berikan. Endpoint duplikat, naming inkonsisten, dan logic yang bertentangan antar file lolos karena tidak ada yang melihat keseluruhan gambar.
  • Happy path first. Kode hasil prompt hampir selalu menangani skenario sukses duluan. Gagal jaringan di tombol checkout, race condition saat dua pembeli bersamaan, dan input jahat adalah bagian yang tidak pernah diprompt.
  • Sesi hilang, konteks hilang. Tiap sesi AI baru mulai dari nol. Tanpa dokumen tracking, keputusan kemarin diulang dengan cara berbeda hari ini. Inkonsistensi menumpuk tanpa ada yang sadar.

Kelima mekanisme ini bukan alasan berhenti vibecoding. Ini daftar hal yang harus dicek berkala, persis seperti servis berkala kendaraan yang dipakai tiap hari.

◆
03

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.

◆
04

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
◆
05

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.

TingkatCiriContoh nyata dari auditAksi
CriticalKebocoran data atau uang, bisa terjadi sekarangPanel admin tanpa policy, PII lead terekspos via ID sekuensialPerbaiki minggu ini, sebelum fitur baru
HighInsiden nyata menunggu volume atau satu celahStored XSS di checkout, race condition pembayaran, subdomain farm auto-indexMasuk sprint berjalan, batasi 1-2 item
MediumMemperlambat tim atau membesar diam-diamCron non-sargable, tabel tumbuh tanpa purge, file monsterJadwalkan per kuartal, kerjakan saat menyentuh area terkait
LowKetidakrapihan tanpa dampak langsungNaming inkonsisten, komentar usang, dead code kecilCatat, 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.

◆
06

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.

◆
07

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.
◆
08

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.

Anjrah Ari Susanto, S.Psi.

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.

vibecoding saas builder laravel ai workflow