Konzepte
Glossar mit Definitionen für gemeinsame Profile, Harness-Adapter, Regeln, Hooks, Konformitäts-Gates, Skills und delegierte Worker in Apothem.
Eine Kurzreferenz für die Begriffe, denen Sie in der gesamten Apothem-Dokumentation begegnen.
Gemeinsames Profil
Eine schema-validierte YAML-Datei unter ~/.config/apothem/profile.yaml (mit --profile PATH überschreibbar).
Sie ist die einzige Quelle der Wahrheit für Ihre Identität, Präferenzen und Konfiguration; jeder
Harness-Adapter liest sie bei der Installation und leitet daraus die native Konfiguration dieses Harness ab.
Harness-Adapter
Ein plattformspezifischer Adapter, der das gemeinsame Profil in das native Konfigurationsformat eines bestimmten Harness übersetzt. Die unterstützten Laufzeiten sind aufgeführt in:
Claude Code, Cursor, Gemini CLI, etc.Apothem zu installieren bedeutet immer: das gemeinsame Profil installieren und anschließend einen oder mehrere Adapter materialisieren.
Verhaltensregel
Eine Markdown-Datei unter src/apothem/rules/, die bei jeder Interaktion geladen wird (always-on) oder
nur beim Bearbeiten von Dateien unter einem bestimmten Pfad (pfadgefiltert). Regeln kodifizieren, wie sich der
Harness verhalten soll. Vier Regeln sind always-on: agnostic-posture, authority-inquiry,
session-closure und context-management. Der Regelindex, apothem-rule-index, wird mit
ihnen geladen und nennt jede andere Regel und wann sie zu lesen ist. Ein Harness, der Regeln nicht
nach Pfad eingrenzt, lädt keine der übrigen, daher findet eine Sitzung sie über den Index.
Hook
Ein Python-Skript, das in der Hook-Konfiguration eines Harness (settings.json für Claude Code) registriert ist und bei Lebenszyklus-Ereignissen wie PreToolUse, PostToolUse, SessionStart und Stop ausgelöst wird; einige Adapter registrieren außerdem PreCompact und PostCompact. Hooks erzwingen Konformitäts-Mandate in Echtzeit, bevor die Ausgabe die Festplatte erreicht. Adapter für Harnesses ohne Hook-Mechanismus lassen ihn weg.
Konformitäts-Gate
Der mechanische Anteil des fünfzehnstufigen Pre-Emission-Gates (M1-M15) — die maschinell prüfbaren
Validatoren, die vor der Ausgabe eines Artefakts laufen; standardmäßig beratend, blockierend
unter --strict. Das Pre-Emission-Gate ist die Qualitätsuntergrenze; das
Konformitäts-Gate führt seine maschinell prüfbaren Stufen aus, und Hooks erzwingen einzelne Stufen in Echtzeit.
Plan-Suite
Ein strukturiertes Verzeichnis unter <project-root>/.apothem/plans/<suite-name>/, das eine Spezifikation, einen Masterplan, phasenbezogene PHASE.md-Dateien und Ausgabeartefakte enthält. Die /plan-Pipeline verwaltet Plan-Suiten.
Skill
Eine wiederverwendbare, per Slash-Befehl aufrufbare Technik, gebündelt als SKILL.md-Datei unter src/apothem/skills/<name>/. Skills erweitern die Slash-Befehl-Oberfläche über die integrierte /plan-Pipeline hinaus.
Delegierter Worker
Ein persistenter, zweckgebundener Assistent, definiert am kanonischen Pfad:
src/apothem/agents/<name>.mdDelegierte Worker übernehmen Recherche, Auditing, Qualitätsprüfung und Speicherverwaltung.