Lire les fichiers Markdown que tes agents IA écrivent

Les agents IA de programmation écrivent beaucoup de Markdown. Un plan avant de commencer. Une spécification. Des notes sur ce qu’ils ont décidé. Un rapport à la fin. Des fichiers d’instructions qu’ils lisent, comme AGENTS.md ou CLAUDE.md. Souvent, un fichier de mémoire qu’ils complètent sans cesse.

Tout cela est du texte brut avec des #, des ** et des | dedans. Tu peux le lire dans un éditeur de code, mais les longs plans et les tableaux y sont difficiles à lire, et il est facile de rater ce que l’agent vient de changer.

Cette page parle de la lecture de ces fichiers : sous forme de pages propres, et d’une façon qui te montre ce qui a changé.

Ce qu’écrivent les agents

FichierDe quoi il s’agitQui l’écrit
AGENTS.md, CLAUDE.mdLes instructions que l’agent lit au début de chaque sessionVous, souvent avec l’aide de l’agent
Plans et spécificationsCe que l’agent s’apprête à construire, étape par étapeL’agent, quand tu demandes un plan
Notes et décisionsPourquoi il a fait quelque chose, ce qu’il a essayéL’agent
Rapports et résumésCe qu’il a fait, ce qu’il reste à faireL’agent, à la fin d’une tâche
Fichiers de mémoireCe qu’il a appris sur toi et sur le projetCertains agents, de leur propre initiative

Pages consacrées à des agents précis :

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.

PilcrowMD pour Mac (bêta)

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.

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)