APC doit rester clone-safe, APX doit rester local à la machine
Décidez où les données doivent être placées en posant une seule question.
Ces données survivraient-elles à un nouveau clonage sur une autre machine ?
Si oui, placez-les dans APC. Si non, placez-les dans APX.
Cette règle garantit l'intégrité de votre stack. APC reste portable. APX reste utile sur la machine qui exécute le travail. Lorsque ces couches se confondent, les projets deviennent difficiles à partager et à auditer.
APC est le contrat du projet. APX est le runtime.
Les données APC sont clone-safe. Un autre développeur ou une autre machine doit pouvoir les lire immédiatement après un git checkout. Elles doivent être révisables dans git.
Exemples de bonnes pratiques APC : • AGENTS.md pour les contrats du dépôt • .apc/project.json pour l'identité du projet • .apc/agents/ pour les rôles des agents • .apc/skills/ pour les compétences réutilisables • .apc/mcps.json pour les indices partagés
Les données APX sont locales à la machine. Ces données restent sur la machine ou y sont reconstruites. Il s'agit de l'état d'exécution, pas d'un contexte portable.
Exemples de bonnes pratiques APX : • Configuration du runtime dans ~/.apx/config.json • Modes de permission locaux • Sessions et journaux de messages • Caches locaux • Secrets spécifiques à la machine
Un dépôt ne doit pas imposer la configuration locale d'une personne à tous les autres.
Lorsque APC reste clone-safe, vous pouvez examiner la structure du projet sans fichiers cachés. Vous pouvez comparer les instructions au lieu de traquer des effets de bord.
Lorsque APX reste local à la machine, le runtime s'adapte sans modifier le projet. Une machine utilise un mode de permission différent, tandis qu'une autre conserve un historique plus long. Le contrat du projet reste le même.
Avant d'ajouter un nouveau fichier, posez-vous ces trois questions :
- Chaque outil compatible a-t-il besoin de lire ceci ? Placez-le dans APC.
- Décrit-il le projet plutôt que la machine ? Placez-le dans APC.
- Dépend-il d'identifiants locaux ou d'une exécution récente ? Placez-le dans APX.
Exemples : • Un nouveau rôle d'agent ? APC. • Un jeton de bot Telegram ? APX. • Une note sur les règles de révision du projet ? APC. • Un journal de la dernière conversation ? APX.
APC contient ce qui survit à un clonage. APX contient ce qui n'importe que sur la machine actuelle. Cette règle simple permet de maintenir la cohérence du système.
Source : https://dev.to/agentprojectcontext/apc-should-stay-clone-safe-apx-should-stay-machine-local-59n9
Communauté d'apprentissage optionnelle : https://t.me/GyaanSetuAi