Claude Code : Frontmatter de mémoire d'agent

Mémoire persistante pour les sous-agents — permettre aux agents d'apprendre, de se souvenir et de construire de la connaissance entre les sessions.

← Retour à Claude Code Best Practice

Vue d'ensemble

Introduit dans Claude Code v2.1.33 (février 2026), le champ de frontmatter memory donne à chaque sous-agent son propre magasin de connaissances persistant basé sur markdown. Avant cela, chaque invocation d'agent repartait de zéro.

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Write, Edit, Bash
model: sonnet
memory: user
---

You are a code reviewer. As you review code, update your agent memory with
patterns, conventions, and recurring issues you discover.

Portées de mémoire

Portée	Emplacement de stockage	Versionné	Partagé	Idéal pour
`user`	`~/.claude/agent-memory/<agent-name>/`	Non	Non	Connaissance inter-projets (défaut recommandé)
`project`	`.claude/agent-memory/<agent-name>/`	Oui	Oui	Connaissance spécifique au projet que l'équipe devrait partager
`local`	`.claude/agent-memory-local/<agent-name>/`	Non (git-ignored)	Non	Connaissance spécifique au projet mais personnelle

Ces portées reflètent la hiérarchie des paramètres (~/.claude/settings.json → .claude/settings.json → .claude/settings.local.json).

Comment ça fonctionne

Au démarrage : les 200 premières lignes de MEMORY.md sont injectées dans le system prompt de l'agent
Accès aux outils : Read, Write, Edit sont auto-activés pour que l'agent puisse gérer sa mémoire
Pendant l'exécution : l'agent lit/écrit librement dans son répertoire de mémoire
Curation : si MEMORY.md dépasse 200 lignes, l'agent déplace les détails dans des fichiers spécifiques à un sujet

~/.claude/agent-memory/code-reviewer/     # exemple de portée user
├── MEMORY.md                              # Fichier principal (200 premières lignes chargées)
├── react-patterns.md                      # Fichier spécifique à un sujet
└── security-checklist.md                  # Fichier spécifique à un sujet

Mémoire d'agent vs autres systèmes de mémoire

Système	Qui écrit	Qui lit	Portée
CLAUDE.md	Toi (manuellement)	Claude principal + tous les agents	Projet
Auto-mémoire	Claude principal (auto)	Claude principal uniquement	Par projet par utilisateur
Commande `/memory`	Toi (via éditeur)	Claude principal uniquement	Par projet par utilisateur
Mémoire d'agent	L'agent lui-même	Cet agent spécifique uniquement	Configurable (user/project/local)

Ces systèmes sont complémentaires — un agent lit à la fois CLAUDE.md (contexte projet) et sa propre mémoire (connaissance propre à l'agent).

Exemple pratique

---
name: api-developer
description: Implement API endpoints following team conventions
tools: Read, Write, Edit, Bash
model: sonnet
memory: project
skills:
  - api-conventions
  - error-handling-patterns
---

Implement API endpoints. Follow the conventions from your preloaded skills.
As you work, save architectural decisions and patterns to your memory.

Cela combine les skills (connaissance statique au démarrage) avec la mémoire (connaissance dynamique construite au fil du temps).

Astuces

Prompter l'usage de la mémoire — Inclure des instructions explicites : "Before starting, review your memory. After completing, update your memory with what you learned."
Demander des vérifications de mémoire en invoquant des agents : "Review this PR, and check your memory for patterns you've seen before."
Choisir la bonne portée — user pour inter-projets, project pour partagé en équipe, local pour personnel

4.4 KiB Raw Permalink Blame History