Claude Code Bug Report Template: अस्पष्ट errors को reproducible fixes में बदलें

Claude Code debugging की सफलता bug report से शुरू होती है

अगर आप सिर्फ “काम नहीं कर रहा” लिखते हैं, Claude Code guess करेगा। अच्छा bug report symptom, reproduction, expected result, actual result, constraints और verification देता है।

इसे first task runbook के बाद इस्तेमाल करें। Context अगले session को देना हो तो handoff template भी जोड़ें।

कॉपी-पेस्ट करने वाला bug report टेम्पलेट

Goal:
- Fix करने वाला bug:
- Scope से बाहर:

Environment:
- OS / browser / runtime:
- branch:
- related commands:

Reproduction steps:
1.
2.
3.

Expected result:
-

Actual result:
-

Logs or screenshots:
-

Constraints:
- files that can be changed:
- files not to touch:
- no external service calls:

Verification:
- build/test to run:
- URL to inspect visually:

Request to Claude Code:
पहले cause को 3 hypotheses तक सीमित करें।
Minimal fix, touched files और verification steps दें। Approval से पहले edit न करें।

अच्छा example

Bug:
Mobile width में pricing CTA दाईं तरफ overflow करता है।

Reproduction:
1. /en/products/ को 390px width में खोलें
2. pricing card तक scroll करें
3. CTA का right edge viewport से बाहर जाता है

Verification:
npm.cmd run build
Playwright से 390px screenshot

खराब example

Site अजीब है। ठीक कर दो।

इसमें scope, success criteria और constraints नहीं हैं।

भेजने से पहले check करें

• Reproduction 3 मिनट से कम में हो सकती है
• Success command या screenshot से verify हो सकता है
• जिन files को नहीं छूना है वे लिखी हैं
• Logs, URL या image शामिल है

अगला कदम

Commands को free cheatsheet में रखें। Debugging prompts standard करने हैं तो 50 Prompt Templates देखें। Team process चाहिए तो consultation page देखें।

Practical debugging में investigation और fix अलग रखें

Common failure यह है कि cause narrow किए बिना patch बनवाया जाता है। Stable order है: reproduce, hypotheses, minimal fix। इससे हर step reviewable रहता है।

इस bug report से पहले सिर्फ investigate करें, edit न करें।
1. क्या reproduce होता है
2. 3 cause hypotheses
3. सबसे likely code area
4. fix से पहले पढ़ने वाली files
5. minimal change काफी है या design change चाहिए

अगर output कहता है कि reproduce नहीं हुआ, logs कम हैं या scope बहुत बड़ा है, fix पर मत जाएं। अच्छा bug report answer जल्दी नहीं कराता; वह investigation को verifiable बनाता है।