உலகளாவிய சூழல் (Global Context) APC-க்கு வெளியே இருக்க வேண்டும்
APC என்பது எளிதில் நகர்த்தக்கூடிய சூழல் அடுக்கு (portable context layer). APX என்பது உள்ளூர் இயக்க அடுக்கு (local runtime layer).
இவற்றைச் சரியாகப் பராமரிக்க, ஒரு விதியைப் பின்பற்றுங்கள். ஒரு புதிய குளோன் (clone) செய்யப்பட்ட பிறகும் ஏதேனும் ஒன்று அப்படியே இருக்க வேண்டும் என்றால், அதை APC-இல் வைக்கவும். அது ஒரு குறிப்பிட்ட பயனர், இயந்திரம் அல்லது செயல்முறையைச் சார்ந்து இருந்தால், அதை APC-க்கு வெளியே வைத்திருக்கவும்.
திட்டங்கள் வளரும்போது ஆசைகளும் வரும். நீங்கள் இன்னும் ஒரு அமைப்பையோ (setting) அல்லது ஒரு உள்ளூர் பாதையையோ (local path) சேர்க்க விரும்பலாம். நீங்கள் இதில் கண்டிப்புடன் இல்லையென்றால், உங்கள் ரெப்போ (repo) இயந்திரத் தரவுகளின் குப்பையாக மாறிவிடும். இது ரெப்போவை பலவீனமாக்கும்.
APC என்பது திட்டத்திற்குச் சொந்தமான அர்த்தங்களைக் கொண்டுள்ளது. இது ஒரு ரெப்போ சுமந்து செல்லும் பகிரப்பட்ட ஒப்பந்தமாகும்.
சிறந்த APC உள்ளடக்கத்தில் இவை அடங்கும்:
- திட்ட அடையாளம் (Project identity)
- ஏஜென்ட் பங்குகள் (Agent roles)
- மீண்டும் பயன்படுத்தக்கூடிய திறன்கள் (Reusable skills)
- தொகுக்கப்பட்ட திட்ட நினைவகம் (Curated project memory)
- திட்ட அளவிலான MCP குறிப்புகள் (Project-level MCP hints)
- AGENTS.md-இல் உள்ள ரெப்போ முழுமைக்கான அறிவுறுத்தல்கள் (Repo-wide instructions in AGENTS.md)
ஒரு குழு உறுப்பினர் அல்லது புதிய இயந்திரம், ஒரு செக்-அவுட் (checkout) செய்தவுடன் இந்தத் தகவல்களைப் படிக்க வேண்டும்.
உலகளாவிய சூழல் (Global context) வேறுபட்டது. இது ஒரு பயனர் அல்லது ஒரு பணிநிலையத்திற்கு (workstation) உரியது.
உலகளாவிய சூழலுக்கான உதாரணங்கள்:
- API சாவிகள் (API keys)
- எடிட்டர் விருப்பத்தேர்வுகள் (Editor preferences)
- உள்ளூர் பட்டப்பெயர்கள் (Local aliases)
- இயந்திரம் சார்ந்த கருவி பாதைகள் (Machine-specific tool paths)
- தனிப்பட்ட இயக்க நினைவகம் (Private runtime memory)
- கேஷ்கள் (Caches)
- அமர்வுப் பதிவுகள் (Session transcripts)
- செய்திப் பதிவுகள் (Message logs)
APX இந்த நிலையை உள்ளூரிலேயே வைத்திருக்கும். இது இயக்க நிலையை ~/.apx/ என்பதன் கீழ் சேமிக்கிறது. இது திட்டத்தைப் பகிரக்கூடியதாக வைத்திருக்கிறது.
இந்த அடுக்குகளைக் கலப்பது மூன்று சிக்கல்களை ஏற்படுத்துகிறது:
- எளிதில் நகர்த்தும் திறன் (Portability) பாதிக்கப்படும். உள்ளூர் உள்ளமைப்பைப் (local config) பொறுத்திருக்கும் ஒரு ரெப்போவை நம்புவது கடினம்.
- ஆய்வுகள் (Reviews) குழப்பமடையும். புல் ரிக்வெஸ்ட்கள் (Pull requests) திட்ட முடிவுகளை மட்டுமே காட்ட வேண்டும், பணிநிலையத்தின் தேவையற்ற தரவுகளை அல்ல.
- ரகசியங்கள் கசியக்கூடும். உள்ளூர் விவரங்களைச் சேமிப்பது தவறான கோப்புகளை கமிட் (commit) செய்ய வழிவகுக்கும்.
ஒரு அமைப்பைக் (setting) சேர்ப்பதற்கு முன், இதைக் கேளுங்கள்: மற்றொரு பங்களிப்பாளர் (contributor) குளோன் செய்தவுடன் இதை உடனடியாகத் தேவையாகக் கொள்வாரா?
ஆம் எனில், APC-ஐப் பயன்படுத்தவும்.
- ஒவ்வொரு குளோனுக்கும் ஒரு ஆய்வாளர் ஏஜென்ட் (reviewer agent)? APC.
- ஒரு தனிப்பட்ட API சாவி? APC அல்ல.
- அனுமதிகள் குறித்த திட்ட முடிவு? APC.
- ஒரு உள்ளூர் பிரவுசர் பாதை? APC அல்ல.
- ஒரு பகிரப்பட்ட MCP குறிப்பு? APC.
- ஒரு ரன் கேச் (run cache)? APC அல்ல.
இந்த விதி ஆட்டோமேஷனை (automation) நிலைத்ததாக்குகிறது. APC உங்களுக்கு எளிதில் நகர்த்தக்கூடிய அர்த்தத்தைத் தருகிறது. APX உங்களுக்கு உள்ளூர் நிலையைத் தருகிறது.
இந்த எல்லையைத் தெளிவாக வைத்திருங்கள். இது உங்கள் ஸ்டேக் (stack)-ஐ பிழைத்திருத்தம் (debug) செய்யவும், பகிரவும் மற்றும் கருவிகளுக்கு இடையே நகர்த்தவும் எளிதாக்கும்.
ரெப்போவோடு பயணிக்கும் சூழலுக்கு APC-ஐப் பயன்படுத்தவும். அது தனிப்பட்டதாகவோ அல்லது தற்காலிகமானதாகவோ இருந்தால், அதை உள்ளூரிலேயே வைத்திருக்கவும்.
Source: https://dev.to/agentprojectcontext/global-context-belongs-outside-apc-4fg8
Optional learning community: https://t.me/GyaanSetuAi