Registri harness

Registri harness adalah inventaris adapter yang menjadi sumber kebenaran, yang digunakan oleh CLI, dokumentasi, pengujian fixture, dan validasi pin konvensi. Sumber runtime-nya adalah src/apothem/lib/harness_registry.py; setiap baris di bawah dapat dilacak ke registri itu, ke capabilities.yml per adapter, dan ke STANDARD-CONVENTION-PIN.md milik setiap adapter.

Matriks registriCopy Anchor Link

Dukungan kohor muatanCopy Anchor Link

Nilai status adalah native, converted, support-tree, profile-projected, unsupported, not-applicable, dan discovery-pending.

Kohor converted ditulis ulang ke dalam format milik harness itu sendiri, dan sebagian field sumber tidak memiliki tempat di dalamnya. Untuk setiap kohor command, agen, atau aturan yang dikonversi, capabilities.yml milik adapter membawa map conversion_losses yang menyatakan apa yang terjadi pada setiap field frontmatter sumber:

Sebuah pengujian merender setiap berkas hasil konversi dan memeriksa map tersebut terhadap keluarannya.

Tabel ini menghilangkan sel yang ditandai registri sebagai not-applicable: pembatasan tool di setiap harness kecuali Kimi Code (discovery-pending) dan GLM (Z.ai) (unsupported), dan memori di Claude Code, CodeBuddy, Codex, Hermes, Kiro, Open-Claw, OpenCode, dan Qwen Code.

Root bersamaCopy Anchor Link

Sebagian target pemasangan dimuat oleh harness selain harness yang menulisnya. Registri mencatat setiap jalur semacam itu di SHARED_ROOTS dengan satu pemilik terdaftar (adapter yang didokumentasikan vendor untuk jalur tersebut), para co-installer yang menulis berkas yang sama ke jalur itu, dan para pembaca yang dokumentasi vendornya memuat jalur itu secara bawaan, beserta halaman vendor yang memperlihatkannya dan tanggal halaman tersebut diambil.

Jalur dengan co-installer adalah folder tingkat pengguna di direktori home yang ditulis oleh beberapa pemasangan dengan byte yang sama. Mesin yang hanya memasang Cursor tidak memiliki Codex untuk menulis ~/.agents/skills/, sehingga setiap pemasangan yang menyebut folder itu menulisnya, dan ledger pemasangan menghitung pemasangan yang menggunakannya. Pemilik tercatat adalah pemilik terdaftar selama ia menggunakan folder itu, dan jika tidak, pemasangan tertua yang menggunakannya; tidak ada yang berpindah ketika pemilik terdaftar dicopot. Pencopotan menghapus folder itu hanya ketika tidak ada pemasangan lain yang masih menggunakannya (lihat uninstall). Memasang pembaca tidak menempatkan berkas apa pun di folder itu; memasang pemilik atau co-installer menempatkan konten Apothem di hadapan setiap pembaca.

~/.config/apothem/rules/ dan ~/.config/apothem/templates/ memuat berkas yang dikutip oleh skill dan berkas instruksi milik Apothem sendiri. Tidak ada tool lain yang memuatnya, sehingga keduanya tidak memiliki pembaca dan halaman vendor. CodeBuddy, Kiro, dan Trae juga menulis folder skill milik mereka sendiri (~/.codebuddy/skills/, ~/.kiro/skills/, dan ~/.trae/skills/); hanya tool tersebut yang memuatnya, sehingga folder itu bukan root bersama.

Sebuah pembaca dicantumkan hanya jika dokumentasi vendornya memperlihatkan pemuatan bawaan atas jalur persis tersebut. Satu pembaca membawa syarat, dan catatan pemasangan mengulanginya: Open-Claw mengindeks ~/.agents/skills/ hanya di bawah direktori status bawaannya (ia melewati folder itu ketika OPENCLAW_STATE_DIR menunjuk ke tempat lain). Dokumentasi Cursor mencantumkan ~/.codex/agents/ sebagai folder kompatibilitas Codex tetapi tidak menyebut format berkas mana yang diurai Cursor di sana, dan pemasangan Codex menulis berkas TOML, sehingga apakah Cursor membaca helper tersebut belum terkonfirmasi. Pemasangan Cursor juga menulis salinan helper miliknya sendiri di <project>/.cursor/agents/, yang oleh urutan prioritas vendor ditempatkan di atas folder yang diimpornya, sehingga di proyek yang terpasang salinan native itu menggantikan salinan dari ~/.claude/agents/.

Sebagian tool sengaja tidak menjadi pembaca ~/.agents/skills/: dokumentasi Antigravity, CodeBuddy, Kiro, dan Trae tidak menyatakan bahwa mereka memuatnya secara bawaan (Trae memuat folder proyek .agents/skills/ hanya setelah sebuah pengaturan diaktifkan), itulah sebabnya CodeBuddy, Kiro, dan Trae mendapat folder skill milik mereka sendiri. Dokumentasi Hermes menyebutnya hanya sebagai contoh nilai untuk skills.external_dirs. GitHub Copilot bukan pembaca ~/.claude/agents/: dokumentasi VS Code mencantumkan folder itu untuk agen Anthropic Claude, bukan untuk agen yang dijalankan GitHub Copilot.

Blok Apothem yang ditulis pemilik ke dalam berkas instruksi bersama tidak menyebut satu tool tunggal pun sebagai pembacanya. tests/unit/test_shared_roots.py gagal ketika adapter yang menulis sebuah target registri tidak persis sama dengan pemiliknya dan para co-installer-nya, dan ketika sebuah target registri yang dinamai seperti berkas instruksi lintas tool (AGENTS.md, CLAUDE.md, GEMINI.md, copilot-instructions.md) tidak memiliki pemilik yang dideklarasikan. Satu-satunya pengecualian adalah ~/.codex/AGENTS.md, yang tidak didokumentasikan sebagai dimuat oleh harness terdaftar lain mana pun.

Hook validasiCopy Anchor Link

Registri tetap tersinkronisasi melalui pemeriksaan berikut:

Referensi Adapter Harness yang DihasilkanCopy Anchor Link