APC Klonlamaya Uygun (Clone-Safe) Kalmalı, APX Makineye Özel (Machine-Local) Kalmalı
Verinin nereye ait olduğuna tek bir soru sorarak karar verin.
Bu veri, başka bir makinede yapılacak yeni bir klonlama işleminden sonra varlığını sürdürür mü?
Cevap evet ise APC'ye, hayır ise APX'e koyun.
Bu kural, teknoloji yığınınızın (stack) tutarlı kalmasını sağlar. APC taşınabilir kalır. APX, işi yürüten makinede kullanışlı kalır. Bu katmanlar birbirine karıştığında, projeleri paylaşmak ve denetlemek zorlaşır.
APC proje sözleşmesidir. APX ise çalışma zamanıdır (runtime).
APC verisi klonlamaya uygundur. Başka bir geliştirici veya makine, bir git checkout işleminden hemen sonra bu veriyi okuyabilmelidir. Git üzerinden incelenebilir olmalıdır.
İyi APC örnekleri: • repo sözleşmeleri için AGENTS.md • proje kimliği için .apc/project.json • ajan rolleri için .apc/agents/ • yeniden kullanılabilir yetenekler için .apc/skills/ • paylaşılan ipuçları için .apc/mcps.json
APX verisi makineye özeldir (machine-local). Bu veri makinede kalır veya orada yeniden oluşturulur. Bu, taşınabilir bir bağlam değil, çalışma durumudur (execution state).
İyi APX örnekleri: • ~/.apx/config.json içindeki çalışma zamanı yapılandırması • Yerel izin modları • Oturumlar ve mesaj günlükleri • Yerel önbellekler • Makineye özel gizli bilgiler (secrets)
Bir depo (repository), bir kişinin yerel kurulumunu diğer herkese dayatmamalıdır.
APC klonlamaya uygun kaldığında, gizli dosyalarla uğraşmadan projenin yapısını inceleyebilirsiniz. Yan etkilerin peşinden koşmak yerine talimatları karşılaştırabilirsiniz (diff).
APX makineye özel kaldığında, çalışma zamanı projeyi değiştirmeden uyum sağlar. Bir makine farklı bir izin modu kullanırken, diğeri daha uzun bir geçmiş tutabilir. Proje sözleşmesi aynı kalır.
Yeni bir dosya eklemeden önce şu üç soruyu sorun:
- Bunu her uyumlu aracın okuması gerekiyor mu? APC'ye koyun.
- Makine yerine projeyi mi tanımlıyor? APC'ye koyun.
- Yerel kimlik bilgilerine veya son çalıştırmaya mı bağlı? APX'e koyun.
Örnekler: • Yeni bir ajan rolü mü? APC. • Bir Telegram bot token'ı mı? APX. • Proje inceleme kuralları hakkında bir not mu? APC. • Son konuşmanın günlüğü mü? APX.
APC, klonlamadan sonra hayatta kalanları taşır. APX, yalnızca mevcut makinede önemli olanları taşır. Bu basit kural, sistemin düzenli kalmasını sağlar.
Kaynak: https://dev.to/agentprojectcontext/apc-should-stay-clone-safe-apx-should-stay-machine-local-59n9
İsteğe bağlı öğrenme topluluğu: https://t.me/GyaanSetuAi