Un bon rapport de bug pour une IA est le même qu'un bon rapport de bug pour un humain : donnez-lui suffisamment de contexte pour reproduire le problème mentalement, et éliminez le bruit. L'IA ne peut raisonner que sur ce que vous collez — les descriptions vagues produisent des suppositions vagues.
Les fichiers non liés, toute votre configuration, secrets/clés API, et les théories « Je pense que ce pourrait être X » qui biaisent le diagnostic. Donnez des faits, pas des intuitions.
❌ 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.
Avec la version forte, l'IA peut pointer directement vers la vérification undefined manquante et proposer une garde, car chaque fait dont elle a besoin est sur la page.
Un assistant IA n'a pas accès à votre système en cours d'exécution — il raisonne uniquement à partir de ce que vous fournissez. Un rapport faible la force à deviner l'erreur, le code et l'environnement à la fois, et une mauvaise supposition gaspille un aller-retour. Un rapport fort (trace exacte + code pertinent + attendu/réel + repro + versions) transforme le diagnostic en une tâche ciblée et obtient généralement la bonne correction à la première tentative. Apprendre à écrire des rapports de bug serrés vous rend aussi meilleur débogueur, car cela vous force à isoler les faits avant de demander.