Utiliser des fichiers Markdown comme système de mémoire pour les agents d'IA de codage

Méthode principale : Converser dans des fichiers au lieu de la fenêtre de chat

Le développeur utilise Claude Code mais évite l'interface de chat standard. Au lieu de cela, il demande à l'agent de créer un fichier {topic}_LOG.md où toutes les discussions importantes sont menées et conservées. Dans la fenêtre de chat, il écrit seulement /response pour dire à Claude de consulter le fichier de discussion actuel et d'y répondre, réservant le chat pour des questions triviales annexes qui n'ont pas besoin d'être conservées.

Structure des fichiers et annotation

Les réponses sont généralement ajoutées en bas du fichier LOG comme dans un chat normal, mais des commentaires peuvent également être insérés en ligne pour répondre à des points spécifiques. Cela est particulièrement utile pour les clarifications parallèles lors de la planification de projet. Pour maintenir la clarté lors de la relecture, tous les commentaires humains sont marqués avec C: pour les distinguer des contributions de Claude.

Architecture du système de mémoire double

En plus du fichier LOG, Claude est chargé de créer et de maintenir un fichier {topic}_SUMMARY.md. Ce résumé contient des références au LOG original avec des numéros de ligne, car le LOG devient souvent trop volumineux pour tenir en mémoire. Le résumé agit comme une mémoire déclarative de haut niveau, tandis que le LOG sert de mémoire procédurale détaillée.

Démarrage de l'agent et gestion de la mémoire

Lorsqu'un nouvel agent démarre ou après un compactage, le processus est :

• L'utilisateur fournit le contexte : "Votre tâche est de poursuivre la conversation {topic}. Nous nous concentrerons sur X."
• L'agent lit {topic}_SUMMARY.md pour comprendre ce qui est important
• Le résumé indique où X a été discuté (par exemple, lignes 100-200 et 500-800 du LOG)
• L'agent charge ces lignes spécifiques du LOG ainsi que les cent dernières lignes pour le contexte récent
• L'agent peut décider de manière autonome quand consulter les détails mentionnés dans le résumé

Maintenance et contrôle qualité

De simples sous-agents scannent périodiquement les résumés pour assurer une synchronisation correcte avec leurs journaux correspondants. Les résumés de différents sujets contiennent des références croisées le cas échéant, donnant à tout agent travailleur l'infrastructure nécessaire pour consulter des détails supplémentaires. Les agents signalent également tous les commentaires C: qui n'ont jamais été traités, évitant ainsi les questions manquées.

Secours et avantages documentaires

Pour une fiabilité maximale quel que soit le coût en tokens, un nouvel agent peut être chargé de relire l'intégralité du fichier LOG, ce qui nécessite moins de mémoire que la discussion originale puisqu'il exclut d'autres opérations comme la lecture de fichiers Python ou la navigation web. En prime, les fichiers LOG servent de documentation approfondie pour d'autres personnes travaillant sur le même projet.