ગ્લોબલ કોન્ટેક્સ્ટ APC ની બહાર હોવું જોઈએ
APC એ પોર્ટેબલ કોન્ટેક્સ્ટ લેયર છે. APX એ લોકલ રનટાઇમ લેયર છે.
આ બંનેને વ્યવસ્થિત રાખવા માટે, એક નિયમનું પાલન કરો. જો કોઈ વસ્તુ નવા ક્લોન (fresh clone) પછી પણ ટકી રહેવી જોઈએ, તો તેને APC માં મૂકો. જો તે કોઈ ચોક્કસ યુઝર, મશીન અથવા પ્રોસેસ પર આધારિત હોય, તો તેને APC ની બહાર રાખો.
પ્રોજેક્ટ્સ વધે છે અને તેની સાથે લાલચ પણ આવે છે. તમે કદાચ વધુ એક સેટિંગ અથવા એક લોકલ પાથ ઉમેરવા માંગતા હોવ. જો તમે કડક ન હોવ, તો તમારું રિપો (repo) મશીન ડેટાનો કચરો બની જશે. આ રિપોને નાજુક (fragile) બનાવે છે.
APC પ્રોજેક્ટની માલિકીના અર્થ (meaning) ને જાળવી રાખે છે. તે એક રિપોઝિટરી દ્વારા વહન કરવામાં આવતો સહિયારો કરાર (shared contract) છે.
સારા APC કન્ટેન્ટમાં નીચેનાનો સમાવેશ થાય છે:
- પ્રોજેક્ટની ઓળખ
- એજન્ટ ભૂમિકાઓ
- ફરીથી ઉપયોગ કરી શકાય તેવી કુશળતા (Reusable skills)
- ક્યુરેટેડ પ્રોજેક્ટ મેમરી
- પ્રોજેક્ટ-લેવલના MCP હિન્ટ્સ
- AGENTS.md માં રિપો-વાઈડ સૂચનાઓ
ટીમના સાથી અથવા નવું મશીન ચેકઆઉટ (checkout) કર્યા પછી તરત જ આ તથ્યો વાંચી શકવું જોઈએ.
ગ્લોબલ કોન્ટેક્સ્ટ અલગ છે. તે યુઝર અથવા વર્કસ્ટેશનનું હોય છે.
ગ્લોબલ કોન્ટેક્સ્ટના ઉદાહરણો:
- API કીઝ
- એડિટર પસંદગીઓ (Editor preferences)
- લોકલ એલિયાસિસ (Local aliases)
- મશીન-સ્પેસિફિક ટૂલ પાથ
- પ્રાઇવેટ રનટાઇમ મેમરી
- કેશ (Caches)
- સેશન ટ્રાન્સક્રિપ્ટ્સ
- મેસેજ લોગ્સ
APX આ સ્ટેટને લોકલ રાખે છે. તે ~/.apx/ હેઠળ રનટાઇમ સ્ટેટ સ્ટોર કરે છે. આ પ્રોજેક્ટને શેર કરી શકાય તેવો રાખે છે.
આ લેયર્સને મિક્સ કરવાથી ત્રણ સમસ્યાઓ થાય છે:
- પોર્ટેબિલિટી તૂટી જાય છે. જે રિપો લોકલ કોન્ફિગ પર આધારિત હોય તેના પર વિશ્વાસ કરવો મુશ્કેલ છે.
- રિવ્યુઝમાં અવાજ (noise) વધે છે. પુલ રિક્વેસ્ટ્સ (Pull requests) પ્રોજેક્ટના નિર્ણયો બતાવવા જોઈએ, વર્કસ્ટેશનનો વધારાનો ડેટા નહીં.
- સિક્રેટ્સ લીક થાય છે. લોકલ વિગતો સ્ટોર કરવાથી ખોટી ફાઇલો કમિટ (commit) કરવી સરળ બની જાય છે.
કોઈ સેટિંગ ઉમેરતા પહેલા, આ પૂછો: શું અન્ય કન્ટ્રીબ્યુટરને ક્લોનિંગ કર્યા પછી તરત જ આની જરૂર પડશે?
જો હા, તો APC નો ઉપયોગ કરો.
- દરેક ક્લોન માટે રિવ્યુઅર એજન્ટ? APC.
- પર્સનલ API કી? APC નથી.
- પરમિશન અંગેનો પ્રોજેક્ટ નિર્ણય? APC.
- લોકલ બ્રાઉઝર પાથ? APC નથી.
- શેર કરેલ MCP હિન્ટ? APC.
- રન કેશ? APC નથી.
આ નિયમ ઓટોમેશનને ટકાઉ બનાવે છે. APC તમને પોર્ટેબલ અર્થ આપે છે. APX તમને લોકલ સ્ટેટ આપે છે.
આ ભેદ સ્પષ્ટ રાખો. તે તમારા સ્ટેકને ડિબગ કરવા, શેર કરવા અને ટૂલ્સ વચ્ચે ખસેડવા માટે સરળ બનાવે છે.
રિપો સાથે જે કોન્ટેક્સ્ટ જાય છે તેના માટે APC નો ઉપયોગ કરો. જો તે પર્સનલ અથવા ક્ષણિક (transient) હોય, તો તેને લોકલ રાખો.
Source: https://dev.to/agentprojectcontext/global-context-belongs-outside-apc-4fg8
Optional learning community: https://t.me/GyaanSetuAi