Zed

Éditeur : Zed Industries Nom d'installation : zed Statut : GA Configuration native : <project>/.rules

InstallationCopy Anchor Link

apothem install --harness zed --project /path/to/project

L'adaptateur écrit un fichier d'instructions Zed de portée projet à partir des règles partagées d'Apothem et de la surface de gouvernance. Zed lit un seul fichier d'instructions de projet : la première correspondance dans cette liste :

.rules
.cursorrules
.windsurfrules
.clinerules
.github/copilot-instructions.md
AGENT.md
AGENTS.md
CLAUDE.md
GEMINI.md

Il n'existe aucun répertoire de règles propre à chaque outil ; toute la surface Apothem atterrit donc dans le fichier plat .rules, en tête de cette liste.

Il écrit aussi les skills d'Apothem, ainsi que les règles et templates qu'ils citent, dans votre répertoire personnel, avant de toucher au projet (voir Fichiers hors du projet).

Fichiers écrits :

• <project>/.rules, le fichier d'instructions.
• ~/.agents/skills/<name>/SKILL.md pour chaque skill et chaque commande Apothem, dans votre répertoire personnel.
• ~/.config/apothem/rules/ et ~/.config/apothem/templates/, dans votre répertoire personnel.

Fichiers hors du projetCopy Anchor Link

L'installation écrit aussi les skills d'Apothem dans votre répertoire personnel, avant de modifier quoi que ce soit dans le projet :

Ces dossiers sont partagés. Ils ne sont pas propres au projet :

• Chaque projet dans lequel vous installez zed, et chaque autre installation Apothem qui nomme ce dossier, utilise la même copie et écrit les mêmes fichiers, de sorte que l'ordre d'installation n'a pas d'importance. Plusieurs autres outils lisent aussi ~/.agents/skills/ ; le registre des environnements les liste.
• --project choisit le fichier d'instructions à écrire et le projet auquel l'installation appartient. Il ne change pas l'emplacement des skills.
• L'installation n'ajoute aucun fichier de skill ni de règle à votre dépôt. Le projet reçoit le fichier d'instructions, plus le dossier de données .apothem/ que crée toute installation de projet.
• Les dossiers du répertoire personnel sont écrits en premier. Si cela échoue, par exemple parce qu'un dossier du chemin est un lien qui sort de votre répertoire personnel (un lien qui reste à l'intérieur est suivi) ou ne peut pas être écrit, l'installation s'arrête avec l'erreur avant que quoi que ce soit ne change dans le projet.
• Un dossier de skill portant le nom d'un skill Apothem qu'Apothem n'a pas écrit est laissé tel quel, et l'installation affiche un avertissement qui le nomme. Renommez-le ou déplacez-le, puis exécutez apothem update. apothem verify échoue tant que ce nom est occupé.
• Les fichiers totalisent quelques mégaoctets.

L'installation affiche une note qui nomme les dossiers qu'elle écrit hors de --project, et --dry-run les liste.

Correspondance entre le profil et la configuration nativeCopy Anchor Link

L'adaptateur lit le profil partagé d'Apothem et rend le fichier .rules du projet à chaque exécution de apothem install ou de apothem update. Le profil partagé est la source de vérité ; tout .rules préexistant (ou toute modification locale au projet apportée au fichier généré) est sauvegardé avant que la synchronisation suivante ne remplace le contenu géré par Apothem.

Notes de compatibilitéCopy Anchor Link

Zed désigne AGENTS.md comme son fichier d'instructions principal et conserve le .rules de projet comme fichier de compatibilité pris en charge (instructions de Zed). Comme Zed ne lit que la première correspondance, un nouveau .rules masque un AGENTS.md, un CLAUDE.md ou tout autre fichier situé plus bas dans la liste dont le projet dépend déjà. L'installation ne modifie jamais ces fichiers. Lorsque .rules ne contient que le bloc Apothem et qu'un fichier de priorité inférieure contient votre texte, l'installation et la mise à jour affichent un avertissement qui nomme le fichier masqué ; copiez les instructions dont vous avez besoin dans .rules, hors du bloc Apothem, pour les conserver dans Zed.

Le fichier d'instructions global ~/.config/zed/AGENTS.md et le bloc de serveurs de contexte MCP (context_servers de .zed/settings.json) sont détenus par l'opérateur ; Apothem ne les écrit pas.

Zed ne charge les skills globaux que depuis ~/.agents/skills/, dans une disposition plate avec un dossier par skill, qui est la disposition qu'écrit l'installation. Zed subordonne les skills locaux au projet à un worktree de confiance, et sa documentation n'associe aucune condition de ce type au dossier global. Un signalement a fait état d'une limite de taille pour le catalogue de skills que Zed envoie au modèle ; Apothem ne l'a pas confirmée, ni si un skill qui désactive l'invocation par le modèle compte dans cette limite. Les noms et descriptions des skills d'Apothem totalisent environ 20 Ko. Apothem n'a pas non plus confirmé comment Zed traite une clé d'en-tête de SKILL.md qu'il ne liste pas.

VérificationCopy Anchor Link

apothem verify --harness zed --project /path/to/project

La commande verify confirme que :

1. La configuration native existe au chemin attendu.
2. Chaque cible gérée existe ; les fichiers gérés ne sont pas vides, et les configurations JSON ou YAML s'analysent correctement. Ajoutez --profile PATH pour vérifier en plus que les fichiers installés correspondent à ce profil.
3. Chaque dossier de skill Apothem est en place avec un SKILL.md, quelle que soit l'installation qui l'a écrit, et aucun dossier de skill portant un nom Apothem n'appartient à quelque chose qu'Apothem n'a pas écrit. Une vérification en échec nomme les dossiers manquants ou étrangers.
4. La routine de vérification propre à l'adaptateur signale un succès.

Mise à jourCopy Anchor Link

apothem update --harness zed --project /path/to/project

Redérive le fichier .rules du projet à partir de l'état actuel du profil partagé.

La mise à jour réécrit aussi tout dossier de skill dont les fichiers diffèrent des fichiers actuels. Si vous avez installé avec une version antérieure qui n'écrivait aucun skill, la mise à jour les ajoute.

DésinstallationCopy Anchor Link

apothem uninstall --harness zed --project /path/to/project

Supprime le bloc géré d'Apothem du fichier de configuration native .rules et conserve votre propre texte. Le fichier n'est supprimé que si rien d'autre n'y subsiste. Avant la modification, une copie horodatée du fichier est enregistrée sous ~/.apothem/backups/ ; aucun fichier de sauvegarde ne reste dans le projet. Le YAML du profil partagé et le moteur Apothem ne sont pas affectés.

La désinstallation supprime aussi les dossiers de skills qu'elle a écrits dans ~/.agents/skills/ ainsi que les règles et templates de ~/.config/apothem/, mais seulement si aucune autre installation Apothem ne les utilise encore. Un autre projet, ou un autre outil qui partage le dossier, peut les utiliser. Dans ce cas, la désinstallation conserve les dossiers, affiche quelle installation les utilise, et la dernière désinstallation les supprime. Les fichiers que vous avez ajoutés à ces dossiers restent, et un dossier laissé vide est supprimé. Chaque dossier est sauvegardé sous ~/.apothem/backups/ avant d'être supprimé.

Portail de conformitéCopy Anchor Link

python -m apothem.conformity.gate --all .

DépannageCopy Anchor Link

Paramètres de configurationCopy Anchor Link

Voir aussiCopy Anchor Link

• Tous les environnements — le catalogue complet des outils pris en charge
• Guide d'installation — installer Apothem dans cet environnement
• Référence de apothem harnesses — lister et inspecter les adaptateurs depuis la CLI