عالمی سیاق و سباق (Global Context) APC سے باہر ہونا چاہیے
APC پورٹیبل سیاق و سباق کی تہہ (context layer) ہے۔ APX مقامی رن ٹائم تہہ (local runtime layer) ہے۔
ان کو بہتر حالت میں رکھنے کے لیے، ایک اصول پر عمل کریں۔ اگر کوئی چیز نئے کلون (fresh clone) کے بعد بھی برقرار رہنی چاہیے، تو اسے APC میں رکھیں۔ اگر یہ کسی مخصوص صارف، مشین، یا عمل (process) پر منحصر ہے، تو اسے APC سے باہر رکھیں۔
منصوبے بڑھتے ہیں اور ساتھ ہی ترغیب (temptation) بھی آتی ہے۔ آپ شاید ایک اور سیٹنگ یا ایک مقامی پاتھ (local path) شامل کرنا چاہیں۔ اگر آپ سخت نہیں ہوں گے، تو آپ کی ریپوزٹری (repo) مشین ڈیٹا کا ڈھیر بن جائے گی۔ یہ ریپو کو کمزور (fragile) بنا دیتا ہے۔
APC پروجیکٹ کے زیرِ ملکیت معنی (meaning) کو محفوظ رکھتا ہے۔ یہ وہ مشترکہ معاہدہ ہے جو ایک ریپوزٹری اپنے ساتھ رکھتی ہے۔
اچھے APC مواد میں شامل ہیں:
- پروجیکٹ کی شناخت
- ایجنٹ کے کردار
- دوبارہ استعمال کے قابل مہارتیں
- ترتیب شدہ پروجیکٹ میموری
- پروجیکٹ لیول کے MCP اشارے (hints)
- AGENTS.md میں ریپو پر محیط ہدایات
ایک ساتھی یا نئی مشین کو چیک آؤٹ (checkout) کے فوراً بعد ان حقائق کو پڑھنا چاہیے۔
عالمی سیاق و سباق (Global context) مختلف ہے۔ یہ کسی صارف یا ورک اسٹیشن سے تعلق رکھتا ہے۔
عالمی سیاق و سباق کی مثالیں:
- API keys
- ایڈیٹر کی ترجیحات
- مقامی ایلیئسز (aliases)
- مشین کے مخصوص ٹول پاتھ
- نجی رن ٹائم میموری
- کیشز (Caches)
- سیشن ٹرانسکرپٹس
- میسج لاگز
APX اس حالت (state) کو مقامی رکھتا ہے۔ یہ رن ٹائم اسٹیٹ کو ~/.apx/ کے تحت محفوظ کرتا ہے۔ اس سے پروجیکٹ شیئر کرنے کے قابل رہتا ہے۔
ان تہوں کو ملانے سے تین مسائل پیدا ہوتے ہیں:
- پورٹیبلٹی (Portability) ٹوٹ جاتی ہے۔ ایسی ریپو جو مقامی کنفیگریشن پر منحصر ہو، اس پر بھروسہ کرنا مشکل ہوتا ہے۔
- ریویوز میں شور بڑھ جاتا ہے۔ پل ریکویسٹس (Pull requests) کو پروجیکٹ کے فیصلے دکھانے چاہئیں، ورک اسٹیشن کا اضافی بوجھ نہیں۔
- راز (Secrets) لیک ہو جاتے ہیں۔ مقامی تفصیلات کو محفوظ کرنے سے غلط فائلیں کمٹ (commit) کرنا آسان ہو جاتا ہے۔
کوئی سیٹنگ شامل کرنے سے پہلے، یہ پوچھیں: کیا کسی دوسرے معاون (contributor) کو کلوننگ کے فوراً بعد اس کی ضرورت ہوگی؟
اگر ہاں، تو APC استعمال کریں۔
- ہر کلون کے لیے ایک ریویو ایجنٹ؟ APC۔
- ایک ذاتی API key؟ APC نہیں ہے۔
- اجازتوں (permissions) پر پروجیکٹ کا فیصلہ؟ APC۔
- ایک مقامی براؤزر پاتھ؟ APC نہیں ہے۔
- ایک مشترکہ MCP اشارہ؟ APC۔
- ایک رن کیش (run cache)؟ APC نہیں ہے۔
یہ اصول آٹومیشن کو پائیدار بناتا ہے۔ APC آپ کو پورٹیبل معنی دیتا ہے۔ APX آپ کو مقامی حالت (local state) دیتا ہے۔
اس لکیر کو واضح رکھیں۔ یہ آپ کے اسٹیک (stack) کو ڈی بگ (debug) کرنے، شیئر کرنے اور مختلف ٹولز کے درمیان منتقل کرنے میں آسان بناتا ہے۔
اس سیاق و سباق کے لیے APC استعمال کریں جو ریپو کے ساتھ سفر کرتا ہے۔ اگر یہ ذاتی یا عارضی ہے، تو اسے مقامی رکھیں۔
ماخذ: https://dev.to/agentprojectcontext/global-context-belongs-outside-apc-4fg8
اختیاری لرننگ کمیونٹی: https://t.me/GyaanSetuAi