APC Harus Tetap Aman Saat Di-clone, APX Harus Tetap Lokal di Mesin

Tentukan di mana data seharusnya berada dengan mengajukan satu pertanyaan.

Apakah data ini akan tetap valid setelah melakukan clone baru di mesin lain?

Jika ya, masukkan ke APC. Jika tidak, masukkan ke APX.

Aturan ini menjaga integritas stack Anda. APC tetap portabel. APX tetap berguna pada mesin yang menjalankan pekerjaan tersebut. Ketika lapisan-lapisan ini kabur, proyek menjadi sulit untuk dibagikan dan sulit untuk diaudit.

APC adalah kontrak proyek. APX adalah runtime.

Data APC aman saat di-clone. Pengembang atau mesin lain harus dapat membacanya segera setelah melakukan git checkout. Data tersebut harus dapat ditinjau di git.

Contoh APC yang baik: • AGENTS.md untuk kontrak repo • .apc/project.json untuk identitas proyek • .apc/agents/ untuk peran agen • .apc/skills/ untuk skill yang dapat digunakan kembali • .apc/mcps.json untuk petunjuk bersama

Data APX bersifat lokal di mesin. Data ini tetap berada di mesin tersebut atau dibangun ulang di sana. Ini adalah status eksekusi, bukan konteks portabel.

Contoh APX yang baik: • Konfigurasi runtime di ~/.apx/config.json • Mode izin lokal • Sesi dan log pesan • Cache lokal • Secret per-mesin

Sebuah repositori tidak boleh memaksakan pengaturan lokal satu orang kepada orang lain.

Ketika APC tetap aman saat di-clone, Anda dapat meninjau struktur proyek tanpa file tersembunyi. Anda dapat melakukan diff pada instruksi alih-alih mengejar efek samping.

Ketika APX tetap lokal di mesin, runtime dapat beradaptasi tanpa mengubah proyek. Satu mesin menggunakan mode izin yang berbeda, sementara mesin lain menyimpan riwayat yang lebih panjang. Kontrak proyek tetap sama.

Sebelum Anda menambahkan file baru, ajukan tiga pertanyaan ini:

  1. Apakah setiap alat yang kompatibel perlu membaca ini? Masukkan ke APC.
  2. Apakah ini mendeskripsikan proyek, bukan mesin? Masukkan ke APC.
  3. Apakah ini bergantung pada kredensial lokal atau eksekusi terbaru? Masukkan ke APX.

Contoh: • Peran agen baru? APC. • Token bot Telegram? APX. • Catatan tentang aturan peninjauan proyek? APC. • Log percakapan terakhir? APX.

APC membawa apa yang bertahan setelah di-clone. APX membawa apa yang hanya penting pada mesin saat ini. Aturan sederhana ini menjaga sistem tetap masuk akal.

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

Komunitas pembelajaran opsional: https://t.me/GyaanSetuAi