AI కి చేసిన మంచి బగ్ రిపోర్ట్ మానవుకి చేసిన మంచి బగ్ రిపోర్ట్ కి సమానం: సమస్యను దాని తలలో పునరుత్పత్తి చేయడానికి తగిన సందర్భాన్ని ఇవ్వండి, మరియు శబ్దం తగ్గించండి. AI మీరు పేస్ట్ చేసిన దాని గురించి మాత్రమే తర్క చేయగలదు — అస్పష్ట వివరణలు అస్పష్ట ఊహలను ఉత్పత్తి చేస్తాయి.
సంబంధం లేని ఫైల్లు, మీ మొత్తం config, సీక్రెట్లు/API కీలు, మరియు "ఇది X కావచ్చు" సిద్ధాంతాలు, ఇవి నిర్ధారణను పక్షపాతం చేస్తాయి. వాస్తవాలు ఇవ్వండి, హల్లు కాదు.
❌ 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.
బలమైన సంస్కరణతో, AI లేని undefined చెక్ను నేరుగా చూపించగలదు మరియు గార్డ్ను ప్రతిపాదించగలదు, ఎందుకంటే ఆ దృష్టికోణానికి అవసరమైన ప్రతిটి వాస్తవం పేజీలో ఉంది.
AI సహాయకుడికి మీ నడుస్తున్న సిస్టమ్కు యాక్సెస్ లేదు — ఇది మీరు అందించిన దాని నుండి మాత్రమే తర్క చేస్తుంది. బలహీన రిపోర్ట్ ఈ ఎర్రర్, కోడ్, మరియు పరిసర సమంధితంగా ఊహ కోసం బలవంతం చేస్తుంది, మరియు తప్పు ఊహ ఒక రౌండ్-ట్రిప్ను వృధా చేస్తుంది. ఒక బలమైన రిపోర్ట్ (ఖచ్చితమైన trace + సంబంధిత కోడ్ + ఆశించిన/వాస్తవ + repro + సంస్కరణలు) నిర్ధారణను ఫోకస్ చేసిన పనిగా మారుస్తుంది మరియు సాధారణంగా మొదటి ప్రయత్నంలో సరైన పరిష్కారం పొందుతుంది. కట్టుబాటైన bug reports రాయడం నేర్చుకోవడం కూడా మిమ్మల్ని ఒక బెట్టర్ డీబగర్గా చేస్తుంది, ఎందుకంటే ఇది మీ వాస్తవాలను అడగడానికి ముందు వేరుచేయడానికి బలవంతం చేస్తుంది.