TheElephantCoder/memory-sync

Synchronisation mémoire

Empêche les sessions de démarrer à froid.

Structure

memory/
  MEMORY.md        # organisé, toujours chargé, rester sous 8k
  SOUL.md          # qui est l'agent
  USER.md          # qui vous êtes
  sessions/        # notes brutes par session, nettoyées après ~30j
  decisions/       # ADR courtes
  tiers/
    hot.md         # toujours chargé
    warm.md        # chargé sur mot-clé
    cold/          # lecture explicite uniquement

Cycle de vie

Démarrage : lire MEMORY.md et tiers/hot.md. Éventuellement warm.md si la tâche correspond. Ne pas lire sessions/ sauf si vous fouillez dans l'historique. Doit prendre moins de 15s au total.

Fin : exécuter harness memory sync ou laisser le crochet de sortie le faire. Cela distille le journal de session dans MEMORY.md, nettoie les vieux éléments et ajoute une ADR si une vraie décision a été prise.

Conseils

• MEMORY.md est organisé, pas simplement en ajout. Gardez-le sous 8k tokens, éditez de manière chirurgicale.
• Si vous avez envisagé 2+ approches et en avez choisi une, rédigez une courte decisions/ADR-###.md.
• Pas de secrets dans la mémoire, elle est de toute façon caviardée.

Commandes :

harness memory show
harness memory edit
harness memory prune --dry-run
harness memory sync --auto