APC को क्लोन-सेफ (clone-safe) रहना चाहिए, APX को मशीन-लोकल (machine-local) रहना चाहिए
केवल एक प्रश्न पूछकर तय करें कि डेटा कहाँ होना चाहिए।
क्या यह डेटा किसी अन्य मशीन पर नए क्लोन (fresh clone) के बाद भी सुरक्षित रहेगा?
यदि हाँ, तो इसे APC में रखें। यदि नहीं, तो इसे APX में रखें।
यह नियम आपके स्टैक (stack) को सटीक रखता है। APC पोर्टेबल रहता है। APX उस मशीन पर उपयोगी रहता है जहाँ काम चल रहा है। जब ये परतें आपस में मिल जाती हैं, तो प्रोजेक्ट्स को साझा करना और ऑडिट करना कठिन हो जाता है।
APC प्रोजेक्ट कॉन्ट्रैक्ट (project contract) है। APX रनटाइम (runtime) है।
APC डेटा क्लोन-सेफ होता है। किसी अन्य डेवलपर या मशीन को git checkout के तुरंत बाद इसे पढ़ पाना चाहिए। इसे git में रिव्यू किया जा सकना चाहिए।
अच्छे APC उदाहरण: • रेपो कॉन्ट्रैक्ट्स के लिए AGENTS.md • प्रोजेक्ट की पहचान के लिए .apc/project.json • एजेंट भूमिकाओं के लिए .apc/agents/ • पुन: प्रयोज्य स्किल्स के लिए .apc/skills/ • साझा संकेतों के लिए .apc/mcps.json
APX डेटा मशीन-लोकल होता है। यह डेटा मशीन पर ही रहता है या वहीं फिर से बनाया जाता है। यह एक्जीक्यूशन स्टेट (execution state) है, पोर्टेबल कॉन्टेक्स्ट (portable context) नहीं।
अच्छे APX उदाहरण: • ~/.apx/config.json में रनटाइम कॉन्फ़िगरेशन • लोकल परमिशन मोड • सेशन्स और मैसेज लॉग्स • लोकल कैशे (caches) • प्रति-मशीन सीक्रेट्स (secrets)
एक रिपॉजिटरी को किसी एक व्यक्ति के लोकल सेटअप को दूसरों पर थोपना नहीं चाहिए।
जब APC क्लोन-सेफ रहता है, तो आप छिपी हुई फाइलों के बिना प्रोजेक्ट के स्वरूप (shape) की समीक्षा कर सकते हैं। आप साइड इफेक्ट्स (side effects) का पीछा करने के बजाय निर्देशों का diff कर सकते हैं।
जब APX मशीन-लोकल रहता है, तो रनटाइम प्रोजेक्ट को बदले बिना खुद को ढाल लेता है। एक मशीन अलग परमिशन मोड का उपयोग कर सकती है, जबकि दूसरी मशीन अधिक लंबा इतिहास (history) रख सकती है। प्रोजेक्ट कॉन्ट्रैक्ट वही रहता है।
कोई नई फ़ाइल जोड़ने से पहले, ये तीन प्रश्न पूछें:
- क्या हर संगत टूल (compatible tool) को इसे पढ़ने की आवश्यकता है? इसे APC में रखें।
- क्या यह मशीन के बजाय प्रोजेक्ट का वर्णन करता है? इसे APC में रखें।
- क्या यह लोकल क्रेडेंशियल्स (credentials) या हालिया एक्जीक्यूशन पर निर्भर है? इसे APX में रखें।
उदाहरण: • एक नई एजेंट भूमिका? APC। • एक टेलीग्राम बॉट टोकन? APX। • प्रोजेक्ट रिव्यू नियमों के बारे में एक नोट? APC। • पिछली बातचीत का लॉग? APX।
APC वह चीज़ रखता है जो क्लोन के बाद भी बनी रहती है। APX वह चीज़ रखता है जो केवल वर्तमान मशीन पर मायने रखती है। यह सरल नियम सिस्टम को व्यवस्थित रखता है।
स्रोत: https://dev.to/agentprojectcontext/apc-should-stay-clone-safe-apx-should-stay-machine-local-59n9
वैकल्पिक लर्निंग कम्युनिटी: https://t.me/GyaanSetuAi