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

जब डेवलपर्स दो शक्तिशाली कोडिंग एजेंटों — टर्मिनल-आधारित Claude Code और Antigravity परिवेश — को जोड़ते हैं, तो सबसे आम समस्या कोड जनरेशन की नहीं, बल्कि स्कोप ड्रिफ्ट (कार्यक्षेत्र का भटकना) की होती है। अस्पष्ट निर्देश देने से अनपेक्षित फ़ाइलें बदल सकती हैं और टोकन का अनावश्यक खर्च हो सकता है।

एजेंटों के बीच सुरक्षित कार्य प्रत्यायोजन के लिए एक स्पष्ट हैंडऑफ अनुबंध (Handoff Contract) की आवश्यकता होती है: अनुमत फ़ाइलों की सूची, सीक्रेट्स की सुरक्षा, पुनरुत्पादित परीक्षण कमांड और Git diff के माध्यम से मैन्युअल समीक्षा।

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

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

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

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

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

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

अनुबंध फ़ील्ड	उद्देश्य	उदाहरण
Goal	एकल मापने योग्य लक्ष्य	parser.py में JSON पार्सिंग का अनुकूलन
Allowed Scope	परिवर्तनीय फ़ाइलें	src/parser.py, tests/test_parser.py
Forbidden	प्रतिबंधित क्रियाएं	config/, .env या सार्वजनिक एपीआई को न बदलें
Verification Command	स्वचालित परीक्षण कमांड	pytest tests/test_parser.py -v
Stop Conditions	तत्काल रोकने के मानदंड	बाहरी परीक्षण विफलता, प्रकार त्रुटियां

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

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

चरण 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 गाइड में बेस यूआरएल और शेष राशि की जांच करें।