APC క్లోన్-సేఫ్ (Clone-Safe) గా ఉండాలి, APX మెషిన్-లోకల్ (Machine-Local) గా ఉండాలి

డేటా ఎక్కడ ఉండాలో నిర్ణయించుకోవడానికి ఒకే ఒక ప్రశ్న అడగండి.

ఈ డేటా మరొక మెషిన్‌పై కొత్త క్లోన్ (fresh clone) చేసినప్పుడు కూడా అందుబాటులో ఉంటుందా?

అవును అయితే, దానిని APCలో ఉంచండి. కాకపోతే, దానిని APXలో ఉంచండి.

ఈ నియమం మీ స్టాక్ (stack) ని స్పష్టంగా ఉంచుతుంది. APC పోర్టబుల్ (portable) గా ఉంటుంది. APX పని చేస్తున్న మెషిన్‌పై ఉపయోగకరంగా ఉంటుంది. ఈ పొరలు (layers) కలిసిపోయినప్పుడు, ప్రాజెక్ట్‌లను పంచుకోవడం మరియు ఆడిట్ చేయడం కష్టమవుతుంది.

APC అనేది ప్రాజెక్ట్ కాంట్రాక్ట్. APX అనేది రన్‌టైమ్.

APC డేటా క్లోన్-సేఫ్. మరొక డెవలపర్ లేదా మెషిన్ git checkout చేసిన వెంటనే దానిని చదవగలగాలి. అది gitలో రివ్యూ చేయదగినదిగా ఉండాలి.

మంచి APC ఉదాహరణలు: • repo contracts కోసం AGENTS.md • project identity కోసం .apc/project.json • agent roles కోసం .apc/agents/ • reusable skills కోసం .apc/skills/ • shared hints కోసం .apc/mcps.json

APX డేటా మెషిన్-లోకల్. ఈ డేటా మెషిన్‌పైనే ఉంటుంది లేదా అక్కడ మళ్ళీ నిర్మించబడుతుంది (rebuilt). ఇది ఎగ్జిక్యూషన్ స్టేట్ (execution state), పోర్టబుల్ కాంటెక్స్ట్ కాదు.

మంచి APX ఉదాహరణలు: • ~/.apx/config.json లో runtime config • లోకల్ పర్మిషన్ మోడ్స్ (Local permission modes) • సెషన్లు మరియు మెసేజ్ లాగ్‌లు (Sessions and message logs) • లోకల్ క్యాచెస్ (Local caches) • ప్రతి మెషిన్‌కు సంబంధించిన సీక్రెట్స్ (Per-machine secrets)

ఒక రిపోజిటరీ (repository) ఒక వ్యక్తి యొక్క లోకల్ సెటప్‌ను ఇతరులందరిపై రుద్దకూడదు.

APC క్లోన్-సేఫ్ గా ఉన్నప్పుడు, మీరు దాగి ఉన్న ఫైల్స్ (hidden files) లేకుండా ప్రాజెక్ట్ రూపాన్ని రివ్యూ చేయవచ్చు. సైడ్ ఎఫెక్ట్స్ (side effects) కోసం వెతకడం కంటే, ఇన్‌స్ట్రక్షన్స్ (instructions) మధ్య తేడాలను (diff) చూడవచ్చు.

APX మెషిన్-లోకల్ గా ఉన్నప్పుడు, ప్రాజెక్ట్‌ను మార్చకుండానే రన్‌టైమ్ సర్దుబాటు అవుతుంది. ఒక మెషిన్ వేరే పర్మిషన్ మోడ్‌ను ఉపయోగిస్తుంటే, మరొకటి ఎక్కువ హిస్టరీని కలిగి ఉండవచ్చు. ప్రాజెక్ట్ కాంట్రాక్ట్ మాత్రం ఒకేలా ఉంటుంది.

మీరు కొత్త ఫైల్‌ను జోడించే ముందు, ఈ మూడు ప్రశ్నలు అడగండి:

  1. ప్రతి అనుకూలమైన టూల్ (compatible tool) దీనిని చదవాలా? అయితే దానిని APCలో ఉంచండి.
  2. ఇది మెషిన్ గురించి కాకుండా ప్రాజెక్ట్ గురించి వివరిస్తుందా? అయితే దానిని APCలో ఉంచండి.
  3. ఇది లోకల్ క్రెడెన్షియల్స్ (local credentials) లేదా ఇటీవలి ఎగ్జిక్యూషన్ (recent execution) పై ఆధారపడి ఉందా? అయితే దానిని APXలో ఉంచండి.

ఉదాహరణలు: • కొత్త ఏజెంట్ రోల్ (agent role)? APC. • టెలిగ్రామ్ బాట్ టోకెన్ (Telegram bot token)? APX. • ప్రాజెక్ట్ రివ్యూ రూల్స్ గురించి నోట్? APC. • చివరి సంభాషణ యొక్క లాగ్ (log)? 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