Concepts
Glossaire définissant les profils partagés, les adaptateurs d'environnement, les règles, les hooks, les portails de conformité, les skills et les travailleurs délégués dans Apothem.
Une référence rapide des termes que vous rencontrerez tout au long de la documentation d'Apothem.
Profil partagé
Un fichier YAML validé par schéma à ~/.config/apothem/profile.yaml (remplacé
par --profile PATH). C'est la source de vérité unique de votre identité, de vos
préférences et de votre configuration ; chaque adaptateur d'environnement le lit
à l'installation et en dérive la configuration native de cet environnement.
Adaptateur d'environnement
Un adaptateur propre à chaque plateforme qui traduit le profil partagé vers le format de configuration natif d'un environnement spécifique. Les runtimes pris en charge sont listés dans :
Claude Code, Cursor, Gemini CLI, etc.Installer Apothem signifie toujours : installer le profil partagé, puis matérialiser un ou plusieurs adaptateurs.
Règle comportementale
Un fichier Markdown sous src/apothem/rules/ qui est chargé à chaque interaction (toujours actif) ou
seulement lors de l'édition de fichiers sous un chemin spécifique (filtré par chemin). Les règles codifient la manière dont
l'environnement doit se comporter. Quatre règles sont toujours actives : agnostic-posture, authority-inquiry,
session-closure et context-management. L'index des règles, apothem-rule-index, se charge avec
elles et nomme chaque autre règle ainsi que le moment où la lire. Un environnement qui ne filtre pas les règles par
chemin ne charge aucune des autres ; l'index est donc le moyen par lequel une session les trouve.
Hook
Un script Python enregistré dans la configuration de hooks d'un environnement (settings.json pour Claude Code), qui se déclenche sur des événements du cycle de vie tels que PreToolUse, PostToolUse, SessionStart et Stop ; certains adaptateurs enregistrent aussi PreCompact et PostCompact. Les hooks appliquent les mandats de conformité en temps réel, avant que la sortie n'atteigne le disque. Les adaptateurs pour les environnements dépourvus de mécanisme de hook l'omettent.
Portail de conformité
La fraction mécanique du portail de pré-émission à quinze barres (M1-M15) — les validateurs vérifiables par machine
qui s'exécutent avant l'émission d'un artefact ; consultatifs par défaut, bloquants
avec --strict. Le portail de pré-émission est le seuil de qualité ;
le portail de conformité exécute ses barres vérifiables par machine, et les hooks appliquent les barres individuelles en temps réel.
Suite de planification
Un répertoire structuré à <project-root>/.apothem/plans/<suite-name>/ contenant une spécification, un plan maître, des fichiers PHASE.md par phase, et des artefacts de sortie. Le pipeline /plan gère les suites de planification.
Skill
Une technique réutilisable, invocable par commande slash, regroupée dans un fichier SKILL.md sous src/apothem/skills/<name>/. Les skills étendent la surface des commandes slash au-delà du pipeline /plan intégré.
Travailleur délégué
Un assistant persistant, au périmètre dédié, défini au chemin canonique :
src/apothem/agents/<name>.mdLes travailleurs délégués prennent en charge la recherche, l'audit, le contrôle qualité et la gestion de la mémoire.