# Prompt Debugging untuk Claude Code dan ChatGPT, Gratis

> Prompt debugging gratis untuk Claude Code, Cursor, dan ChatGPT. Agent mereproduksi bug, membuktikan penyebabnya dengan bukti, lalu membuat fix terkecil.

URL: https://www.matthewswong.com/id/toolkit/debugging-prompt-reproduce-first/

- Author: Matthews Wong (https://www.matthewswong.com/id/about/)
- Diperbarui: 13 November 2026

> **Poin utama:** Tempel prompt ini bersama laporan bug dan agent bekerja dengan urutan tetap: mereproduksi kegagalan dengan satu perintah atau test yang bisa diulang, mengumpulkan bukti, menyatakan penyebabnya dengan bukti itu, membuat fix terkecil, menjalankan ulang reproduksi yang sama, dan menyimpannya sebagai regression test. Bila bug tidak bisa direproduksi, agent berhenti dan meminta hal yang kurang. Ia tidak menebak fix.

- Jenis: Prompt
- Bisa dipakai di: Claude Code, Cursor, Claude.ai, ChatGPT
- Unduh: [debugging-prompt-reproduce-first.md](https://www.matthewswong.com/downloads/toolkit/debugging-prompt-reproduce-first/debugging-prompt-reproduce-first.md) (2.3 KB)
- Lisensi: Bebas dipakai, diubah, dan dibagikan, termasuk untuk pekerjaan.

## File-nya

Persis isi unduhannya. Baca dulu, lalu salin atau unduh.

### debugging-prompt-reproduce-first.md

```markdown
Help me debug this. Do not change any code until you have reproduced the bug and can show what is wrong with evidence.

The bug: [WHAT HAPPENS, AND WHAT SHOULD HAPPEN INSTEAD]
How I trigger it: [STEPS, COMMAND, INPUT OR FAILING TEST, OR "UNKNOWN"]
What I already have: [ERROR MESSAGE, STACK TRACE, LOGS, OR "NOTHING YET"]

## Work in this order

1. **Reproduce.** Trigger the failure yourself with one concrete, repeatable command, input or test. Show me the command and its real output. A failing test is the best reproduction.
2. **Gather evidence.** Read the stack trace, logs, console output or network traffic. If they do not show the cause, add temporary logging or run with debug output. List every temporary line you add.
3. **State the cause.** In two or three sentences: what is wrong, where (file and line), and why it produces this symptom. Quote the evidence that proves it. If two causes fit the evidence, say so and name the check that would tell them apart.
4. **Fix.** Only now, make the smallest change that removes the cause. Do not refactor, rename or tidy nearby code.
5. **Re-run.** Run the exact reproduction from step 1 and show the output. Then run the existing test suite with the project's own command.
6. **Keep it.** Turn the reproduction into a regression test that fails without the fix and passes with it. Remove all temporary logging.

## If you cannot reproduce it

Stop. Do not guess a fix. Tell me what you tried and what happened, then ask for exactly what is missing: the steps, the input data, the logs, the version or the environment.

## Do not

- Do not edit code before step 3 is written down.
- Do not say "this should fix it". Say what you ran and what it printed.
- Do not silence the error: no empty catch blocks, no skipped or deleted tests, no loosened assertions.
- Do not fix other problems you notice. List them at the end.

## Report at the end

- **Reproduction:** the command
- **Cause:** one paragraph, with the evidence
- **Fix:** the files changed, and why
- **Proof:** the output before and after
- **Regression test:** its path and name
- **Noticed but not touched:** a list, or "nothing"

If you cannot run commands here, say so at the start. Then give me one command at a time and wait for the output I paste back before you move to the next step.
```

## Pakai saat

- Agent sudah dua kali memperbaiki bug yang sama dan bug itu masih ada.
- Anda punya pesan error atau stack trace, tetapi belum tahu penyebabnya.
- Bug ada di kode production dan Anda ingin satu perubahan kecil yang bisa dijelaskan.
- Anda ingin fix datang bersama test yang gagal tanpa fix tersebut.

## Dari unduh sampai jalan

1. **Isi tiga placeholder.** Jelaskan apa yang terjadi dan apa yang seharusnya terjadi, cara Anda memicunya, dan apa yang sudah Anda punya: pesan error, stack trace, atau log. Menulis unknown diperbolehkan; agent lalu harus mencari pemicunya lebih dulu.
2. **Tunggu reproduksinya.** Hal pertama yang harus Anda lihat adalah sebuah perintah beserta output aslinya yang menunjukkan kegagalan. Bila agent langsung mengubah kode, hentikan dan tunjuk langkah 1. Tanpa reproduksi, tidak ada cara untuk tahu apakah sebuah fix berhasil.
3. **Baca penyebabnya sebelum mengizinkan fix.** Agent menyatakan apa yang salah, file dan barisnya, serta kenapa itu menimbulkan gejalanya, dengan bukti yang dikutip. Periksa apakah bukti itu mendukung klaimnya. Bila ada dua penyebab yang cocok, agent menyebut pemeriksaan yang membedakannya.
4. **Bandingkan output sebelum dan sesudah.** Setelah fix, agent menjalankan ulang reproduksi yang sama persis dan test suite yang ada, lalu menampilkan kedua output. Laporan penutup memuat reproduksi, penyebab, fix, bukti, dan path regression test.
5. **Commit test bersama fix-nya.** Review diff-nya, pastikan logging sementara sudah dihapus, lalu commit fix dan regression test-nya bersama-sama. Daftar hal yang terlihat tetapi tidak disentuh menjadi tiket Anda berikutnya.

## Kenapa ditulis seperti ini

- **Tidak ada perubahan sebelum penyebab tertulis.** Prompt ini menahan perubahan kode sampai penyebab dinyatakan dengan bukti. Agent yang dibiarkan sendiri membaca error, mencocokkannya dengan fix yang mirip, lalu mengubah kode. Hasilnya sering kali gejalanya berubah dan bug-nya tetap ada.
- **Reproduksi berupa satu perintah yang bisa diulang.** Perintah atau test yang gagal bisa dijalankan lagi setelah fix, oleh agent maupun oleh Anda. Langkah manual yang ditulis sebagai narasi tidak bisa, dan sedikit bergeser setiap kali diulang.
- **Aturan berhenti untuk bug yang tidak bisa direproduksi.** Bila kegagalan tidak muncul, agent melaporkan apa yang dicobanya dan meminta langkah, data, log, versi, atau environment yang kurang. Tanpa aturan ini, agent yang tidak bisa melihat bug tetap mengirim patch yang tampak masuk akal.
- **Menyembunyikan error dilarang.** Tidak boleh ada catch block kosong, test yang dilewati atau dihapus, maupun assertion yang dilonggarkan. Masing-masing membuat kegagalan hilang dari output sementara cacatnya tetap ada di kode.
- **Reproduksi menjadi regression test.** Test itu harus gagal tanpa fix dan lolos dengan fix. Itulah bukti bahwa fix menangani bug ini, dan itulah yang mencegah bug yang sama kembali tanpa ketahuan.

## Yang sering salah

- Di jendela chat, agent tidak bisa menjalankan apa pun. Prompt ini mengalihkannya untuk memberi satu perintah setiap kali, dan itu hanya berhasil bila Anda menempel output aslinya tanpa diubah.
- Bug yang bergantung pada data production, timing, atau beban mungkin tidak muncul di mesin Anda. Agent akan berhenti dan bertanya; beri log atau contoh data, bukan izin untuk menebak.
- Fix terkecil tidak selalu merupakan desain yang tepat. Prompt ini sengaja menjaga perubahan tetap kecil; jadwalkan perombakan yang lebih besar sebagai tugas tersendiri.
- Baca sendiri regression test-nya. Test yang lolos baik dengan maupun tanpa fix tidak membuktikan apa pun.

## FAQ

### Seperti apa prompt yang baik untuk debugging kode dengan AI?

Prompt yang menetapkan urutan kerja, bukan hanya tujuannya. Prompt ini mewajibkan reproduksi dengan output asli, bukti, penyebab yang dinyatakan beserta file dan barisnya, fix terkecil, menjalankan ulang reproduksi yang sama, dan regression test. Prompt ini juga mengatur apa yang dilakukan bila bug tidak bisa direproduksi.

### Kenapa AI terus memperbaiki hal yang salah?

Biasanya karena AI tidak pernah melihat bug itu gagal. Ia membaca teks error, memilih penyebab yang paling mungkin, lalu mengubah kode tanpa pembanding untuk mengujinya. Mewajibkannya mereproduksi kegagalan lebih dulu memberi setiap langkah berikutnya sesuatu untuk diuji.

### Apa yang terjadi bila agent tidak bisa mereproduksi bug?

Agent berhenti. Prompt ini menyuruhnya melaporkan apa yang dicoba dan apa hasilnya, lalu meminta persis hal yang kurang: langkah, data input, log, versi, atau environment. Agent dilarang menebak fix.

### Bisakah prompt debugging ini dipakai di ChatGPT atau Claude.ai?

Bisa. Bila agent tidak bisa menjalankan perintah, prompt ini menyuruhnya mengatakan hal itu, memberi Anda satu perintah setiap kali, dan menunggu output yang Anda tempel. Prosesnya lebih lambat daripada agent yang punya terminal, tetapi urutan kerjanya tetap sama.

## Pelajari apa yang dikemas file ini

- Pelajaran gratis: [Rewind dan Plan Mode Claude Code: Batalkan Perubahan Berisiko](https://www.matthewswong.com/id/learn/claude-code-tips/claude-code-rewind-plan-mode-safe-changes/)
- Pelajaran gratis: [Git di Claude Code: Commit, PR, dan Aturan Push yang Aman](https://www.matthewswong.com/id/learn/claude-code-tips/claude-code-git-workflow-safe-commits/)
- Pelajaran gratis: [Tes Situs Next.js dengan node:test dan Build Gate](https://www.matthewswong.com/id/learn/web-app-skills/nextjs-testing-node-test-build-gates/)
- [Debug Insiden VPS Produksi dengan Claude Code](https://www.matthewswong.com/id/blog/claude-code-production-incident-debugging/)
- [TDD dengan AI Coding Agent: Alur Kerja Praktis](https://www.matthewswong.com/id/blog/tdd-with-ai-coding-agents/)
- [Cara Menguji Kode Buatan AI: Praktik Terbaik](https://www.matthewswong.com/id/blog/testing-ai-generated-code-guide/)

[Semua item toolkit](https://www.matthewswong.com/id/toolkit/)

---

- HTML version: https://www.matthewswong.com/id/toolkit/debugging-prompt-reproduce-first/
- English: https://www.matthewswong.com/en/toolkit/debugging-prompt-reproduce-first/
- Site index for agents: https://www.matthewswong.com/llms.txt
- Sitemap: https://www.matthewswong.com/sitemap.xml
- API description (OpenAPI): https://www.matthewswong.com/openapi.json
