---
title: "Votre agent n’a pas lu le contenu de votre dossier"
description: "Ouvrir un dossier dans Claude Code ou Codex ne place pas ses fichiers dans la tête du modèle. Au départ, il ne sait presque rien et doit aller lire les fichiers. C’est une bonne chose, et c’est ce qui fait d’AGENTS.md le fichier le plus important que vous écrirez."
date: 2026-10-10
language: fr
canonical: https://gduv.club/fr/articles/agent-folder-context
source: gduv.club
---
Quand on commence à travailler avec un agent dans un dossier, on suppose qu’il connaît tout ce qui s’y trouve. Vos notes, les fichiers de vos clients, le processus que vous avez consigné le mois dernier. Tout est là, alors il l’a forcément lu, non ?

Eh bien non. Quand vous ouvrez une nouvelle conversation, **l’agent ne sait presque rien** de ce que contient votre dossier. Il sait que le dossier existe et qu’il peut en consulter le contenu.

## Ce qu’il a réellement au démarrage

À la première question, le modèle reçoit une courte liste d’éléments :

- les instructions que l’application lui a fournies (comment se comporter, comment utiliser chaque outil),
- la description des outils auxquels il peut faire appel,
- un de vos fichiers, si vous en avez créé un : `AGENTS.md`,
- et votre message.

**Voilà tout ce qu’il a**. Pour le reste du dossier, il doit chercher : afficher la liste des fichiers, lancer des recherches, ouvrir ceux qui semblent pertinents. Chacune de ces actions correspond à un appel d’outil, comme lorsqu’il effectue une recherche sur le Web.

Pendant mon atelier, je le montre avec un dossier contenant 20 fichiers de tâches. Dans une nouvelle conversation, je demande en quoi consiste la tâche 10. L’agent ne répond pas tout de suite. Il cherche dans le dossier, trouve le fichier, le lit, puis répond. Ça marche, mais **il a dû aller chercher l’information**.

| Frame | Total | What it holds |
| :--- | :--- | ---: |
| Votre premier message | 7,625 jetons | instructions de l’application, descriptions des outils, AGENTS.md, votre question |
| Il cherche dans le dossier | 7,845 jetons | instructions de l’application (cached), descriptions des outils (cached), AGENTS.md (cached), votre question (cached), résultat de recherche |
| Il ouvre un fichier | 8,395 jetons | instructions de l’application (cached), descriptions des outils (cached), AGENTS.md (cached), votre question (cached), résultat de recherche (cached), task-10.md |

_Les tailles sont données à titre indicatif et varient selon l’application. L’essentiel, c’est ce qui manque : sur les 20 fichiers de tâches du dossier, seul celui qu’il a ouvert parvient jusqu’au modèle._

## Pourquoi c’est une bonne chose

C’est frustrant au début. Ce serait pratique si l’agent savait tout, tout simplement.

Mais réfléchissez au coût. Chaque message que vous envoyez s’ajoute à tout ce que reçoit le modèle : les instructions de l’application, les descriptions des outils, vos fichiers et toute la conversation jusque-là. Si votre dossier était chargé à chaque fois, vous paieriez pour tout ce contenu à chaque message, et le modèle devrait retrouver le paragraphe qui vous intéresse au milieu de tout le reste.

Les modèles récents peuvent traiter énormément de contenu, jusqu’à environ un million de jetons pour certains. Mais avoir plus de place ne rend pas tout utile. Le texte en plus crée du bruit, et le modèle peut s’y perdre, comme vous. Je veille à ce que chaque jeton présent ait une bonne raison de l’être.

C’est donc parce que l’agent ne connaît pas votre dossier que vous gardez le contrôle. Vous choisissez ce qu’il doit toujours savoir, et vous organisez le reste pour qu’il trouve vite les informations.

## AGENTS.md : votre emplacement garanti

`AGENTS.md` est un fichier texte brut, placé à la racine de votre dossier. L’application le lit au début de chaque conversation et l’ajoute au contexte du modèle, à côté de ses propres instructions. C’est le seul endroit où certaines informations sont toujours gardées en mémoire.

Mon test : ouvrez une nouvelle conversation et demandez « Qui suis-je ? ». Si votre rôle figure dans `AGENTS.md`, l’agent répond tout de suite, sans ouvrir le moindre fichier. Même chose pour une règle comme « Réponds toujours en trois puces ». Inscrivez-la là, et toutes ses réponses la respecteront.

- **You:** Qui suis-je ?
- **Agent:** Vous êtes Alex Martin, responsable du marketing de contenu chez Northwind. Vous gérez le blog, la newsletter et la page LinkedIn de l’entreprise. [1]
- **You:** En quoi consiste la tâche 10 ?
- **Tool call:** `search_files` (query: "task 10") [2]
- **Tool call:** `read_file` (tasks/to-do/T10-webinar.md)
- **Agent:** La tâche 10 concerne le webinaire destiné aux propriétaires de cliniques : choisir une date, inviter deux clients à intervenir et préparer la page d’inscription. [3]

. **Réponse immédiate**: Aucun appel d’outil. Votre identité figure dans AGENTS.md, chargé avant même votre question.
. **L’information ne figure pas dans AGENTS.md : il doit chercher**: D’abord une recherche, puis la lecture d’un fichier. Deux appels d’outil avant de pouvoir répondre.
. **La réponse vient du fichier ouvert**: Il ne connaît la tâche 10 que parce qu’il est allé la lire.

_Même conversation, deux questions. La première réponse vient d’AGENTS.md. Pour la seconde, il faut aller chercher l’information._

Auparavant, Claude Code ne lisait qu’un fichier nommé `CLAUDE.md`. Les versions récentes lisent aussi `AGENTS.md`, le nom utilisé par Codex et la plupart des autres outils. Un seul fichier suffit donc pour tous. Si le vôtre ne semble pas être pris en compte, demandez à l’agent quelles instructions il a chargées. J’explique aussi comment utiliser un seul fichier pour tous les outils dans [garder vos dépôts indépendants de l’environnement d’exécution](/articles/harness-agnostic-workspaces).

## Ce qu’il faut y mettre, et ce qu’il ne faut pas y mettre

Ma règle est simple : si une information n’est pas utile pour presque chaque message, elle n’a pas sa place dans `AGENTS.md`. Un fichier trop long consomme des tokens à chaque message et noie les règles importantes.

**Dans AGENTS.md** (utile pour la plupart des messages)

- Qui vous êtes : votre rôle, votre équipe
- L’entreprise, en deux ou trois lignes
- Règles de travail : « dire clairement quand vous n’êtes pas sûr », « expliquer comment vous avez obtenu un chiffre »
- Comment vous souhaitez recevoir les réponses : d’abord une conclusion en une ligne, puis les détails
- Un plan des dossiers
- Un tableau des compétences, avec l’emplacement de chacune
- Un tableau des outils, avec les situations où les utiliser

**Dans d’autres fichiers** (à consulter selon les besoins de la tâche)

- La présentation complète de l’entreprise et les détails sur ses produits
- Les informations sur les clients et les projets
- Comment rédiger une publication LinkedIn ou préparer un rapport client
- Les notes de réunion, les exports, les brouillons
- Tout ce dont vous n’avez besoin qu’une fois par mois

_AGENTS.md tient sur une page. Son rôle est d’indiquer ce qui est toujours vrai et où trouver le reste._

La deuxième colonne n’est pas moins importante. Elle n’a simplement pas besoin d’être consultée à chaque message. `AGENTS.md` y renvoie (« pour toute question concernant un client, consultez d’abord son fichier `information.md` »), et l’agent l’ouvre quand la tâche le nécessite. C’est ce qui permet de travailler efficacement dans un dossier volumineux.

## À vous d’essayer

Ouvrez une nouvelle conversation dans votre dossier et demandez : « Qui suis-je et quelles instructions avez-vous chargées au début de cette conversation ? »

Si la réponse est vague, soit votre fichier `AGENTS.md` est absent, soit il ne contient pas les informations importantes. Demandez à l’agent de vous aider à le rédiger. Puis **limitez-le à une page**.