109 lines
4.4 KiB
Markdown
109 lines
4.4 KiB
Markdown
# 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)
|