Arquitetura
Visão geral da arquitetura do Apothem — o perfil compartilhado, a abstração do adaptador de harness e como a árvore de fontes é organizada.
O Apothem é construído em torno de uma única ideia: um perfil de governança compartilhado, materializado no formato de configuração nativo de cada ambiente de execução de assistente por um adaptador por harness. Esta seção explica as peças estruturais — o protocolo do adaptador, o esquema do perfil, a disposição da árvore de fontes e o fluxo de instalação que os conecta.
Visão geral do sistema
Em um relance, o Apothem é um único pipeline: um único perfil compartilhado alimenta o registro de harness, que resolve cada adaptador por harness; cada adaptador materializa a superfície de configuração nativa do seu harness, e uma verificação de conformidade permanente confere cada superfície 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 | Descrição |
|---|---|
| Abstração do adaptador de harness | O protocolo HarnessAdapter — como os adaptadores traduzem o perfil compartilhado para a configuração nativa da plataforma. |
| Esquema do perfil compartilhado | O perfil YAML respaldado por esquema em ~/.config/apothem/profile.yaml ou --profile PATH. |
| Disposição das fontes | Por que o Apothem usa uma disposição src/ e como a árvore é organizada. |
| Fluxo de instalação | Como apothem install, update e uninstall funcionam de ponta a ponta. |
| Trabalhadores delegados | Instruções com escopo de repositório para ambientes de execução multi-trabalhador que operam neste repositório. |