Global Context Belongs Outside APC
APC هي طبقة السياق المحمولة. APX هي طبقة وقت التشغيل المحلية.
للحفاظ على سلامة هذه الطبقات، اتبع قاعدة واحدة: إذا كان هناك شيء يجب أن يظل موجوداً بعد عملية استنساخ (clone) جديدة، فقم بوضعه في APC. أما إذا كان يعتمد على مستخدم أو جهاز أو عملية محددة، فابقِه خارج نطاق APC.
تكبر المشاريع وتتبعها المغريات. قد ترغب في إضافة إعداد إضافي أو مسار محلي واحد. إذا لم تكن صارماً، سيتحول مستودعك (repo) إلى مستودع لبيانات الجهاز، مما يجعل المستودع هشاً.
تحتوي APC على المعاني المملوكة للمشروع. إنها العقد المشترك الذي يحمله المستودع.
يتضمن محتوى APC الجيد ما يلي:
- هوية المشروع
- أدوار الوكيل (Agent roles)
- مهارات قابلة لإعادة الاستخدام
- ذاكرة مشروع منسقة
- تلميحات MCP على مستوى المشروع
- تعليمات على مستوى المستودع في AGENTS.md
يجب على زميل في الفريق أو جهاز جديد قراءة هذه الحقائق مباشرة بعد عملية الـ checkout.
السياق العالمي مختلف؛ فهو ينتمي إلى مستخدم أو محطة عمل.
أمثلة على السياق العالمي:
- مفاتيح API
- تفضيلات المحرر
- الأسماء المستعارة المحلية (Local aliases)
- مسارات الأدوات الخاصة بالجهاز
- ذاكرة وقت تشغيل خاصة
- ذاكرة التخزين المؤقت (Caches)
- نصوص الجلسات (Session transcripts)
- سجلات الرسائل
يحافظ APX على هذه الحالة محلية، حيث يخزن حالة وقت التشغيل تحت ~/.apx/. وهذا يحافظ على إمكانية مشاركة المشروع.
يؤدي خلط هذه الطبقات إلى ثلاث مشكلات:
- تعطل قابلية النقل. فالمستودع الذي يعتمد على إعدادات محلية يصعب الوثوق به.
- تصبح المراجعات مشتتة. يجب أن تظهر طلبات السحب (Pull requests) قرارات المشروع، وليس "أعباء" محطة العمل.
- تسريب الأسرار. تخزين التفاصيل المحلية يجعل من السهل إرسال (commit) الملفات الخاطئة.
قبل إضافة أي إعداد، اسأل نفسك: هل سيحتاج مساهم آخر إلى هذا الشيء فوراً بعد عملية الاستنساخ (cloning)؟
إذا كانت الإجابة نعم، فاستخدم APC.
- وكيل مراجعة لكل عملية استنساخ؟ APC.
- مفتاح API شخصي؟ ليس APC.
- قرار مشروع بشأن الأذونات؟ APC.
- مسار متصفح محلي؟ ليس APC.
- تلميح MCP مشترك؟ APC.
- ذاكرة تخزين مؤقت للتشغيل؟ ليس APC.
تجعل هذه القاعدة الأتمتة مستدامة. تمنحك APC المعنى القابل للنقل، بينما يمنحك APX الحالة المحلية.
حافظ على وضوح هذا الخط الفاصل؛ فهذا يجعل بنيتك التقنية (stack) أسهل في تصحيح الأخطاء، والمشاركة، والنقل بين الأدوات.
استخدم APC للسياق الذي ينتقل مع المستودع. أما إذا كان شخصياً أو مؤقتاً، فابقِه محلياً.
Source: https://dev.to/agentprojectcontext/global-context-belongs-outside-apc-4fg8
Optional learning community: https://t.me/GyaanSetuAi