Ce qu’écrivent les agents
| Fichier | De quoi il s’agit | Qui l’écrit |
|---|---|---|
AGENTS.md, CLAUDE.md | Les instructions que l’agent lit au début de chaque session | Vous, souvent avec l’aide de l’agent |
| Plans et spécifications | Ce que l’agent s’apprête à construire, étape par étape | L’agent, quand tu demandes un plan |
| Notes et décisions | Pourquoi il a fait quelque chose, ce qu’il a essayé | L’agent |
| Rapports et résumés | Ce qu’il a fait, ce qu’il reste à faire | L’agent, à la fin d’une tâche |
| Fichiers de mémoire | Ce qu’il a appris sur toi et sur le projet | Certains agents, de leur propre initiative |
Pages consacrées à des agents précis :
- Codex : AGENTS.md et les fichiers que lit Codex
- Claude Code : CLAUDE.md, règles et fichiers de mémoire
Trois choses qui aident
1. Lis le dossier, pas un seul fichier. Les agents écrivent de nombreux fichiers dans plusieurs dossiers. Ouvre tout le dossier du projet dans un lecteur Markdown, pour pouvoir passer du plan à la spécification puis au rapport.
2. Vois les fichiers nouveaux et modifiés. Pendant qu’un agent travaille, des fichiers apparaissent et changent. Tu veux voir lesquels, sans ouvrir chacun d’eux.
3. Vois ce qui a changé dans un fichier. Quand un agent modifie un plan que tu as déjà lu, tu veux voir seulement ce qui a changé, sans relire tout le plan.
Sur Mac : PilcrowMD (bêta)
PilcrowMD pour Mac (bêta) est un lecteur Markdown gratuit conçu pour cela.
- Ajoute un dossier dans Mes dossiers. Quand un agent y écrit un fichier, il apparaît marqué N (nouveau) ou U (mis à jour). Un fichier ouvert se recharge quand un agent ou une autre application le modifie, et conserve ta position.
- Vois ce qui a changé. Quand un fichier a changé depuis ta dernière lecture, une bannière l’indique. Clique sur Surligner les modifications : le texte ajouté est en bleu, le texte supprimé ou modifié est en orange. Parcours les modifications avec ↑ et ↓. Le filtre Modifiées dans Mes dossiers liste tous les fichiers qui ont changé.
- Compare côte à côte, sous forme de page rendue ou de source.
- Reviens en arrière. Quand l’historique des fichiers est activé, Fichier › Afficher l’historique… liste les versions stockées. Quand tu restaures une version plus ancienne, le fichier actuel est d’abord enregistré dans l’historique. Pour un fichier ouvert, l’historique conserve chaque enregistrement fait par une autre application. Pour un fichier qui n’est pas ouvert, des enregistrements espacés de moins d’environ une seconde peuvent ne pas être tous conservés.
- Si tu modifies pendant que l’agent écrit, PilcrowMD t’avertit et te demande avant d’écraser la modification de l’agent.
- Aucun compte, aucun suivi, aucune connexion Internet. Signé et notarisé par Apple.
Sur ton téléphone : vérifier le travail de l’agent
Les agents ne tournent pas sur un téléphone, mais tu peux lire ce qu’ils ont écrit. Si le dossier de l’agent est synchronisé avec Google Drive, ajoute ce dossier dans Mes dossiers dans PilcrowMD pour Android.
- Mes dossiers s’actualise quand tu reviens à la liste ou tires vers le bas pour actualiser.
- Google Drive peut mettre du temps à transmettre une modification faite sur ton ordinateur. Ouvre le fichier : Drive récupère alors la nouvelle version, et PilcrowMD propose Appuyez pour le recharger.
- Il n’y a ni rechargement en direct ni vérification en arrière-plan, et pas de fonction Comparer sur Android. Ouvre le fichier pour voir la dernière version.
Testé avec Google Drive et le stockage du téléphone. D’autres applications cloud peuvent fonctionner si elles affichent leurs dossiers dans le sélecteur de dossiers d’Android.
Questions fréquentes
Ai-je besoin de PilcrowMD pour lire ces fichiers ? Non. Ce sont des fichiers en texte brut ; n’importe quel éditeur les ouvre. Un lecteur Markdown affiche les tableaux, le code et les titres sous forme de page, ce qui aide pour les longs plans.
PilcrowMD modifiera-t-il les fichiers de mon agent ? Pas tant que tu ne modifies et n’enregistres pas. Sinon, rien n’est écrit, et il te demande avant d’écraser une modification faite par une autre application.
Envoie-t-il mes fichiers quelque part ? Non. L’application Mac n’établit aucune connexion Internet, et l’application Android n’a pas d’autorisation Internet. Sur Android, la synchronisation est assurée par l’application cloud que tu as choisie, comme Google Drive.
Aussi sur Mac : PilcrowMD pour Mac (bêta)