Freek Van der Herten explique que le fichier CLAUDE.md doit servir de mémoire de travail à court terme pour des sessions de codage avec l’IA, et non d’emplacement permanent pour la documentation du projet. Son rôle est de fournir un contexte immédiat à l’IA, pas de servir d’archive à long terme.

Pour qu’il reste utile, Van der Herten conseille de garder ce fichier léger et bien ciblé. Il met en garde contre le fait de laisser CLAUDE.md devenir un énorme bloc de 300 lignes, car cela le rend difficile à lire et moins utile pour les agents d’IA.