FAQ

Questions courantes, par ordre de fréquence.

Qu'est-ce qu'apothem ?Copy Anchor Link

Apothem est un gestionnaire de configuration indépendant de l'hôte pour les environnements d'assistant de programmation. Vous rédigez un seul profil partagé, et Apothem le matérialise dans la surface de configuration native de chaque outil — en associant règles comportementales, standards créatifs, commandes slash, travailleurs délégués persistants, hooks et compétences en un seul corpus gouverné qui reste cohérent dans tous les environnements.

Avec quels environnements d'assistant fonctionne-t-il ?Copy Anchor Link

Apothem est indépendant de l'environnement. Des adaptateurs par environnement sous src/apothem/harnesses/<harness>/ projettent le profil partagé dans le répertoire de configuration natif de chaque outil. Le registre des environnements utilisé à l'exécution est la source qui fait autorité pour l'ensemble des environnements pris en charge ; les pages d'environnements documentent chacun d'eux. Le registre couvre actuellement les environnements pris en charge suivants :

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai), and Kimi Code

L'adaptateur Claude Code se matérialise dans ~/.claude/ ; son répartiteur de hooks est neutre vis-à-vis de l'hôte : il résout la racine de l'écosystème d'abord depuis $CLAUDE_PROJECT_DIR, puis depuis $LLM_PROJECT_DIR, essaie ensuite des recherches relatives au script et au répertoire de travail, et se rabat enfin sur $HOME/.claude.

Dois-je utiliser le pipeline des suites de planification ?Copy Anchor Link

Non. Le pipeline des suites de planification est un composant de l'écosystème. Les règles comportementales, les standards créatifs, les hooks et la chaîne d'outils de validation sont utiles indépendamment.

Comment personnaliser les règles sans forker le dépôt ?Copy Anchor Link

Ajoutez une chaîne à la liste rules: de ~/.config/apothem/profile.yaml, puis relancez l'installation ou la mise à jour. Les fichiers de règles sous src/apothem/rules/ modifient l'arborescence source packagée, que l'installateur d'archive remplace lorsqu'il est exécuté avec --yes.

Comment désactiver une règle temporairement ?Copy Anchor Link

Renommez le fichier en dehors du motif src/apothem/rules/*.md ou déplacez-le vers un répertoire frère que le chargeur n'analyse pas.

Quelle est la différence entre règles, compétences et travailleurs délégués ?Copy Anchor Link

• Les règles régissent le comportement — obligations toujours actives ou filtrées par chemin que l'assistant suit.
• Les compétences sont des techniques détectables réutilisables — un signal de détection, une procédure et un hook d'application.
• Les travailleurs délégués sont des rôles persistants dotés de leurs propres restrictions d'outils et invites système, déployés via le protocole d'orchestration des travailleurs.

Comment signaler un problème de sécurité ?Copy Anchor Link

Voir SECURITY.md. Les canaux pris en charge sont les GitHub Security Advisories et [email protected].

Comment contribuer ?Copy Anchor Link

Voir Contribuer. En bref : lisez CONTRIBUTING.md, forkez le dépôt, ouvrez une PR avec le modèle de PR canonique renseigné, et assurez-vous que les vérifications CI réussissent — le guide du développeur liste les portails qu'une PR doit franchir.

Où se trouve l'état de l'écosystème ?Copy Anchor Link

• L'état de planification par suite se trouve sous <project>/.apothem/plans/{suite}/.
• La mémoire Apothem se trouve sous .apothem/memory/, à partir de la racine d'installation (pour Claude Code : ~/.claude/.apothem/memory/ ; ~/.apothem/memory/ lorsque workspace.scope vaut user-home ; <project>/.apothem/memory/ pour les installations à portée projet). La mémoire automatique propre à Claude Code se trouve sous la racine de configuration de l'environnement, à projects/{hash}/memory/ (pour Claude Code : ~/.claude/projects/{hash}/memory/).
• La mémoire inter-projets se trouve sous cette même racine de configuration de l'environnement, à .apothem/memory/ (pour Claude Code : ~/.claude/.apothem/memory/).
• Le brouillon par session se trouve sous <project>/.apothem/plans/{suite}/_inputs/.

Puis-je reprendre un travail de longue haleine dans une nouvelle session ou sur une autre machine ?Copy Anchor Link

Oui. Un travail de longue haleine externalise son état complet vers une suite .apothem/plans/ locale au projet — un contrat de reprise plus un protocole de démarrage à froid —, de sorte que le travail ne réside pas à l'intérieur d'un seul historique de conversation. Comme l'état se trouve dans les fichiers de votre projet, une nouvelle session sur n'importe quel compte ou machine pointant vers le même projet reprend le travail sur place. Apothem ne pousse pas lui-même les fichiers entre comptes ; ils circulent de la manière dont les fichiers de votre projet circulent déjà (contrôle de version, une copie de travail partagée, un répertoire synchronisé). Voir Planification reprenable.

Apothem a-t-il besoin de pip ?Copy Anchor Link

Non — pas pour le moteur lui-même. Le moteur est une arborescence source autonome avec des dépendances intégrées — il s'exécute comme python -m apothem depuis n'importe quel dépôt extrait, le cache npx ou l'arborescence du plugin sur un Python système 3.10+, et n'installe aucune partie de son propre code dans site-packages (click et rich sont les seuls prérequis de l'interpréteur). La seule exception facultative : si click ou rich est manquant, l'installeur propose de lancer pip install pour ces deux-là seulement à votre place — avec votre confirmation, ou --yes / APOTHEM_AUTO_INSTALL_DEPS=1. Les propres paquets d'Apothem ne sont jamais installés dans site-packages.

Comment les hooks s'exécutent-ils sans paquet installé ?Copy Anchor Link

apothem install matérialise le répartiteur de hooks et le portail de conformité sous la racine de l'environnement (pour Claude Code : ~/.claude/.apothem/support/hooks/ et ~/.claude/.apothem/support/conformity/), et les entrées de hook rendues invoquent ces scripts par chemin absolu. Les deux sont des scripts autonomes de la bibliothèque standard, donc les hooks fonctionnent sur une machine qui n'a jamais vu pip install.

Comment désinstaller complètement ?Copy Anchor Link

Exécutez apothem uninstall --harness <name> pour chaque environnement installé, supprimez le moteur selon votre canal d'installation, et supprimez ~/.apothem/ (sauvegardes) ainsi que ~/.config/apothem/ (votre profil) si vous voulez zéro résidu. Le guide de désinstallation détaille chaque canal.

Sous quelle licence est l'écosystème ?Copy Anchor Link

MIT — voir LICENSE.