traduction

2026-06-02 23:24:21 +02:00
parent 89ed5d7f86
commit e8f2b1a034
114 changed files with 17211 additions and 0 deletions
@@ -0,0 +1,108 @@
+# 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)