Lire les fichiers Markdown de Codex sur Mac

Codex travaille sur votre code et laisse souvent des traces en Markdown : un plan avant de coder, une spec, des notes de décision, un fichier de suivi dans le dossier du projet. Ces .md se lisent mal dans un terminal ou un aperçu brut. Marko les ouvre mis en forme sur votre Mac, pour que vous relisiez et corrigiez ce que l’agent a écrit.

Où Codex pose ses fichiers

Codex range ses .md parmi les fichiers de votre projet, là où vos consignes le demandent : un plan, une spec, un fichier de suivi. Ce sont des fichiers Markdown ordinaires. Vous les ouvrez comme n’importe quel .md, avec Fichier > Ouvrir, puis vous passez en mode Visuel pour lire le plan comme un document.

Marko n’a pas d’intégration avec Codex : pas de connexion à l’agent, pas de lecture du dépôt, pas de lien avec Git. Vous travaillez sur le fichier tel qu’il est sur le disque. Quand Codex réécrit le fichier, rouvrez-le dans Marko pour voir la version à jour.

Ce qu’il faut vérifier dans un plan

Un plan d’agent engage le travail qui suit. Avant de laisser Codex coder, relisez-le avec quelques questions en tête :

1. Le périmètre correspond-il à ce que vous avez demandé, sans dérive ni raccourci ?
2. La liste des fichiers touchés est-elle complète, et aucun fichier sensible n’y figure par erreur ?
3. Les tests ou les contrôles prévus couvrent-ils le changement ?
4. Les hypothèses de l’agent tiennent-elles, ou l’une d’elles est-elle fausse ?

En mode Visuel, cette structure devient lisible : vous suivez le raisonnement, vous repérez une étape manquante, vous vérifiez qu’un tableau de fichiers correspond à votre attente. Corrigez sur place. Reformulez une étape floue ou ajoutez une contrainte oubliée ; le fichier reste du Markdown que Codex rouvrira sans surprise.

Si vous corrigez le plan au moment où Codex le réécrit, Marko repère le conflit à l’enregistrement : votre version n’est pas écrasée, et l’autre est gardée en copie à côté. Pour que l’agent lise vos corrections au passage suivant, placez-les dans le plan sous un intitulé net, « Décisions » ou « Hors périmètre » par exemple, plutôt que dans une remarque qu’il pourrait survoler.

Ce qui est conservé à l’identique

Valider et partager le plan

Une fois le plan relu, vous voulez parfois le faire valider avant que l’agent se lance, par un collègue qui n’ouvrira pas le dépôt. Choisissez Fichier > Exporter en PDF… ; le document sort paginé au format A4, prêt à être lu et annoté. Le .md reste dans le projet comme référence de travail. La production du PDF se fait sur votre Mac, sans rien envoyer.