Architektur

Architekturüberblick zu Apothem — das gemeinsame Profil, die Harness-Adapter-Abstraktion und die Organisation des Quellbaums.

Apothem ist um eine einzige Idee herum aufgebaut: ein gemeinsames Governance-Profil, das von einem Adapter pro Harness in das native Konfigurationsformat jeder Harness-Laufzeit materialisiert wird. Dieser Abschnitt erläutert die strukturellen Bestandteile — das Adapter-Protokoll, das Profilschema, das Layout des Quellbaums und den Installations-Workflow, der sie verbindet.

Systemüberblick

Auf einen Blick ist Apothem eine einzige Pipeline: ein einziges gemeinsames Profil speist die Harness-Registry, die jeden Adapter pro Harness auflöst; jeder Adapter materialisiert die native Konfigurationsoberfläche seines Harness, und eine ständige Konformitätsprüfung prüft jede materialisierte Oberfläche.

%% 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| N

Seiten

Seite	Beschreibung
Harness-Adapter-Abstraktion	Das `HarnessAdapter`-Protokoll — wie Adapter das gemeinsame Profil in plattformnative Konfiguration übersetzen.
Schema des gemeinsamen Profils	Das schemagestützte YAML-Profil unter `~/.config/apothem/profile.yaml` oder `--profile PATH`.
Quell-Layout	Warum Apothem ein `src/`-Layout verwendet und wie der Baum organisiert ist.
Installations-Workflow	Wie `apothem install`, `update` und `uninstall` durchgängig funktionieren.
Delegierte Arbeiter	Repository-bezogene Anweisungen für Multi-Worker-Laufzeiten, die in diesem Repository arbeiten.

Architektur

Systemüberblick

Seiten

On this page