Bir AI'ya iyi bir hata raporu, bir insana iyi bir hata raporu vermekle aynıdır: sorunu kendi aklında yeniden üretmek için yeterli bağlam verin ve gürültüyü ortadan kaldırın. AI yalnızca yapıştırdığınız şeyler hakkında mantık yürütebilir — belirsiz açıklamalar belirsiz tahminler üretir.
İlgisiz dosyalar, tüm konfigürasyonunuz, sırlar/API anahtarları ve tanıyı tarafıyla alan "bunun X olduğunu düşünüyorum" teorileri. Gerçekler verin, tahminler değil.
❌ WEAK: "My login is broken, it throws an error. Why?"
→ no error text, no code, no repro → the AI can only guess
✅ STRONG:
Error (verbatim):
TypeError: Cannot read properties of undefined (reading 'id')
at getUser (auth.js:42)
Code (auth.js:40-43):
function getUser(token) {
const session = sessions.find(s => s.token === token); // returns undefined if not found
return session.user.id; // line 42: crashes when session is undefined
}
Expected: return null for an unknown token.
Actual: throws TypeError above.
Repro: call getUser('expired-token').
Env: Node 20, no framework.
Güçlü sürümle, AI eksik undefined kontrolünü işaret edebilir ve bir guard önerebilir, çünkü ihtiyaç duyduğu her gerçek sayfada var.
Bir AI asistanının çalışan sisteminize erişimi yoktur — yalnızca sağladığınız şeylerden yola çıkarak mantık yürütür. Zayıf bir rapor, AI'yı hataları, kodu ve ortamı aynı anda tahmin etmeye zorlar ve yanlış bir tahmin zaman kaybına neden olur. Güçlü bir rapor (tam trace + ilgili kod + beklenen/gerçek + repro + sürümler) tanıyı odaklanmış bir görev haline getirir ve genellikle ilk denemede doğru düzeltmeyi alır. Sıkı hata raporları yazmayı öğrenmek aynı zamanda sizi daha iyi bir hata ayıklayıcı yapar, çünkü sormadan önce gerçekleri ayırt etmeye zorlayır.