Claude Code बिल्ड त्रुटि जाँच चक्र: 15 मिनट में कारण सीमित करें

सुधार मांगने से पहले बिल्ड त्रुटि को बांटें

Node या Astro का बिल्ड विफल हो तो पूरा लॉग Claude Code को देकर सब ठीक करने को कहना आसान है। इससे पहली असफल पंक्ति, संभावित कारण और असंबंधित सफाई एक साथ मिल जाते हैं।

यह चक्र बग रिपोर्ट टेम्पलेट और रिव्यू वर्कफ़्लो चेकलिस्ट को बिल्ड विफलताओं पर लागू करता है। लक्ष्य है कारण को छोटा करना, छोटा निदान लेना और सुधार के बाद प्रमाण छोड़ना।

प्रमाण हमेशा एक ही क्रम में लें

हर बार स्थिति, बिल्ड और जरूरत हो तो परीक्षण चलाएं।

git status --short
npm.cmd run build
npm.cmd run test -- --runInBand

पहला चलाना सफल होना जरूरी नहीं। जरूरी है पहली असफल पंक्ति बचाना। वही अक्सर मूल कारण के पास होती है।

लॉग को चार समूहों में बांटें

वर्गीकरण पूर्ण होना जरूरी नहीं। dependency/import path, runtime shape mismatch, test expectation drift और permission boundary कई दैनिक विफलताओं को कवर करते हैं।

const patterns = [
  [/Cannot find module|ERR_MODULE_NOT_FOUND/i, "dependency or import path"],
  [/TypeError:.*undefined|undefined is not/i, "runtime null or shape mismatch"],
  [/Expected.*received|AssertionError/i, "test expectation drift"],
  [/EACCES|permission denied/i, "permission or sandbox boundary"],
];

export function classifyBuildLine(line) {
  const hit = patterns.find(([regex]) => regex.test(line));
  return hit ? hit[1] : "needs manual reading";
}

इतना विभाजन भी प्रॉम्प्ट बदल देता है। आप बड़े सुधार के बजाय सबसे छोटा निदान मांग सकते हैं।

कॉपी करने योग्य जाँच प्रॉम्प्ट

इस failing build log को पढ़ें।
broad refactors suggest न करें।
लौटाएं:
1. पहली failing line
2. सबसे संभावित cause
3. सबसे छोटा diagnostic command
4. सबसे छोटा code या config fix
5. fix के बाद proof command

मुख्य पंक्ति है बड़े refactor न सुझाना। बिल्ड जाँच में एक अनुमान और एक प्रमाण command सबसे अच्छा रहता है।

असफलता का उदाहरण: dependencies जल्दी बदलना

“Cannot find module” देखकर package जोड़ना गलत हो सकता है यदि असली कारण import path है। “undefined” देखकर हर जगह null checks लगाना frontmatter या generated file issue छिपा सकता है।

सार्वजनिक सामग्री साइट में स्थानीय build सफल होना काफी नहीं है। revenue path के लिए public URL, सही h1, canonical, CTA और Gumroad links जांचने होते हैं।

अगला कदम

commands याद रखने के लिए free cheatsheet लें। debugging और review prompts के लिए 50 Prompt Templates खरीदें। CI/CD और production verification के लिए Setup Guide और consultation देखें।