Claude Code और Antigravity: बिना स्कोप ड्रिफ्ट के कार्य कैसे सौंपें

अनियंत्रित प्रत्यायोजन से स्कोप ड्रिफ्ट क्यों होता है

एआई एजेंट पूरे कार्यक्षेत्र में निर्देश लागू करते हैं। बिना स्पष्ट सीमाओं के तीन प्रमुख जोखिम उत्पन्न होते हैं:

1. अनावश्यक कार्य विस्तार: मॉडल असंबंधित सहायक फ़ाइलों या कोड फ़ॉर्मेटिंग को बदलने लगता है।
2. संवेदनशील डेटा का रिसाव: एजेंट .env फ़ाइलों को पढ़कर परीक्षण लॉग में एपीआई कुंजी डाल देता है।
3. वास्तुशिल्प मान्यताओं का टकराव: दो एजेंट अलग-अलग आयात संरचनाओं को लागू करने का प्रयास करते हैं।

एपीआई कुंजी और पर्यावरण सेटिंग्स को कार्य संदर्भ से अलग रखा जाना चाहिए। BetterToken के साथ Claude Code का उपयोग करते समय, प्रमाणीकरण सीधे पर्यावरण चर के माध्यम से प्रबंधित किया जाता है। BetterToken डैशबोर्ड में डेवलपर वास्तविक टोकन खपत को आसानी से ट्रैक कर सकते हैं।

हैंडऑफ अनुबंध (Handoff Contract) ढांचा

प्राकृतिक भाषा के अस्पष्ट विवरण के बजाय एक संरचित घोषणापत्र का उपयोग करें:

चरण-दर-चरण सुरक्षित कार्य प्रत्यायोजन

इन चार चरणों का पालन करें:

चरण 1. अलग फ़ाइल में विनिर्देश निर्धारित करें

सीक्रेट्स के बिना एक समर्पित विनिर्देश फ़ाइल (task_handoff.md) बनाएं:

Handoff Spec: Optimize Parser

Context & Goal

• Module: src/parser.py
• Objective: Reduce memory allocations in parse_payload() without altering public API.

File Boundaries

• Modifiable: src/parser.py, tests/test_parser.py
• Read-only: all other files.
• Strictly forbidden: .env*, secrets/*, infrastructure/*

Acceptance Criteria

• All tests pass: pytest tests/test_parser.py
• Benchmark demonstrates >= 20% latency reduction.
• No new dependencies in requirements.txt.

चरण 2. कार्यक्षेत्र और अनुमतियों को अलग करें

सुनिश्चित करें कि .env फ़ाइलें .gitignore में हैं और प्रॉम्प्ट में कोई कुंजी न डालें।

चरण 3. स्वचालित सत्यापन चलाएं

अनुबंध में निर्दिष्ट परीक्षण कमांड निष्पादित करें:

pytest tests/test_parser.py -v

चरण 4. Git Diff के साथ मैन्युअल समीक्षा और स्वीकृति

डेवलपर विलय से पहले अंतिम परिवर्तनों की पुष्टि करता है:

git diff src/parser.py
git status --short

परिदृश्य-आधारित सिफारिशें

• एकल फ़ंक्शन रिफैक्टरिंग: संक्षिप्त हैंडऑफ विनिर्देश और स्थानीय इकाई परीक्षणों का उपयोग करें।
• बाहरी एपीआई एकीकरण: सुरक्षित समापन बिंदुओं के लिए BetterToken दस्तावेज़ देखें।

समस्या निवारण

1. स्कोप से बाहर फ़ाइलें बदली गईं: Allowed Scope सूची को सख्त करें।
2. परीक्षण सुधार का अंतहीन लूप: स्वचालित पुनरावृत्ति की अधिकतम सीमा निर्धारित करें।
3. प्रमाणीकरण त्रुटि या टाइमआउट: BetterToken गाइड में बेस यूआरएल और शेष राशि की जांच करें।