APC क्लोन-सेफ (Clone-Safe) राहिले पाहिजे, APX मशीन-लोकल (Machine-Local) राहिले पाहिजे
एक प्रश्न विचारून डेटा कुठे असावा हे ठरवा.
हा डेटा दुसऱ्या मशीनवर नवीन क्लोन (fresh clone) केल्यावरही टिकून राहील का?
जर उत्तर 'हो' असेल, तर तो APC मध्ये ठेवा. जर 'नाही' असेल, तर तो APX मध्ये ठेवा.
हा नियम तुमचा स्टॅक (stack) पारदर्शक ठेवतो. APC पोर्टेबल राहतो. APX काम करणाऱ्या मशीनवर उपयुक्त राहतो. जेव्हा हे स्तर (layers) एकमेकांत मिसळतात, तेव्हा प्रोजेक्ट्स शेअर करणे आणि ऑडिट करणे कठीण होते.
APC हा प्रोजेक्ट कॉन्ट्रॅक्ट (project contract) आहे. APX हा रनटाइम (runtime) आहे.
APC डेटा क्लोन-सेफ असतो. दुसऱ्या डेव्हलपरने किंवा मशीनने git checkout केल्यावर तो लगेच वाचता आला पाहिजे. तो git मध्ये रिव्ह्यू (review) करता येण्याजोगा असावा.
चांगल्या APC उदाहरणांमध्ये: • रेपो कॉन्ट्रॅक्ट्ससाठी (repo contracts) AGENTS.md • प्रोजेक्ट आयडेंटिटीसाठी .apc/project.json • एजंट रोल्ससाठी .apc/agents/ • पुन्हा वापरता येण्याजोग्या स्किल्ससाठी .apc/skills/ • शेअर्ड हिंट्ससाठी .apc/mcps.json
APX डेटा मशीन-लोकल असतो. हा डेटा त्याच मशीनवर राहतो किंवा तिथेच पुन्हा तयार (rebuild) केला जातो. हा एक्झिक्यूशन स्टेट (execution state) आहे, पोर्टेबल कॉन्टेक्स्ट (portable context) नाही.
चांगल्या APX उदाहरणांमध्ये: • ~/.apx/config.json मधील रनटाइम कॉन्फिग (Runtime config) • लोकल परमिशन मोड्स (Local permission modes) • सेशन्स आणि मेसेज लॉग्स (Sessions and message logs) • लोकल कॅशेस (Local caches) • प्रति-मशीन सीक्रेट्स (Per-machine secrets)
एका रिपॉझिटरीने (repository) एका व्यक्तीचे लोकल सेटअप इतरांवर लादले जाऊ नये.
जेव्हा APC क्लोन-सेफ राहतो, तेव्हा तुम्ही लपविलेल्या फाईल्सशिवाय प्रोजेक्टचे स्वरूप रिव्ह्यू करू शकता. साईड इफेक्ट्स (side effects) शोधण्याऐवजी तुम्ही सूचनांमधील फरक (diff instructions) पाहू शकता.
जेव्हा APX मशीन-लोकल राहतो, तेव्हा प्रोजेक्टमध्ये बदल न करता रनटाइम स्वतःला जुळवून घेतो. एखादे मशीन वेगळा परमिशन मोड वापरू शकते, तर दुसरे मशीन अधिक मोठा इतिहास (history) ठेवू शकते. प्रोजेक्ट कॉन्ट्रॅक्ट तेच राहते.
नवीन फाईल जोडण्यापूर्वी, हे तीन प्रश्न स्वतःला विचारा:
- प्रत्येक सुसंगत टूलला (compatible tool) हे वाचण्याची गरज आहे का? तर ते APC मध्ये ठेवा.
- ते मशीनऐवजी प्रोजेक्टचे वर्णन करते का? तर ते APC मध्ये ठेवा.
- ते लोकल क्रेडेंशियल्स (local 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