Arquitectura
Visión general de la arquitectura de Apothem: el perfil compartido, la abstracción del adaptador de harness y cómo se organiza el árbol de fuentes.
Apothem se construye en torno a una sola idea: un perfil de gobernanza compartido, materializado en el formato de configuración nativo de cada entorno de ejecución de asistente mediante un adaptador por harness. Esta sección explica las piezas estructurales: el protocolo del adaptador, el esquema del perfil, la disposición del árbol de fuentes y el flujo de instalación que los conecta.
Visión general del sistema
De un vistazo, Apothem es una sola tubería: un único perfil compartido alimenta el registro de harness, que resuelve cada adaptador por harness; cada adaptador materializa la superficie de configuración nativa de su harness, y una verificación de conformidad permanente comprueba cada superficie materializada.
%% 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| NPáginas
| Página | Descripción |
|---|---|
| Abstracción del adaptador de harness | El protocolo HarnessAdapter: cómo los adaptadores traducen el perfil compartido a configuración nativa de la plataforma. |
| Esquema del perfil compartido | El perfil YAML respaldado por esquema en ~/.config/apothem/profile.yaml o --profile PATH. |
| Disposición de fuentes | Por qué Apothem usa una disposición src/ y cómo se organiza el árbol. |
| Flujo de instalación | Cómo funcionan apothem install, update y uninstall de principio a fin. |
| Trabajadores delegados | Instrucciones con alcance de repositorio para entornos de ejecución multi-trabajador que operan en este repositorio. |