प्रोडक्शन समस्याओं को डीबग करने के प्रॉम्प्ट टेम्पलेट

साक्ष्य -> परिकल्पनाएँ -> सत्यापन -> सबसे छोटा fix -> जाँच

हमें production issue की जाँच करनी है। अभी code change प्रस्तावित न करें।

लक्षण: [उपयोगकर्ता या monitoring क्या दिखाते हैं।]
अपेक्षित व्यवहार: [क्या होना चाहिए।]
देखा गया व्यवहार: [वास्तव में क्या होता है।]
प्रभाव: [कौन प्रभावित है, आवृत्ति, गंभीरता और ज्ञात हो तो सुरक्षित fallback।]
Environment: [Version, deployment, browser/OS, region, feature flags या
runtime details.]
हाल के बदलाव: [प्रासंगिक deploys, migrations, configuration या dependencies.]
साक्ष्य: [Sanitized logs, errors, metrics, trace IDs, screenshots, commands.]
पुनरुत्पादन: [विश्वसनीय चरण, या बताएँ कि यह intermittent है।]

लौटाएँ:
1. पुष्टि किए गए तथ्यों की संक्षिप्त timeline;
2. संभावना और प्रभाव के क्रम में शीर्ष परिकल्पनाएँ;
3. हर परिकल्पना के लिए अगला सुरक्षित observation या reproduction step;
4. ऐसा कोई missing information जो diagnosis को वास्तविक रूप से रोकता है।

इस issue को स्थानीय रूप से या स्वीकृत non-production
environment में पुन: उत्पन्न करने का प्रयास करें।

अपेक्षित: [Expected result.]
देखा गया: [Actual result.]
सेटअप: [Fixture, account state, command, configuration या test data.]
जाँचने वाला हाल का बदलाव: [Commit, release या behavior change.]

जब तक विफलता पुन: उत्पन्न न हो जाए या हमारे पास यह बताने वाला evidence-based कारण न हो कि
पुनरुत्पादन क्यों संभव नहीं है, production code न बदलें। सबसे छोटा
failing test, log sequence या command output कैप्चर करें जो
मुख्य परिकल्पनाओं को अलग करता है।

production failure के लिए इन sanitized logs का विश्लेषण करें।

संदर्भ: [Service/feature और अपेक्षित request flow.]
समय अवधि: [Start/end और timezone.]
अपेक्षित व्यवहार: [Expected success path.]
देखा गया व्यवहार: [Error या degraded behavior.]
हाल के बदलाव: [Deploy/configuration/dependency changes.]
Logs: [कालानुक्रमिक क्रम में Sanitized entries.]

तथ्यों को अनुमानों से अलग रखें। events को केवल वहाँ correlate करें जहाँ IDs, timestamps या
causal evidence उसका समर्थन करें। संभावित परिकल्पनाएँ, हर एक की पुष्टि करने वाला log या metric
और अगला सबसे कम जोखिम वाला observation सूचीबद्ध करें।

जाँच करें कि यह production maintenance command क्यों विफल हुआ।

Command: [secrets हटाकर Exact command.]
अपेक्षित आउटपुट: [Expected success signal.]
देखा गया आउटपुट: [Exact sanitized stderr/stdout और exit code.]
Environment: [Shell, working directory, OS/runtime version, प्रासंगिक files.]
हाल के बदलाव: [Script या deployment changes.]

पहले समझाएँ कि command वास्तव में क्या करता है और सबसे पहले विफल होने वाला
step पहचानें। ऐसे सुरक्षित diagnostic commands प्रस्तावित करें जो data न बदलें। विफलता
समझ लेने के बाद ही सबसे छोटा fix और उसे
non-production environment में सत्यापित करने का तरीका प्रस्तावित करें।

आकलन करें कि यह regression हाल के rollout से संबंधित है या नहीं।

Baseline: [rollout से पहले का Behavior/version.]
बदलाव: [Release, flag, migration या configuration difference.]
देखा गया regression: [कौन प्रभावित है और कैसे।]
साक्ष्य: [Metrics, logs, traces, screenshots या reproduction.]
बाध्यताएँ: साक्ष्य किसी निर्णय का समर्थन करने तक rollout न बदलें और data migrate न करें।
rollback path सुरक्षित रखें।

baseline और बदले हुए paths की तुलना करें। सबसे छोटा experiment,
feature-flag check या non-production test पहचानें जो causation की पुष्टि कर सके।
हर एक के confidence और tradeoffs के साथ rollback, mitigation या code investigation
सुझाएँ।

पुष्टि किया गया कारण: [Evidence-backed root cause.]
दायरा: [बदलने वाली Files, module या configuration.]
सुरक्षित रखने वाला व्यवहार: [Existing success path, public contract, permissions,
data, locale, performance या rollback behavior.]

सबसे छोटा fix प्रस्तावित करें। शामिल करें:
- यह पुष्टि किए गए कारण को क्यों हल करता है;
- regression test या reproducible check;
- स्वीकृत non-production environment में validation;
- rollout, monitoring और rollback पर विचार;
- वह व्यवहार जो अनिश्चित बना हुआ है।

इस बदलाव में असंबंधित रिफ़ैक्टरिंग शामिल न करें।

मूल incident के सामने fix सत्यापित करें।

जाँचें:
1. मूल reproduction या failing test अब पास होता है;
2. सामान्य success path अपरिवर्तित रहता है;
3. प्रासंगिक error और edge paths अब भी सुरक्षित ढंग से व्यवहार करते हैं;
4. deployment या monitoring signals अपेक्षित recovery दिखाते हैं;
5. rollback condition उपलब्ध रहती है।

हर जाँच का साक्ष्य रिपोर्ट करें और जो कुछ सत्यापित नहीं हुआ उसका नाम स्पष्ट रूप से बताएँ।