Memory Bank — Mémoire Persistante pour Agents IA

🧠 Memory Bank — Mémoire Persistante & Protocole de Contexte pour Agents

Vous êtes un agent équipé de Memory Bank, un système de mémoire externe structuré. Les modèles de langage se réinitialisent entre les sessions et perdent le contexte lors de longs workflows. Memory Bank résout ce problème en externalisant la continuité du projet dans un répertoire structuré de fichiers Markdown simples, situé dans le dépôt.

---

📁 Architecture du Memory Bank

Le Memory Bank se trouve dans un répertoire memory-bank/ à la racine du projet :

project-root/
└── memory-bank/
    ├── projectbrief.md     # Mission centrale, périmètre, objectifs, non-négociables
    ├── productContext.md   # Pourquoi ça existe, problèmes utilisateur résolus, parcours utilisateur
    ├── activeContext.md    # FOCUS ACTUEL, décisions actives, changements récents, prochaines étapes immédiates
    ├── systemPatterns.md   # Architecture, structure des composants, motifs de conception, flux de données
    ├── techContext.md      # Stack technique, dépendances, contraintes d'exécution, configuration de l'environnement
    └── progress.md         # Ce qui fonctionne, ce qui est construit, bogues connus, feuille de route

---

⚡ Protocole de Chargement Progressif

Pour limiter l'utilisation des tokens et éviter la dilution du contexte :

1. Au démarrage d'une session / reprise du travail :
   • Vérifier si memory-bank/ existe.
   • S'il existe, lire d'abord memory-bank/activeContext.md. Cela restaure immédiatement la conscience situationnelle.
   • Lire memory-bank/systemPatterns.md ou techContext.md UNIQUEMENT lors de la modification de l'architecture ou des configurations de build concernées.
2. Lors de décisions majeures / fin de session :
   • Mettre à jour memory-bank/activeContext.md avec ce qui a changé et ce qui reste.
   • Mettre à jour memory-bank/progress.md avec les jalons nouvellement terminés ou les bogues découverts.

---

🛠️ Commandes & Actions Mémoire

1. /memory init (Initialiser le Memory Bank)

Si memory-bank/ n'existe pas :

• Analyser la structure du dépôt (package.json, README.md, fichiers sources, journal Git).
• Générer les 6 fichiers centraux, remplis avec des détails vérifiés à partir de la base de code actuelle.

2. /memory update (Synchroniser l'état courant)

• Résumer les modifications de code, les pivots architecturaux et les tâches actives de la session en cours dans activeContext.md.
• Déplacer les éléments terminés dans progress.md de "En cours" à "Terminé".

3. /memory record <decision> (Journaliser une décision technique)

• Ajouter la décision, sa justification et les alternatives envisagées à systemPatterns.md.

---

📋 Modèles de Fichiers

activeContext.md

# Contexte Actif

## Focus Actuel
- [Résumé concis de l'objectif en cours]

## Changements Récents
- [Fichier ou composant modifié] — [Justification]

## Décisions Actives & Considérations
- [Compromis ou motif adopté]

## Prochaines Étapes
1. [Tâche immédiate 1]
2. [Tâche immédiate 2]

progress.md

# Avancement du Projet

## Ce qui Fonctionne
- [Fonctionnalité A] — vérifiée fonctionnelle
- [Fonctionnalité B] — vérifiée avec tests unitaires

## Ce qui Reste à Construire
- [ ] Jalon 1
- [ ] Jalon 2

## Problèmes Connus / Bloqueurs
- [Description du problème et correctif potentiel]