CLAUDE.md et AGENTS.mdlus, édités et révisés sur votre Mac.
Ces fichiers disent à Claude Code et à Codex comment travailler dans votre projet. DotMD les affiche comme des pages, garde chaque version et peut ajouter les lignes qui font envoyer à votre agent ses spécifications pour relecture.
macOS 14 ou ultérieur. La lecture est gratuite ; l’édition et les relectures se paient en une fois.
Réponse rapide
CLAUDE.md et AGENTS.md sont de simples fichiers Markdown : DotMD les ouvre comme n’importe quel .md, mis en forme, avec un plan et chaque version conservée. Dans Settings → MCP → Agent rules, Add to Claude Code ou Add to Codex place les règles de revue de DotMD dans ~/.claude/CLAUDE.md ou ~/.codex/AGENTS.md, pour que l’agent vous envoie chaque spécification et attende vos commentaires.
Ouvrir et éditer CLAUDE.md et AGENTS.md
Appuyez sur ⌘O et choisissez le dossier du projet : ses CLAUDE.md et AGENTS.md apparaissent dans la barre latérale avec le reste de son Markdown et s’ouvrent comme des pages avec un plan. La barre latérale ignore les dossiers cachés ; pour ~/.claude/CLAUDE.md, appuyez donc sur ⌘O, puis sur ⇧⌘G dans le panneau et saisissez le chemin.
Pour modifier un fichier, appuyez sur ⌘E. La page devient un texte mis en forme à mesure que vous tapez, et chaque modification est enregistrée aussitôt dans le fichier. L’édition fait partie de DotMD Editor.
Quand l’agent modifie le fichier
Quand Claude Code, Codex ou git modifie un fichier de votre espace de travail, la page ouverte se recharge d’elle-même et un bandeau indique Changed on disk avec les lignes ajoutées et supprimées. Show Changes ouvre l’historique des versions ; avec DotMD Reviewer, l’ancien texte est en rouge et le nouveau en vert.
Si le fichier change pendant que vous y écrivez, DotMD demande Load from Disk ou Keep My Version, et enregistre votre texte dans l’historique dans les deux cas.
Pour vérifier les corrections d’un agent une à une, voyez réviser les changements d’un agent.
Ajouter les règles de revue de DotMD en un clic
Les modèles accordent plus de poids à vos propres CLAUDE.md et AGENTS.md qu’à ce qu’un outil dit de lui-même ; DotMD peut donc y placer les lignes qui font utiliser la revue à un agent. Ouvrez Settings → MCP, dépliez Agent rules et appuyez sur Add to Claude Code ou Add to Codex. Les règles vont dans ~/.claude/CLAUDE.md ou ~/.codex/AGENTS.md :
<!-- dotmd:begin (added by DotMD; DotMD can update or remove this block) -->
## DotMD
- When you create or substantially change a spec, plan, design doc or any Markdown document for the user, your LAST step is to call the DotMD MCP tool `request_review` with the file's path and wait for the answer. While it says the user is still reviewing, call it again. Never end your turn by just saying the file is ready.
- Fix each review comment, call `resolve_review_comments`, then `request_review` again until the user approves.
- When you review a file for the user, leave your remarks with `add_review_comments` and finish with `complete_review`.
<!-- dotmd:end -->
DotMD ne modifie que la partie située entre ses deux lignes de repère et garde une copie du fichier d’avant sa première modification, se terminant par .dotmd-backup. Update remplace le bloc quand un DotMD plus récent a de meilleures règles, et Remove le retire.
Pour le fichier propre à un projet, ou pour Cursor et d’autres agents, appuyez sur Copy au même endroit et collez les lignes là où l’agent lit ses règles. Les guides Claude Code et Codex montrent une version plus courte que vous pouvez aussi utiliser.
Ce que l’agent en fait
Avec ces règles, l’agent vous envoie chaque spécification, plan ou document de conception qu’il écrit (request_review), attend pendant que vous commentez, corrige chaque commentaire et le renvoie jusqu’à votre approbation. Les revues avec des agents via MCP font partie de DotMD Reviewer.
Questions sur CLAUDE.md et AGENTS.md
Que sont CLAUDE.md et AGENTS.md ?
Des fichiers Markdown d’instructions pour un agent de programmation. Claude Code lit CLAUDE.md et Codex lit AGENTS.md, dans votre projet ou, pour tous les projets, dans ~/.claude et ~/.codex.
DotMD modifie-t-il mon CLAUDE.md de lui-même ?
Non. DotMD n’écrit dans le fichier que lorsque vous appuyez sur Add ou Update dans Settings → MCP → Agent rules, et seulement entre ses deux lignes de repère. Il en garde d’abord une copie nommée .dotmd-backup.
Puis-je éditer CLAUDE.md dans DotMD pendant que l’agent travaille ?
Oui. Quand un agent modifie le fichier, la page se recharge. Si vous étiez en train d’écrire, DotMD demande s’il faut charger le fichier depuis le disque ou garder votre version.
Faut-il DotMD Reviewer pour éditer ces fichiers ?
Non. Les ouvrir est gratuit et l’édition fait partie de DotMD Editor ($14.99 une fois). Les revues avec des agents via MCP, que les règles demandent à l’agent d’utiliser, font partie de DotMD Reviewer ($39.99 une fois).