Arsitektur
Arsitektur
Ikhtisar arsitektur Apothem — profil bersama, abstraksi adapter harness, dan cara pohon sumber diatur.
Apothem dibangun di sekitar satu gagasan: satu profil tata kelola bersama, dimaterialisasi ke dalam format konfigurasi native setiap harness oleh adapter per harness. Bagian ini menjelaskan bagian-bagian struktural — protokol adapter, skema profil, tata letak pohon sumber, dan alur pemasangan yang menghubungkannya.
Ikhtisar sistem
Sekilas, Apothem adalah satu alur: satu profil bersama memberi masukan ke registry harness, yang menyelesaikan setiap adapter per harness; tiap adapter mewujudkan permukaan konfigurasi native harness-nya, dan gerbang konformitas yang selalu aktif memeriksa setiap permukaan yang diwujudkan.
%% provenance: hand-authored %%
%% verified: 2026-06-23 %%
%% cross-reference: src/apothem/lib/harness_registry.py (runtime registry) + src/apothem/harnesses/ (adapter sub-packages) + src/apothem/conformity/ (conformity gate) %%
flowchart TD
accTitle: Apothem end-to-end materialization flow
accDescr: One shared profile feeds the harness registry, which resolves seventeen per-harness adapters; each adapter runs its install, uninstall, update, and verify lifecycle, with four single-file-config adapters also rendering a native config file through a materializer, and writes the harness's own native configuration surface. A standing conformity gate checks every materialized surface.
P["Shared profile<br/>~/.config/apothem/profile.yaml<br/>rules, skills, hooks, slash-commands, MCP servers"]
R["Harness registry<br/>authoritative at runtime<br/>(resolves every adapter)"]
A["17 per-harness adapters<br/>each: install / uninstall / update / verify<br/>+ materializer on 4 single-file-config adapters"]
N["Each harness's native config surface<br/>Claude Code settings.json, Cursor .mdc,<br/>Gemini GEMINI.md, Copilot instructions.md, …"]
G["Conformity gate<br/>pre-emission validators"]
P --> R
R --> A
A --> N
G -.->|standing check over every materialized surface| NHalaman
| Halaman | Deskripsi |
|---|---|
| Abstraksi adapter harness | Protokol HarnessAdapter — bagaimana adapter menerjemahkan profil bersama menjadi konfigurasi native platform. |
| Skema profil bersama | Profil YAML yang didukung skema di ~/.config/apothem/profile.yaml atau --profile PATH. |
| Tata letak sumber | Mengapa Apothem memakai tata letak src/ dan bagaimana pohon diatur. |
| Alur pemasangan | Bagaimana apothem install, update, dan uninstall bekerja dari ujung ke ujung. |
| Pekerja terdelegasi | Instruksi bercakupan repositori untuk runtime multi-pekerja yang beroperasi di repositori ini. |