Panduan AI Coding

Cara Debugging Kode dengan AI secara Terarah

AI dapat membantu menelusuri bug ketika kamu memberikan bukti yang cukup: pesan error lengkap, perilaku yang diharapkan, langkah untuk mengulang masalah, serta kode yang terkait. Panduan ini menunjukkan cara menyusun permintaan debugging yang bisa diverifikasi.

Monvira AI••7 menit baca

Debugging bukan hanya mencari baris yang terlihat salah. Kamu perlu memahami gejala, mengetahui kapan masalah muncul, membandingkan hasil aktual dengan hasil yang diharapkan, lalu menguji hipotesis penyebabnya.

Monvira menyediakan bantuan coding melalui percakapan AI Go. Kamu dapat menempel kode, membagikan log, menjelaskan struktur proyek, atau melampirkan file yang didukung. Monvira dapat menyarankan analisis dan perubahan, tetapi tidak berarti kode tersebut sudah dijalankan di server atau komputermu.

Ringkasan langkah

  1. 1

    Catat gejala dan hasil yang diharapkan

    Tuliskan apa yang terjadi, apa yang seharusnya terjadi, dan kapan masalah mulai muncul.

  2. 2

    Kumpulkan error dan langkah reproduksi

    Sertakan pesan error lengkap, stack trace, perintah yang dijalankan, dan langkah untuk memunculkan bug.

  3. 3

    Berikan konteks teknis

    Sebutkan bahasa, framework, versi runtime, sistem operasi, serta file atau fungsi yang berkaitan.

  4. 4

    Minta hipotesis dan patch minimal

    Minta beberapa kemungkinan penyebab, bukti pendukung, dan perubahan sekecil mungkin agar risiko regresi berkurang.

  5. 5

    Jalankan pengujian sendiri

    Terapkan perubahan setelah meninjau diff, kemudian jalankan typecheck, lint, test, build, atau skenario reproduksi.

1. Jangan hanya mengirim tulisan “kode saya error”

Permintaan yang terlalu singkat memaksa AI menebak bahasa, versi framework, konteks eksekusi, dan perubahan yang sudah dilakukan. Akibatnya, jawaban dapat terdengar yakin tetapi tidak cocok dengan proyek.

Sebaliknya, berikan informasi yang dapat diuji. Contohnya, “Saat menjalankan npm run build pada Next.js 16 dengan Node.js 22, muncul pesan Type error pada file app/api/route.ts. Saya mengharapkan build selesai tanpa error. Error mulai muncul setelah menambahkan validasi input.” Informasi seperti ini membantu analisis lebih terarah.

2. Sertakan bukti teknis yang relevan

Salin pesan error utuh, termasuk nama file, nomor baris, stack trace, kode status, atau respons server bila tersedia. Jangan hanya menyalin satu baris terakhir jika pesan sebelumnya berisi penyebab utama.

Berikan potongan kode secukupnya. Jika masalah melibatkan beberapa file, jelaskan hubungan file tersebut dan kirim bagian yang relevan. Untuk perubahan konfigurasi, sertakan nama framework dan versi paket yang benar.

  • Bahasa dan versi runtime, misalnya Node.js atau Python.
  • Framework dan versi yang digunakan.
  • Perintah atau tindakan yang memunculkan error.
  • Hasil aktual dibandingkan dengan hasil yang diharapkan.
  • Pesan error lengkap dan file yang berkaitan.
  • Perubahan terakhir sebelum masalah muncul.

3. Minta analisis bertahap, bukan rewrite seluruh proyek

Minta AI mengurutkan kemungkinan penyebab berdasarkan bukti, lalu menunjukkan cara memeriksa setiap hipotesis. Setelah penyebab cukup jelas, minta patch minimal per file. Hindari meminta seluruh proyek ditulis ulang kecuali memang ada alasan kuat.

Untuk proyek yang sedang berjalan di server produksi, perubahan kecil lebih mudah ditinjau dan dibatalkan. Minta AI menyebutkan dampak perubahan, dependensi yang terpengaruh, dan konfigurasi yang perlu diperiksa.

4. Verifikasi solusi di lingkungan proyek

Jangan menganggap jawaban AI sebagai bukti bahwa bug sudah diperbaiki. Salin perubahan dengan hati-hati, periksa perbedaan file, lalu jalankan perintah pengujian di lingkungan yang sesuai.

Untuk proyek JavaScript atau TypeScript, pemeriksaan yang sering berguna antara lain typecheck, lint, unit test, dan build. Untuk API, lakukan uji request dengan input valid, input tidak valid, tanpa autentikasi, serta kondisi batas yang relevan.

Jika error masih muncul, kirim hasil pengujian terbaru kepada AI. Dengan begitu analisis berikutnya memakai bukti baru, bukan mengulang tebakan sebelumnya.

  • Jalankan typecheck atau pemeriksaan tipe sesuai proyek.
  • Jalankan lint dan test yang sudah tersedia.
  • Jalankan build untuk menangkap error integrasi.
  • Uji perilaku normal dan kondisi gagal.
  • Periksa log server setelah deploy bila masalah hanya muncul di production.

5. Lampirkan file tanpa membocorkan rahasia

Monvira mendukung sejumlah format file teks dan kode serta beberapa format dokumen. Sebelum menempel atau mengunggah file, periksa apakah ada API key, password, private key, cookie sesi, token akses, data pelanggan, atau alamat internal sensitif.

Hapus atau samarkan rahasia terlebih dahulu. Jangan mengirim file .env produksi, dump database pelanggan, atau log yang memuat token aktif. Untuk memahami error, biasanya cukup kirim variabel yang relevan dalam bentuk placeholder dan struktur file yang diperlukan.

Contoh prompt siap dicoba

Salin contoh berikut, lalu ubah subjek, gaya, konteks, dan batasan sesuai kebutuhanmu.

Template debugging umum

Saya sedang menggunakan [bahasa/framework dan versi].

Perintah atau tindakan yang memunculkan masalah: [langkah reproduksi].

Hasil yang saya harapkan: [expected result].
Hasil aktual: [actual result].
Pesan error lengkap:
[tempel error dan stack trace]

File atau kode terkait:
[tempel potongan kode yang relevan]

Tolong urutkan kemungkinan penyebab berdasarkan bukti. Jangan rewrite seluruh proyek. Tunjukkan pemeriksaan untuk membuktikan penyebab, lalu berikan patch minimal per file dan perintah untuk menguji perbaikannya.

Template ini membantu memisahkan gejala, bukti, hipotesis, patch, dan verifikasi.

Debugging API yang mengembalikan HTTP 500

API saya mengembalikan HTTP 500 ketika menerima request berikut: [metode, endpoint, dan body yang sudah disamarkan].

Framework dan runtime: [versi].
Log server:
[tempel log tanpa token atau data pengguna]

Expected: [respons seharusnya].
Actual: [respons yang terjadi].

Analisis kemungkinan penyebab pada validasi, autentikasi, query database, dan pemanggilan layanan eksternal. Tunjukkan cara menguji tiap hipotesis. Berikan perubahan sekecil mungkin dan contoh request untuk verifikasi.

Samarkan kredensial dan informasi pengguna sebelum mengirim request atau log.

Memeriksa kegagalan build

Proyek saya menggunakan Next.js dan TypeScript. Perintah npm run build gagal dengan error berikut:
[tempel output lengkap]

Perubahan terakhir yang dilakukan: [jelaskan].
File terkait: [nama file dan potongan kode].

Identifikasi error pertama yang menyebabkan kegagalan, jelaskan mengapa terjadi, lalu tunjukkan patch minimal. Jangan ubah konfigurasi yang tidak terkait. Berikan urutan typecheck, lint, dan build untuk memverifikasi solusi.

Fokus pada error pertama dan perubahan terbaru sebelum memperluas area diagnosis.

Checklist sebelum mulai

  • ✓ Tulis expected result dan actual result.
  • ✓ Sertakan langkah untuk mengulang error.
  • ✓ Salin pesan error serta stack trace secara utuh.
  • ✓ Cantumkan bahasa, framework, dan versi runtime.
  • ✓ Berikan kode atau log yang berkaitan saja.
  • ✓ Minta patch minimal dan alasan perubahannya.
  • ✓ Jalankan pengujian sebelum dan sesudah deploy.
  • ✓ Hapus API key, password, token, dan data sensitif dari materi.

Kesimpulan

Debugging dengan AI paling bermanfaat ketika kamu memperlakukannya sebagai proses analisis yang dapat diuji, bukan sebagai tombol perbaikan otomatis. Berikan konteks, bukti, dan langkah reproduksi; minta patch minimal; lalu verifikasi sendiri. Kamu dapat memulai percakapan coding melalui Monvira AI Go.

Pelajari AI Coding Assistant ↗