# 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.

<table width="100%">
<tr>
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
</tr>
</table>

---

## 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.

```yaml
---
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

1. **Au démarrage** : les 200 premières lignes de `MEMORY.md` sont injectées dans le system prompt de l'agent
2. **Accès aux outils** : `Read`, `Write`, `Edit` sont auto-activés pour que l'agent puisse gérer sa mémoire
3. **Pendant l'exécution** : l'agent lit/écrit librement dans son répertoire de mémoire
4. **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

```yaml
---
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

---

## Sources

- [Créer des sous-agents personnalisés — Documentation Claude Code](https://code.claude.com/docs/en/sub-agents)
- [Gérer la mémoire de Claude — Documentation Claude Code](https://code.claude.com/docs/en/memory)
- [Notes de version Claude Code v2.1.33](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)