APC குளோன்-பாதுகாப்பாக (Clone-Safe) இருக்க வேண்டும், APX இயந்திரத்திற்கு உள்ளூர் (Machine-Local) ஆக இருக்க வேண்டும்
தரவு எங்கு இருக்க வேண்டும் என்பதை ஒரு கேள்வியைக் கேட்பதன் மூலம் தீர்மானிக்கவும்.
இந்தத் தரவு மற்றொரு இயந்திரத்தில் புதிய குளோன் (fresh clone) செய்யப்பட்டாலும் அப்படியே இருக்குமா?
ஆம் என்றால், அதை APC-இல் வைக்கவும். இல்லை என்றால், அதை APX-இல் வைக்கவும்.
இந்த விதி உங்கள் ஸ்டேக் (stack) நேர்மையாக இருக்க உதவுகிறது. APC எளிதில் நகர்த்தக்கூடியதாக (portable) இருக்கும். APX வேலையைச் செய்யும் இயந்திரத்தில் பயனுள்ளதாக இருக்கும். இந்த அடுக்குகள் (layers) ஒன்றோடொன்று கலக்கும்போது, திட்டங்களைப் பகிர்வதும் தணிக்கை (audit) செய்வதும் கடினமாகிவிடும்.
APC என்பது திட்ட ஒப்பந்தம் (project contract). APX என்பது ரன்டைம் (runtime).
APC தரவு குளோன்-பாதுகாப்பானது. மற்றொரு டெவலப்பர் அல்லது இயந்திரம் ஒரு git checkout செய்தவுடன் அதை உடனடியாகப் படிக்க முடிய வேண்டும். அது git-இல் ஆய்வு செய்யக்கூடியதாக இருக்க வேண்டும்.
நல்ல APC உதாரணங்கள்: • AGENTS.md (repo ஒப்பந்தங்களுக்கு) • .apc/project.json (திட்ட அடையாளத்திற்கு) • .apc/agents/ (ஏஜென்ட் பாத்திரங்களுக்கு) • .apc/skills/ (மீண்டும் பயன்படுத்தக்கூடிய திறன்களுக்கு) • .apc/mcps.json (பகிரப்பட்ட குறிப்புகளுக்கு)
APX தரவு இயந்திரத்திற்கு உள்ளூர் (machine-local) ஆனது. இந்தத் தரவு அந்த இயந்திரத்திலேயே இருக்கும் அல்லது அங்கு மீண்டும் உருவாக்கப்படும். இது செயல்பாட்டு நிலை (execution state), நகர்த்தக்கூடிய சூழல் (portable context) அல்ல.
நல்ல APX உதாரணங்கள்: • ~/.apx/config.json-இல் உள்ள ரன்டைம் கட்டமைப்பு (Runtime config) • உள்ளூர் அனுமதி முறைகள் (Local permission modes) • அமர்வுகள் மற்றும் செய்திப் பதிவுகள் (Sessions and message logs) • உள்ளூர் கேச்சுகள் (Local caches) • இயந்திரத்திற்குத் தனிப்பட்ட ரகசியங்கள் (Per-machine secrets)
ஒரு ரிப்போசிட்டரி (repository), ஒரு நபரின் உள்ளூர் அமைப்பை (local setup) மற்ற அனைவருக்கும் கட்டாயப்படுத்தக் கூடாது.
APC குளோன்-பாதுகாப்பாக இருக்கும்போது, மறைக்கப்பட்ட கோப்புகள் (hidden files) இன்றி திட்டத்தின் அமைப்பை நீங்கள் ஆய்வு செய்யலாம். பக்கவிளைவுகளைத் (side effects) தேடி அலைவதற்குப் பதிலாக, வழிமுறைகளை (instructions) ஒப்பிட்டுப் (diff) பார்க்கலாம்.
APX இயந்திரத்திற்கு உள்ளூர் ஆக இருக்கும்போது, திட்டத்தை மாற்றாமல் ரன்டைம் தானாகவே தகவமைத்துக் கொள்ளும். ஒரு இயந்திரம் வேறுபட்ட அனுமதி முறையைப் பயன்படுத்தலாம், மற்றொரு இயந்திரம் நீண்ட வரலாற்றைப் பராமரிக்கலாம். ஆனால் திட்ட ஒப்பந்தம் மாறாமல் இருக்கும்.
ஒரு புதிய கோப்பைச் சேர்ப்பதற்கு முன், இந்த மூன்று கேள்விகளைக் கேட்கவும்:
- இதை அனைத்து இணக்கமான கருவிகளும் (compatible tools) படிக்க வேண்டுமா? APC-இல் வைக்கவும்.
- இது இயந்திரத்திற்குப் பதிலாகத் திட்டத்தைப் பற்றியதா? APC-இல் வைக்கவும்.
- இது உள்ளூர் சான்றுகள் (local credentials) அல்லது சமீபத்திய செயல்பாட்டைச் சார்ந்ததா? APX-இல் வைக்கவும்.
உதாரணங்கள்: • புதிய ஏஜென்ட் பாத்திரமா? APC. • டெலிகிராம் பாட் டோக்கனா? APX. • திட்ட ஆய்வு விதிகள் பற்றிய குறிப்பா? APC. • கடைசி உரையாடலின் பதிவா? APX.
குளோன் செய்யப்பட்ட பின்னும் நிலைத்திருப்பவற்றை APC சுமந்து செல்கிறது. தற்போதைய இயந்திரத்தில் மட்டுமே முக்கியத்துவம் வாய்ந்தவற்றை APX சுமந்து செல்கிறது. இந்த எளிய விதி அமைப்பைச் சீராக வைத்திருக்கும்.
Source: https://dev.to/agentprojectcontext/apc-should-stay-clone-safe-apx-should-stay-machine-local-59n9
Optional learning community: https://t.me/GyaanSetuAi