Les agents de code Claude ne lisent pas automatiquement la documentation du projet.

Comment les Agents Claude Code Gèrent la Documentation de Projet

Lorsqu'ils travaillent avec le système d'agents de Claude Code, les développeurs doivent être conscients d'une limitation spécifique dans la façon dont les sous-agents accèdent à la documentation du projet. Selon un rapport d'utilisateur de r/ClaudeAI, lorsque Claude Code envoie des agents pour gérer des tâches de codage, ces agents fonctionnent avec un contexte limité.

Détails Clés de la Source

Le problème a été découvert lors d'une session de débogage où un agent a rencontré à plusieurs reprises des pièges documentés. Lorsqu'on lui a demandé pourquoi il avait ignoré les avertissements documentés, l'agent a répondu : "Je n'ai pas lu CLAUDE.md avant d'écrire le callback. J'avais les motifs de la base de code dans mon contexte de prompt de la phase d'exploration, mais lorsque j'ai envoyé l'agent Sonnet pour écrire les routes OAuth, le prompt de l'agent décrivait quoi construire, pas contre quels pièges vérifier."

L'agent a précisé : "Les sous-agents Sonnet ne voient que ce que je mets dans leur prompt. Ils ne lisent pas automatiquement CLAUDE.md, MEMORY.md ou tout contexte de projet, sauf si je leur dis explicitement de le faire."

Implications Pratiques

• Les sous-agents comme Sonnet ne travaillent qu'avec le contexte fourni dans leur prompt spécifique
• Les fichiers de documentation de projet (CLAUDE.md, MEMORY.md) ne sont pas automatiquement chargés
• Les agents écrivent du code à partir de zéro sans consulter les listes de pièges existantes, sauf instruction explicite
• Cela peut conduire les agents à répéter des problèmes documentés qui auraient pu être évités

Ce comportement signifie que les développeurs doivent être explicites sur l'inclusion des références à la documentation lorsqu'ils envoient des agents pour gérer des tâches de codage spécifiques. Les agents conservent les motifs de la base de code de la phase d'exploration mais ne font pas automatiquement référence aux fichiers de documentation spécifiques au projet.