Template bug report Claude Code: ubah error samar menjadi perbaikan yang bisa direproduksi

Debugging Claude Code dimulai dari bug report yang jelas

Jika hanya menulis “tidak jalan”, Claude Code akan menebak. Bug report yang baik berisi gejala, langkah reproduksi, hasil yang diharapkan, hasil aktual, batasan, dan verifikasi.

Gunakan setelah runbook tugas pertama dan bersama template handoff jika konteks perlu diteruskan.

Template bug report

Tujuan:
- Bug yang diperbaiki:
- Di luar scope:

Environment:
- OS / browser / runtime:
- branch:
- command terkait:

Langkah reproduksi:
1.
2.
3.

Hasil yang diharapkan:
-

Hasil aktual:
-

Log atau screenshot:
-

Batasan:
- file yang boleh diubah:
- file yang tidak boleh disentuh:
- jangan kirim ke layanan eksternal:

Verifikasi:
- build/test yang dijalankan:
- URL yang dicek visual:

Permintaan ke Claude Code:
Pertama persempit penyebab menjadi 3 hipotesis.
Tulis fix minimal, file yang disentuh, dan langkah verifikasi.
Jangan edit sebelum disetujui.

Contoh baik

Bug:
Pada lebar mobile, pricing CTA overflow ke kanan.

Reproduksi:
1. Buka /en/products/ dengan lebar 390px
2. Scroll ke pricing card
3. Sisi kanan CTA melewati viewport

Verifikasi:
npm.cmd run build
Screenshot Playwright pada 390px

Contoh buruk

Situsnya aneh. Tolong bereskan.

Tidak ada scope, kriteria sukses, atau batasan.

Checklist sebelum dikirim

• Reproduksi bisa dilakukan kurang dari 3 menit
• Sukses bisa dicek dengan command atau screenshot
• File yang tidak boleh disentuh sudah ditulis
• Ada log, URL, atau gambar

Langkah berikutnya

Catat command di cheatsheet gratis. Untuk standard prompt debugging, gunakan 50 Prompt Templates. Untuk proses tim, lihat halaman konsultasi.

Dalam praktik, pisahkan investigasi dan perbaikan

Kegagalan umum adalah meminta patch sebelum penyebab dipersempit. Urutan stabil adalah reproduksi, hipotesis, lalu fix minimal. Dengan begitu setiap langkah bisa direview.

Berdasarkan bug report ini, investigasi dulu tanpa mengedit.
1. apakah bisa direproduksi
2. 3 hipotesis penyebab
3. area kode paling mungkin
4. file yang harus dibaca sebelum fix
5. apakah cukup perubahan minimal atau perlu design change

Jika hasilnya “tidak bisa direproduksi”, “log kurang”, atau “scope terlalu luas”, jangan lanjut ke fix. Bug report yang baik membuat investigasi bisa diverifikasi.