Konteks Global Berada di Luar APC

APC adalah lapisan konteks portabel. APX adalah lapisan runtime lokal.

Untuk menjaga kesehatan keduanya, ikuti satu aturan. Jika sesuatu harus tetap ada setelah melakukan clone baru, masukkan ke dalam APC. Jika sesuatu bergantung pada pengguna, mesin, atau proses tertentu, simpan di luar APC.

Proyek berkembang dan godaan pun datang. Anda mungkin ingin menambahkan satu pengaturan lagi atau satu jalur lokal. Jika Anda tidak disiplin, repositori Anda akan menjadi tempat penampungan data mesin. Hal ini membuat repositori menjadi rapuh.

APC menyimpan makna yang dimiliki proyek. Ini adalah kontrak bersama yang dibawa oleh sebuah repositori.

Konten APC yang baik meliputi:

  • Identitas proyek
  • Peran agen
  • Keahlian yang dapat digunakan kembali
  • Memori proyek yang terkurasi
  • Petunjuk MCP tingkat proyek
  • Instruksi di seluruh repo dalam AGENTS.md

Rekan tim atau mesin baru harus dapat membaca fakta-fakta ini segera setelah melakukan checkout.

Konteks global berbeda. Ia milik pengguna atau workstation.

Contoh konteks global:

  • Kunci API
  • Preferensi editor
  • Alias lokal
  • Jalur alat khusus mesin
  • Memori runtime pribadi
  • Cache
  • Transkrip sesi
  • Log pesan

APX menjaga status ini tetap lokal. Ia menyimpan status runtime di bawah ~/.apx/. Hal ini membuat proyek dapat dibagikan.

Mencampur lapisan-lapisan ini menyebabkan tiga masalah:

  1. Portabilitas rusak. Repositori yang bergantung pada konfigurasi lokal sulit untuk dipercaya.
  2. Review menjadi berisik. Pull request harus menunjukkan keputusan proyek, bukan beban workstation.
  3. Rahasia bocor. Menyimpan detail lokal memudahkan terjadinya commit file yang salah.

Sebelum Anda menambahkan pengaturan, tanyakan ini: Apakah kontributor lain akan membutuhkan ini segera setelah melakukan cloning?

Jika ya, gunakan APC.

  • Agen peninjau untuk setiap clone? APC.
  • Kunci API pribadi? Bukan APC.
  • Keputusan proyek tentang izin? APC.
  • Jalur browser lokal? Bukan APC.
  • Petunjuk MCP bersama? APC.
  • Cache eksekusi? Bukan APC.

Aturan ini membuat otomatisasi menjadi tahan lama. APC memberi Anda makna yang portabel. APX memberi Anda status lokal.

Jaga batasan tersebut tetap tegas. Ini membuat stack Anda lebih mudah untuk di-debug, dibagikan, dan dipindahkan antar alat.

Gunakan APC untuk konteks yang menyertai repositori. Jika bersifat pribadi atau sementara, simpanlah secara lokal.

Sumber: https://dev.to/agentprojectcontext/global-context-belongs-outside-apc-4fg8

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