Aller au texte
DAVELI, accueil du site L’Équipe invisible

Partie 2. Semaine 2 : bien briefer

Chapitre 5. La mémoire de projet

Recopier le même brief à chaque session est fastidieux, et l’on finit par en oublier une partie. Trois mécanismes conservent des informations d’une session à l’autre : le fichier d’instructions, la mémoire automatique et la base documentaire.

Le fichier d’instructions

Claude Code lit au début de chaque session un fichier nommé CLAUDE.md, que vous rédigez vous-même1. On y met ce qui reste vrai d’une session à l’autre : la description de l’entreprise, l’emplacement des fichiers, les conventions (taux de TVA, durée de validité des devis), les règles de conduite.

La documentation donne quelques repères :

Le fichier peut exister à plusieurs niveaux : pour toute l’organisation, pour un utilisateur, pour un projet, ou pour un usage personnel dans un projet partagé (CLAUDE.local.md, qu’on ne partage pas).

Claude lit ce fichier comme des informations de contexte. Il en tient compte, sans être contraint de le respecter à la lettre. Pour une règle qui doit s’appliquer à coup sûr (ne jamais envoyer de courriel, par exemple), il faut un mécanisme de blocage (→ chapitre 9).

AGENTS.md : un fichier pour tous les agents

OpenAI a lancé en août 2025 un format équivalent, AGENTS.md. Depuis décembre 2025, il est géré par l’Agentic AI Foundation de la Linux Foundation. Plus de 60 000 projets l’utilisent, et la plupart des agents le lisent : Codex, Cursor, GitHub Copilot, goose, OpenCode, Aider, Zed2. Mistral Vibe le lit également.

Claude Code lit AGENTS.md lorsqu’il ne trouve pas de CLAUDE.md, et un CLAUDE.md peut l’importer avec une simple ligne, @AGENTS.md3. Écrivez donc vos instructions une fois, dans AGENTS.md : elles serviront aussi bien à Claude Code qu’aux agents locaux. Si vous changez d’outil, vous gardez le fichier.

Le mot juste. Markdown. Une façon de mettre en forme un simple fichier texte avec quelques signes : un dièse devant un titre, un tiret devant un élément de liste. Les fichiers AGENTS.md, CLAUDE.md et SKILL.md sont écrits ainsi ; n’importe quel éditeur de texte les ouvre.

Voici le début du fichier de la menuiserie Arnal. L’annexe G en donne une version complète et commentée.

# Menuiserie Arnal : instructions pour les agents

## L'entreprise
- Menuiserie de trois personnes, clientèle de particuliers et de professionnels.
- Paul rédige les devis ; Inès gère les relances et les courriels.

## Fichiers
- Tarifs : tarifs/tarifs-2026.csv (prix HT, unité, délai).
- Devis passés : devis/archives/
- Factures exportées : factures/export.csv

## Règles
- Tous les prix sont HT. Le tableur applique la TVA, jamais toi.
- Un devis est valable trois mois.
- N'envoie aucun courriel : enregistre un brouillon dans a-valider/.
- Si une information manque, pose la question au lieu de la supposer.

La mémoire automatique

Claude Code tient aussi des notes de lui-même : vos préférences, les corrections que vous lui avez faites, les décisions prises en cours de projet. Ces notes restent sur votre ordinateur, dans un dossier propre au projet. Les 200 premières lignes de leur index sont relues à chaque session. La commande /memory permet de les consulter et de les modifier4.

L’application Claude dispose d’une mémoire comparable, activée par défaut sur les formules Free, Pro et Max. Vous la consultez et la corrigez dans les paramètres ; chaque projet a la sienne ; les conversations en mode incognito n’y laissent pas de trace5.

La mémoire automatique fait gagner du temps, mais elle peut retenir une information fausse ou dépassée. Relisez-la de temps en temps, comme vous relisez votre fichier d’instructions.

La base documentaire

Les tarifs, les conditions générales, les fiches techniques des produits : ces documents sont trop longs pour un fichier d’instructions, et l’agent n’en a besoin que de temps en temps.

Le mot juste. RAG (génération augmentée par recherche). Une technique qui consiste à chercher, dans un ensemble de documents, les passages utiles à la question posée, puis à les placer dans la fenêtre de contexte avant que le modèle réponde. Elle permet d’interroger des centaines de documents sans les charger tous.

Côté Claude. Un projet de l’application Claude réunit des documents et des instructions propres à un sujet. Sur les formules payantes, Claude recourt à la recherche dans les documents quand leur volume dépasse ce que la fenêtre de contexte peut contenir. Le partage d’un projet entre collègues demande la formule Team ou Enterprise6.

Côté local. Open WebUI gère des « bases de connaissances » que l’on rattache à un modèle, ou que l’on cite dans une conversation en tapant #. Il combine recherche par mots-clés et recherche par le sens7. Cette dernière s’appuie sur un modèle spécialisé, à choisir de préférence multilingue (→ chapitre 13). AnythingLLM (licence MIT) offre des fonctions comparables.

Point de vigilance. Ces fichiers et ces bases contiennent ce que vous y mettez. N’y placez ni mots de passe, ni données personnelles dont l’agent n’a pas besoin. Méfiez-vous aussi des fichiers d’instructions récupérés ailleurs : ils peuvent contenir des consignes malveillantes (→ chapitre 10).

La jauge. Pour une TPE, un fichier AGENTS.md d’une page suffit. Une base documentaire devient utile au-delà de quelques dizaines de documents ; pour trois documents, joignez-les à la conversation.

Exercice. Rédigez votre AGENTS.md en une page au plus : l’entreprise, les fichiers, les règles. Testez-le en ouvrant une session neuve et en confiant à l’agent votre tâche sans autre explication.

Notes

  1. Anthropic, « How Claude remembers your project » : https://code.claude.com/docs/en/memory (consulté le 12 octobre 2026). La lecture directe d’AGENTS.md est disponible depuis la version 2.1.277 de Claude Code.↩︎

  2. https://agents.md/ (consulté le 12 octobre 2026) ; création de l’Agentic AI Foundation, 9 décembre 2025 : https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation ; Mistral Vibe : https://github.com/mistralai/mistral-vibe.↩︎

  3. Anthropic, « How Claude remembers your project » : https://code.claude.com/docs/en/memory (consulté le 12 octobre 2026). La lecture directe d’AGENTS.md est disponible depuis la version 2.1.277 de Claude Code.↩︎

  4. Anthropic, « How Claude remembers your project » : https://code.claude.com/docs/en/memory (consulté le 12 octobre 2026). La lecture directe d’AGENTS.md est disponible depuis la version 2.1.277 de Claude Code.↩︎

  5. Anthropic, « Understanding Claude’s memory » : https://support.claude.com/en/articles/11817273-understanding-claude-s-memory.↩︎

  6. Anthropic, « What are projects? » : https://support.claude.com/en/articles/9517075-what-are-projects.↩︎

  7. Open WebUI, « Knowledge » et « RAG » : https://docs.openwebui.com/features/workspace/knowledge ; https://docs.openwebui.com/features/rag.↩︎