Que mettre dans CLAUDE.md et que joindre à une tâche précise
Au démarrage, Claude Code lit le fichier CLAUDE.md du dépôt. Codex et de nombreux autres agents ont le même type de fichier, AGENTS.md. C’est un endroit pratique pour tout ce que l’agent doit savoir du projet : comment lancer les tests, où se trouve quoi, quelles sont les règles de code.
Avec le temps, le fichier grossit, et on y voit apparaître des instructions qui ne servent pas dans chaque tâche.
Un exemple : des relecteurs après le développement
Pour les tâches de code, une technique utile consiste à faire appel à des relecteurs indépendants. Après le développement, l’agent lance des sous-agents distincts, qui n’ont pas vu comment le code a été écrit. Ils lisent les modifications et les comparent à la tâche et aux règles du projet. L’un vérifie que ce qui était demandé a bien été fait. Un autre examine le style et le code superflu. L’agent corrige ce qu’ils trouvent avant d’écrire « terminé ».
Une telle instruction occupe une quinzaine de lignes. Placée dans CLAUDE.md, elle est transmise à l’agent à chaque session : dans une tâche de texte pour une page d’accueil comme dans l’analyse de logs, où il n’y a aucun code à relire. C’est du contexte en trop, et parfois du travail en trop.
L’écrire à la main dans chaque tâche n’est pas pratique non plus. On l’oublie facilement, et en la copiant depuis une ancienne tâche, on reprend facilement une version périmée.
Une instruction pour un seul type de tâche
Dans Tascue, une telle instruction devient un extrait, par exemple « Relecteurs indépendants ». On le coche dans les tâches où le code change, et à la copie il se place à la fin du prompt. Les tâches de texte et de recherche ne l’ont tout simplement pas.
Si l’extrait apparaît alors que le backlog contient déjà beaucoup de tâches, on peut l’ajouter à toutes d’un coup : « Appliquer à toutes les tâches du backlog ». Les tâches en cours et terminées ne changent pas.
Quoi mettre où
| Instruction | Où la garder |
|---|---|
| Utile dans toutes les tâches de ce dépôt : comment lancer les tests, comment le projet est organisé | CLAUDE.md |
| Utile dans les tâches d’un même type : relecture de code, vérification dans le navigateur, règles de rédaction | Extrait du projet |
| Utile dans tous les projets : « ne fais pas de commits » | Extrait commun, activé par défaut dans les nouvelles tâches |
| Utile dans une seule tâche | Texte de la tâche |
Un test simple pour une nouvelle instruction : sert-elle dans chaque tâche ? Sinon, sa place est dans un extrait, et CLAUDE.md reste assez court pour se lire en une minute.
Le prompt de la tâche s’assemble tout seul : intro, champs, texte, extraits. On peut le coller dans Claude Code après « Copier » ou le transmettre via MCP, et l’agent reçoit la même tâche en entier.