APC Inapaswa Kubaki Salama kwa Clone, APX Inapaswa Kubaki ya Mashine-Local

Amua mahali data inapaswa kuwa kwa kuuliza swali moja.

Je, data hii itastahimili clone mpya kwenye mashine nyingine?

Kama ndiyo, iweke kwenye APC. Kama hapana, iweke kwenye APX.

Sheria hii inafanya stack yako iwe ya uaminifu. APC inabaki kuwa inayohamishika (portable). APX inabaki kuwa muhimu kwenye mashine inayotekeleza kazi. Tabaka hizi zinapochanganyika, miradi inakuwa ngumu kushirikiwa na ngumu kufanyiwa ukaguzi.

APC ni mkataba wa mradi. APX ni runtime.

Data ya APC ni salama kwa clone. Msanidi mwingine au mashine nyingine inapaswa kuweza kuisoma mara tu baada ya kufanya git checkout. Lazima iweze kukaguliwa kwenye git.

Mifano mizuri ya APC: • AGENTS.md kwa mikataba ya repo • .apc/project.json kwa utambulisho wa mradi • .apc/agents/ kwa majukumu ya agent • .apc/skills/ kwa ujuzi unaoweza kutumika tena • .apc/mcps.json kwa maelekezo ya pamoja

Data ya APX ni ya mashine-local. Data hii inabaki kwenye mashine au hujengwa upya hapo. Ni hali ya utekelezaji (execution state), si muktadha unaohamishika.

Mifano mizuri ya APX: • Runtime config kwenye ~/.apx/config.json • Hali za ruhusa za ndani (Local permission modes) • Vikao na kumbukumbu za ujumbe (message logs) • Cache za ndani • Siri za kila mashine (Per-machine secrets)

Repository haipaswi kulazimisha mipangilio ya ndani ya mtu mmoja kwa kila mtu mwingine.

APC inapobaki salama kwa clone, unaweza kukagua muundo wa mradi bila mafaili yaliyofichwa. Unaweza kufanya diff kwenye maelekezo badala ya kutafuta athari zisizotarajiwa (side effects).

APX inapobaki ya mashine-local, runtime inabadilika bila kubadilisha mradi. Mashine moja inaweza kutumia hali tofauti ya ruhusa, wakati nyingine inahifadhi historia ndefu zaidi. Mkataba wa mradi unabaki vilevile.

Kabla ya kuongeza faili jipya, jiulize maswali haya matatu:

  1. Je, kila kifaa kinachohusika kinahitaji kusoma hii? Iweke kwenye APC.
  2. Je, inaelezea mradi badala ya mashine? Iweke kwenye APC.
  3. Je, inategemea sifa za utambulisho (credentials) za ndani au utekelezaji wa hivi karibuni? Iweke kwenye APX.

Mifano: • Jukumu jipya la agent? APC. • Tokeni ya bot ya Telegram? APX. • Maelezo kuhusu sheria za ukaguzi wa mradi? APC. • Log ya mazungumzo ya mwisho? APX.

APC hubeba kile kinachostahimili clone. APX hubeba kile kinachojali tu kwenye mashine ya sasa. Sheria hii rahisi inafanya mfumo uwe na utaratibu.

Chanzo: https://dev.to/agentprojectcontext/apc-should-stay-clone-safe-apx-should-stay-machine-local-59n9

Jumuiya ya kujifunza ya hiari: https://t.me/GyaanSetuAi