Votre agent de code écrit le plan.Relisez-le avant qu’il n’écrive le code.

Relisez le plan avant le code

Une hypothèse fausse dans un plan coûte un commentaire. La même dans le code coûte un diff à lire, un revert et une nouvelle exécution. Lisez donc le plan d’abord, tant que le changer ne coûte presque rien.

Dans un terminal, le plan est un long bloc de texte que l’on fait défiler. Dans DotMD, c’est un document mis en forme, et chaque remarque est rattachée au passage concerné :

1. Demandez le plan sous forme de fichier

   « Écris le plan dans docs/plan.md et envoie-le-moi dans DotMD pour relecture. »

2. Commentez là où il se trompe

   Sélectionnez un passage, appuyez sur ⌥⌘M et écrivez le changement voulu. Faites-le sur tout le plan, puis cliquez sur Send.

3. Vérifiez les corrections en diff

   L’agent modifie le fichier ; l’ancien texte est en rouge et le nouveau en vert, à côté du commentaire auquel répond chaque correction. Accept, Reopen ou Accept All.

4. Approuvez, puis laissez-le construire

   Cliquez sur Approve et l’agent poursuit avec le code.

L’agent voit chaque commentaire avec son passage, ses lignes et son auteur : il sait donc exactement ce que vous voulez dire. Il peut aussi lire le passage que vous avez sélectionné : « Réécris le paragraphe que j’ai sélectionné dans DotMD. »

Demandez-lui de « me montrer les modifications dans DotMD » quand il a terminé, et il ouvre la relecture pour vous.

Les documents que les agents écrivent

Les plans ne sont qu’un début. Les agents écrivent aussi d’autres documents, que vous pouvez relire de la même façon :

• Specs et documents de conception.
• Architecture decision records (ADR).
• READMEs et entrées de CHANGELOG.
• Plans de migration, de déploiement et de test.
• Tableaux comparatifs de bibliothèques et de services.

Un second agent peut aussi relire le travail du premier : Claude Code écrit, Codex laisse des commentaires, vous décidez. Voir Un agent relit un autre.

S’adapte à votre environnement

DotMD fait tourner un petit serveur MCP sur votre Mac, et votre agent s’y connecte en une ligne. Claude Code, Codex, Cursor et Visual Studio Code fonctionnent tous ; chaque guide donne la configuration exacte.

• Des fichiers, pas une copie. DotMD lit et écrit les fichiers Markdown du dossier de votre projet. Il n’y a rien à importer ni à synchroniser.
• git. Quand git, un éditeur ou un agent modifie un fichier, DotMD le remarque et garde le texte précédent comme version. Les commentaires suivent un fichier renommé avec git mv la première fois que vous l’ouvrez à son nouvel emplacement.
• Docker. Un agent dans un conteneur joint DotMD à l’adresse http://host.docker.internal:8089/mcp.

Prenez l’habitude : quelques lignes dans AGENTS.md

Un agent envoie un document pour relecture quand vous le lui demandez. Pour qu’il le fasse à chaque fois et cherche vos commentaires dans DotMD, ajoutez ces lignes à AGENTS.md pour Codex ou à CLAUDE.md pour Claude Code :

Comments and reviews on Markdown files are kept in DotMD (MCP server `dotmd`), not in the files.
When I mention comments, a review or remarks on a .md file, read them with get_review_comments,
fix each one and send it back with resolve_review_comments.
After writing or substantially changing a spec, plan or design doc for me, send it to me with
request_review and wait for my answer; call it again after fixing my comments, until I approve.

La première ligne compte le plus. Vos commentaires sont conservés par DotMD, pas dans le fichier : un agent qui ne pense pas à DotMD les cherche dans le projet et ne trouve rien.

Vos fichiers restent à vous

• Il n’y a pas de comptes. Vos fichiers, commentaires et historique de versions restent sur votre Mac.
• Le serveur MCP ne répond que sur 127.0.0.1 : les autres ordinateurs ne peuvent pas l’atteindre, et les pages web ne peuvent pas l’utiliser.
• Les commentaires et l’historique sont conservés par DotMD, pas dans vos fichiers. Le Markdown de votre dépôt ne contient ni marqueurs ni commentaires HTML.

Questions de développeurs

Plus de questions