Nouvelles règles d’ingénierie du contexte pour les modèles Claude 5

• Avec Claude Opus 5 et Claude Fable 5, la réduction de plus de 80 % du prompt système de Claude Code n’a entraîné aucune dégradation mesurable des performances dans les évaluations de codage
• Les règles détaillées qui empêchaient les pires cas avec les anciens modèles peuvent entrer en conflit entre le prompt système, les Skills, CLAUDE.md et les demandes utilisateur ; avec les modèles récents, il vaut mieux leur permettre d’utiliser le contexte environnant et leur propre jugement
• Au lieu de fournir à l’avance toutes les consignes et tous les exemples d’outils, l’approche applique une divulgation progressive (progressive disclosure), avec des interfaces expressives et un chargement des informations et outils au moment nécessaire
• Il est recommandé de consigner brièvement dans CLAUDE.md uniquement les pièges du dépôt, de séparer les longues consignes dans des Skills, et d’utiliser des références riches comme des spécifications, suites de tests, maquettes HTML, du code ou des grilles d’évaluation
• /doctor et claude doctor permettent d’ajuster la taille des Skills et de CLAUDE.md ; le contexte des modèles récents doit être structuré pour réduire les répétitions et les contraintes excessives et retrouver les informations pertinentes au besoin

---

L’ingénierie du contexte au-delà du prompt

• Quand Claude traite un message, le prompt utilisateur n’est qu’une partie du contexte total ; le reste est assemblé à partir du prompt système, des Skills, de CLAUDE.md, de la mémoire, etc.
• L’ingénierie du contexte s’applique en commun à de nombreuses requêtes, ce qui la rend plus difficile à rédiger de manière spécifique qu’un prompt individuel, mais elle influence fortement les résultats de Claude Code et des agents personnalisés
• Il faut concevoir des prompts et consignes généraux sans connaître à l’avance les demandes utilisateur, et la bonne approche évolue à mesure que les capacités de Claude progressent
• Avec Claude Opus 5 et Claude Fable 5, la suppression de plus de 80 % du prompt système de Claude Code n’a entraîné aucune dégradation mesurable des performances dans les évaluations de codage
• Cette bonne pratique a été intégrée à claude doctor, et Claude Code permet d’ajuster les Skills et CLAUDE.md à une taille appropriée avec /doctor

Libérer le modèle des contraintes excessives

• L’ancien Claude Code était soumis à un nombre excessif de contraintes, non seulement dans le prompt système, mais aussi dans CLAUDE.md et les Skills
  • Dans une même requête, des consignes comme « laisse une documentation appropriée » et « n’ajoute pas de commentaires » pouvaient entrer en conflit via le prompt système, les Skills et la demande utilisateur
  • Même lorsque Claude pouvait interpréter l’intention de l’utilisateur, les consignes qui se recouvraient ou se contredisaient l’obligeaient à réfléchir plus prudemment avant de décider comment agir
• Par le passé, ces contraintes étaient nécessaires pour éviter les pires situations, mais les modèles récents permettent d’en supprimer plusieurs et de s’appuyer sur le contexte environnant et leur propre jugement
• Les outils que Claude Code peut exploiter se sont également multipliés
  • Auparavant, CLAUDE.md était le principal emplacement de stockage de la mémoire, des informations et des consignes
  • Aujourd’hui, la mémoire, les artefacts et les Skills permettent de rappeler et de partager du contexte entre les sessions

Exploiter le jugement contextuel plutôt que des règles fixes

• Les premières versions de Claude Code incluaient des consignes fortes, pas toujours appropriées, afin d’éviter les pires situations comme la suppression de fichiers
• L’ancien prompt système demandait de ne pas écrire de commentaires par défaut dans le code, interdisait les docstrings de plusieurs paragraphes ou les commentaires multilignes, et demandait de ne pas créer de documents de planification, de décision ou d’analyse sauf demande de l’utilisateur
• Ces règles peuvent être inadaptées à certaines demandes
  • L’utilisateur peut avoir des préférences spécifiques en matière de documentation
  • Certaines parties d’un code complexe peuvent nécessiter des commentaires multilignes
• Avec les anciens modèles, ce compromis était nécessaire, car ils écrivaient souvent de mauvais commentaires sans garde-fous ; les modèles récents gèrent mieux ces décisions même sans règles explicites
• Le nouveau prompt système utilise une consigne fondée sur le contexte : « écris du code qui se lit comme le code environnant, et aligne la densité de commentaires, le nommage et les idiomes »

Concevoir des interfaces expressives plutôt que des exemples

• La règle clé de l’utilisation d’outils par le passé consistait à fournir à Claude des exemples d’utilisation
• Avec les modèles récents, les exemples peuvent restreindre l’espace d’exploration à une zone particulière ; il faut donc privilégier l’expressivité des interfaces et des paramètres des outils, scripts et fichiers
• Définir le status de l’outil Todo comme une énumération pending, in_progress, completed permet de suggérer naturellement son usage
• La consigne de ne conserver qu’un seul élément en in_progress concrétise le comportement attendu au niveau de l’interface

Ouvrir l’information au moment nécessaire grâce à la divulgation progressive

• Aux débuts de Claude Code, centré sur le codage, les méthodes de revue de code et de validation étaient décrites en détail dans le prompt système
• Ces informations n’étaient pas toujours nécessaires, mais elles étaient importantes pour certaines tâches
• Aujourd’hui, il est possible d’utiliser la divulgation progressive pour charger le contexte approprié au moment nécessaire
  • Déplacer les consignes de validation et de revue de code dans des Skills distincts, que Claude Code appelle sélectivement
  • Certains outils sont chargés à la demande, et l’agent doit rechercher leur définition complète avec ToolSearch avant de les utiliser
  • Il est possible de fournir de nombreux outils, comme avec l’outil Task, sans qu’ils occupent du contexte avant d’être nécessaires
• Il n’est pas nécessaire de faire de CLAUDE.md et Skill.md un dépôt central de toutes les pratiques possibles
• À la place, on peut les organiser comme une arborescence de fichiers appelée au besoin ; cette approche est également abordée dans le harnais de workflows dynamiques par tâche

Fusionner les consignes répétées dans de simples descriptions d’outils

• Les anciens modèles Claude nécessitaient parfois de répéter les mêmes consignes, et suivaient parfois mieux les consignes placées à la fin du contexte qu’au début
• C’est pourquoi les mêmes consignes ou exemples d’utilisation d’outils étaient placés à la fois dans le corps du prompt système et dans la description des outils
• Avec les modèles récents, il est possible de supprimer les exemples répétés et de placer le mode d’emploi des outils uniquement dans leur description

Passer de CLAUDE.md à la mémoire automatique

• Par le passé, il était recommandé d’utiliser le raccourci # pour écrire automatiquement des informations dans CLAUDE.md, afin que les utilisateurs enregistrent directement la mémoire de Claude
• Aujourd’hui, Claude mémorise automatiquement les informations pertinentes pour la tâche et l’utilisateur

Des références riches au-delà de simples spécifications

• Claude Code en mode planification s’appuyait fortement sur des fichiers de plan Markdown pour pouvoir s’y référer à nouveau au besoin, et, dans les projets longs, stockait parfois les spécifications dans la base de code
• Les versions récentes de Claude peuvent traiter des références dans des formats plus complexes
  • Des artefacts HTML créés avec la nouvelle fonctionnalité d’artefacts
  • Du code, comme une fonction à porter depuis une autre base de code
  • Des spécifications exprimées sous forme de suite de tests détaillée
• Une grille d’évaluation (rubric) est un autre format de référence qui permet à Claude d’essayer et de valider des préférences ou critères de qualité propres à un domaine
  • Elle peut définir des critères comme ce qui constitue une bonne conception d’API
  • Les workflows dynamiques peuvent créer un agent de validation utilisant cette grille d’évaluation

Rôle de chaque composant du contexte

• Prompt système

  • Étroitement lié au contexte produit, il indique à Claude dans quel produit il travaille et quelle tâche il accomplit
  • Les utilisateurs de Claude Code ont rarement à le modifier, mais c’est une zone dans laquelle il faut investir beaucoup de temps si l’on crée son propre harnais d’agent

• CLAUDE.md

  • Le garder léger et décrire brièvement l’objectif du dépôt, tout en utilisant la plupart des tokens pour consigner les pièges à surveiller dans la base de code
  • Une règle de dépôt imposant de placer tous les types dans un seul fichier unique mérite d’être consignée
  • Éviter les informations évidentes que Claude peut découvrir en explorant le système de fichiers ou le dépôt
  • S’il existe plusieurs consignes propres à la validation du travail, créer un Skill de validation et le référencer depuis CLAUDE.md afin d’appliquer la divulgation progressive

• Skills

  • Les structurer comme des guides légers aidant Claude à trouver les informations au moment nécessaire
  • Éviter les contraintes excessives, sauf dans les domaines très importants
  • Pour les Skills longs, il vaut mieux les diviser en plusieurs fichiers chargés progressivement
  • Ils sont surtout utiles pour contenir des points de vue, connaissances et bonnes pratiques propres à une personne, une équipe ou un produit

• Références

  • Mentionner un fichier avec @ permet à Claude de consulter des informations détaillées liées au plan en cours
  • Les fichiers de spécification, les maquettes et même des bases de code complètes peuvent servir de références
  • Comme le code fournit des consignes claires et fidèles dans un langage que Claude connaît bien, il est généralement préférable de privilégier les fichiers sous forme de code
  • Une maquette de design en HTML produit généralement de meilleurs résultats qu’une description de design ou une capture d’écran

Simplifier le contexte existant

• Il faut simplifier le contexte en supprimant les règles, répétitions et informations inutiles dans le prompt système, les Skills et CLAUDE.md
• La commande claude doctor prend automatiquement en charge cette simplification
• Des informations supplémentaires sur la rédaction de prompts pour les modèles avancés sont disponibles dans le guide de terrain de Claude Fable