Guide · IA & agents
Context engineering : Write, Select, Compress, Isolate
Appliquez Write, Select, Compress et Isolate au contexte d’un agent de code, avec un exemple de dépôt, des critères de choix et des limites.

Le context engineering consiste à choisir ce qu’un agent de code voit à chaque étape, ce qu’il conserve hors de sa fenêtre de contexte et ce qu’il transmet à la suite du travail. La grille Write, Select, Compress, Isolate aide à examiner ces décisions. Elle vient d’une taxonomie publiée par LangChain, pas d’une norme universelle ni d’une recette qui conviendrait à tous les agents.[1]
En bref. Utilisez Write pour conserver les règles et l’état hors de la conversation, Select pour charger les fichiers utiles à l’étape en cours, Compress pour remplacer un historique lourd par un point de reprise vérifiable, et Isolate pour confier un travail bruyant à un contexte séparé. Une première mise en place prend environ une heure sur un dépôt déjà testé. Les quatre opérations peuvent se combiner, mais chacune introduit aussi un risque de perte, de sélection erronée ou de coordination.
Ce que les quatre verbes décrivent
LangChain définit le context engineering comme le travail qui consiste à remplir la fenêtre avec les bonnes informations pour l’étape suivante. Son article regroupe des pratiques observées dans des agents et des travaux de recherche sous quatre verbes : écrire le contexte hors de la fenêtre, sélectionner ce qui doit y entrer, compresser ce qui s’y trouve et isoler certaines informations dans un autre contexte.[1]

Cette grille décrit des opérations. Elle ne dicte ni un produit, ni un ordre fixe, ni un seuil de tokens. Un fichier AGENTS.md peut participer à Write parce qu’il conserve une règle, puis à Select quand l’agent le charge. Un sous-agent peut servir Isolate, tandis que son rapport final applique Compress. Les catégories se recouvrent dans un système réel.
| Opération | Décision concrète | Exemple pour un dépôt | Risque principal |
|---|---|---|---|
| Write | Que faut-il conserver hors de la conversation ? | Règles du dépôt, plan de tâche, journal de décisions | Accumuler des règles périmées |
| Select | Que faut-il charger maintenant ? | Module visé, tests voisins, erreur reproductible | Oublier une dépendance utile |
| Compress | Que faut-il garder d’un historique long ? | Résumé de reprise avec preuves et chemins | Résumer une contrainte qui devait rester exacte |
| Isolate | Quel travail mérite un contexte séparé ? | Exploration du dépôt ou revue de sécurité en lecture seule | Perdre une décision lors de la remise |
Le but n’est donc pas de réduire le contexte à tout prix. Il est de rendre sa composition explicite, puis de vérifier qu’elle aide l’agent à produire un changement juste.
Write : conserver ce qui doit survivre
Dans la taxonomie d’origine, Write signifie enregistrer une information hors de la fenêtre active pour pouvoir la retrouver plus tard.[1] Pour un agent de code, deux familles de données méritent souvent cette persistance : les règles stables du dépôt et l’état d’une tâche longue.
Codex lit des fichiers AGENTS.md avant de travailler. Sa documentation décrit une chaîne qui peut partir d’un fichier global, traverser la racine du projet et recevoir des instructions plus proches du répertoire courant.[2] Ce mécanisme convient aux commandes de vérification, aux limites de sécurité et aux conventions propres au dépôt. Il convient moins à une erreur ponctuelle ou à la liste des fichiers lus pendant une seule session.
Un fichier racine court pourrait contenir ceci :
# Règles du dépôt
- Utiliser pnpm pour les commandes du projet.
- Modifier uniquement les fichiers affectés à la tâche.
- Lancer le test ciblé avant le lint global.
- Demander une validation avant toute migration ou dépendance de production.
- Rapporter les commandes exécutées avec leur code de sortie.
Cet exemple est original. Il montre une règle durable, pas une configuration requise par Codex, Claude Code ou un autre outil.
Pour une tâche qui dépasse une session, écrivez aussi un point de reprise distinct des règles générales :
# État de T-204
Objectif : refuser les jetons expirés dans src/auth/verify.ts.
Décision : conserver une marge d’horloge configurable.
Fichiers modifiés : src/auth/verify.ts, src/auth/verify.test.ts.
Preuve actuelle : le test « rejects expired token » passe.
Blocage : le comportement sans date d’expiration reste à arbitrer.
Prochaine action : lire docs/security/token-policy.md avant toute modification.
Ce fichier doit être remplacé ou archivé quand la tâche se termine. Sinon, Write transforme des décisions anciennes en contexte apparemment actuel. Pour les règles qui reviennent souvent, le guide sur AGENTS.md et les instructions de projet donne un cadre plus détaillé. Pour les tâches ponctuelles, la structure d’un prompt de tâche reste plus adaptée.
Select : charger selon la prochaine décision
Select consiste à faire entrer dans la fenêtre les informations utiles à l’action présente.[1] Sur un dépôt, cela commence souvent par une recherche de chemins et de symboles, suivie d’une lecture des quelques fichiers qui déterminent le comportement. Charger tout src/, toutes les issues et toute la documentation mélange les versions du problème et rend la source d’une règle difficile à retrouver.
Une consigne de sélection peut rester simple :
Tâche : corriger la validation des jetons expirés.
Avant de proposer un changement :
1. localiser la fonction de vérification et ses appelants ;
2. lire les tests qui nomment expiration, exp ou clock skew ;
3. ouvrir la politique de sécurité citée par ces fichiers ;
4. rapporter les chemins retenus et ce qui manque encore.
Ne modifier aucun fichier pendant cette phase.
L’agent peut alors utiliser une recherche textuelle, la navigation par symbole ou l’historique Git. Le choix dépend du dépôt. Une recherche exacte est souvent meilleure pour un nom de fonction ou un message d’erreur. Une recherche sémantique peut aider lorsqu’on ne connaît pas le vocabulaire du projet. Dans les deux cas, la sélection doit laisser une trace : requête, chemins retenus et raison de leur présence.
Il faut aussi rechercher les contre-exemples. Lire seulement l’implémentation favorise une correction locale qui ignore ses appelants. Lire seulement les tests existants peut reproduire leur angle mort. Un petit lot équilibré comprend le code ciblé, les tests voisins, les contrats publics et la configuration qui change son exécution.
La sélection se répète pendant le travail. Après un premier test en échec, le message obtenu devient un nouveau contexte. Après une modification, le diff réel remplace les suppositions du plan. Le guide analyser un dépôt GitHub sans perdre le contexte traite cette exploration à l’échelle d’un dépôt entier.
Compress : fabriquer un point de reprise vérifiable
Compress conserve les informations nécessaires à la tâche en utilisant moins de tokens. La compression peut résumer une conversation, élaguer d’anciennes sorties ou remplacer un journal volumineux par une référence vers le fichier brut.[1]
Claude Code documente un mécanisme de compaction qui remplace l’historique par un résumé structuré lorsque la fenêtre se remplit. Sa documentation indique aussi que certains éléments sont rechargés depuis le disque après la compaction, dont les instructions de projet, tandis que d’autres éléments sont résumés avec la conversation.[3] Ce comportement est propre à Claude Code et à sa version. Il ne faut pas le transposer automatiquement à Codex, Cursor ou à un agent maison.
Pour un agent de code, un bon point de reprise garde les éléments qui permettent de poursuivre et de contrôler le travail :
## Point de reprise
But accepté : refuser un jeton expiré, marge d’horloge comprise.
Décision retenue : lire la marge depuis auth.clockSkewSeconds.
Fichiers touchés : src/auth/verify.ts, src/auth/verify.test.ts.
Commandes : pnpm test src/auth/verify.test.ts, succès, 12 tests.
Échec encore ouvert : le test d’intégration ne démarre pas sans DATABASE_URL.
Sortie brute : artifacts/t-204/integration-test.log.
Diff à relire : ajout de 18 lignes, suppression de 4 lignes.
Suite : décider si le test d’intégration doit utiliser un double de base.
Le résumé distingue les décisions, les observations et les actions restantes. Il conserve un chemin vers la sortie brute au lieu de recopier mille lignes de terminal. Il ne remplace pas une valeur exacte par « les tests semblent bons ».
Compresser trop tôt peut cacher la première erreur qui explique toutes les suivantes. Compresser sans garder les fichiers touchés peut faire relire une autre version du code. Avant de jeter l’historique, vérifiez que les contraintes, les décisions irréversibles, les échecs et les preuves sont encore identifiables. La page sur les prompts et le contexte agentique versionnés propose une grille pour comparer deux versions sans confondre style et comportement.
Isolate : séparer le bruit, pas la responsabilité
Isolate place une partie du travail dans un contexte distinct.[1] Un sous-agent peut explorer cinquante fichiers, exécuter une analyse statique ou lire une longue documentation sans injecter chaque résultat dans la conversation principale. La documentation de Claude Code précise qu’un sous-agent possède sa propre fenêtre et renvoie un résultat au parent. Elle précise aussi qu’un sous-agent frais ne reçoit pas automatiquement tout l’historique du parent.[4]
Cette séparation demande donc un contrat de délégation complet :
Tâche : examiner les risques de la modification d’authentification.
Lecture autorisée : src/auth/**, docs/security/**, tests/auth/**.
Outils : lecture, recherche, commandes de test sans écriture.
Entrée : objectif T-204 et diff courant.
Sortie : risques classés par impact, chemin et ligne pour chaque constat,
commande de reproduction, informations manquantes.
Arrêt : ne corriger aucun fichier et ne supposer aucune politique absente.
Le parent reçoit un rapport court, puis vérifie les constats contre le diff. Le sous-agent n’est pas une preuve indépendante par nature. Il peut mal sélectionner ses fichiers ou résumer une nuance. Son contexte séparé ne sépare pas forcément le système de fichiers, le réseau ou les permissions. Pour éviter les collisions d’écriture, utilisez aussi une affectation de fichiers, un worktree ou un environnement dédié. Le guide sur les sous-agents Claude Code couvre cette autre forme d’isolation.
Isolate est utile pour une branche de travail autonome et riche en sorties. Il est moins adapté à deux tâches qui se modifient mutuellement à chaque étape. Séparer la conception d’une API et l’implémentation de son client avant d’avoir fixé le contrat produit deux contextes cohérents mais incompatibles.
Un exemple complet sur une correction d’authentification
Prenons le ticket fictif T-204 utilisé plus haut. Le dépôt contient un service TypeScript, des tests unitaires et une politique de sécurité. Rien n’a été exécuté pour cet exemple ; les chemins, résultats et nombres sont inventés comme données pédagogiques, pas comme compte rendu d’un projet réel.
- Write place dans
AGENTS.mdles règles qui valent pour toutes les tâches : gestionnaire de paquets, commandes, limites de fichiers et actions soumises à validation. Un fichiertasks/T-204.mdreçoit l’objectif, les décisions et le prochain pas. - Select commence par localiser
verifyToken, ses appelants et les tests d’expiration. L’agent ouvre ensuite la politique citée par ces fichiers. Il ne charge pas la documentation du frontend ni les journaux de déploiement sans lien établi. - Compress intervient après le premier cycle de correction. Le point de reprise garde le comportement attendu, le diff, les commandes, l’échec d’intégration et le chemin vers le journal brut.
- Isolate confie la revue de sécurité à un agent en lecture seule. Ce reviewer reçoit le diff et la politique, puis rend des constats associés à des lignes. Le parent reproduit les constats avant d’accepter une correction.
Le cycle ne suit pas toujours cet ordre. Une revue isolée peut demander une nouvelle sélection. Un test inattendu peut conduire à écrire une décision dans le point de reprise. La grille sert à nommer ces mouvements et à repérer ce qui manque.
Choisir l’opération à partir du symptôme
| Symptôme observé | Première opération à essayer | Contrôle à ajouter |
|---|---|---|
| L’agent oublie les commandes ou limites à chaque session | Write | Faire citer les sources d’instructions chargées |
| L’agent lit beaucoup de fichiers sans trouver le contrat | Select | Exiger les requêtes et les chemins retenus |
| La session répète les mêmes sorties et perd le prochain pas | Compress | Garder décisions, preuves, échecs et données brutes récupérables |
| Une recherche ou une revue remplit toute la conversation | Isolate | Imposer une remise courte avec références vérifiables |
| Deux agents modifient les mêmes chemins | Isolation de travail, hors fenêtre seule | Réserver les fichiers et séparer les worktrees |
| Une règle ancienne revient après plusieurs semaines | Write à nettoyer, puis Select | Dater la décision et définir son retrait |
Une seule opération suffit parfois. Si un agent ignore un test parce que son nom est inattendu, améliorez Select avant de créer trois sous-agents. Si une règle stable manque à chaque session, Write est plus direct qu’un moteur de recherche sémantique.
Mesurer avant de garder la nouvelle configuration
Comparez l’ancienne et la nouvelle configuration sur les mêmes tâches, avec le même modèle, les mêmes outils et les mêmes permissions. Notez le résultat fonctionnel, les fichiers inutilement lus, les contraintes oubliées, les interventions humaines et les dépassements de contexte. Ne fusionnez pas tout dans un score unique : une baisse de tokens ne compense pas une migration exécutée sans accord.
Relisez aussi les trajectoires. Une meilleure sélection doit réduire le bruit sans masquer une dépendance. Une compression correcte doit permettre la reprise sans réinventer une décision. Une isolation utile doit rendre la conversation principale plus lisible sans multiplier les remises contradictoires. Le guide sur le harness d’un agent de code explique comment comparer ces composants sans changer plusieurs variables en même temps.
Aucun seuil universel ne dit quand compresser, combien de fichiers sélectionner ou combien de sous-agents lancer. Le bon réglage dépend du modèle, de la tâche, des outils et du coût d’une erreur. Conservez la configuration précédente et un petit jeu de cas de régression pour revenir en arrière si la nouvelle organisation dégrade le travail.
Questions fréquentes
Le context engineering remplace-t-il le prompt engineering ?
Non. Le prompt reste une partie du contexte, avec les fichiers, les réponses d’outils, la mémoire et l’état de la tâche. La grille élargit la question : elle examine aussi ce qui entre dans la fenêtre, ce qui en sort et ce qui reste dans un autre contexte.
Faut-il appliquer les quatre opérations à chaque tâche ?
Non. Une correction courte peut tenir dans un prompt précis et quelques fichiers sélectionnés. Ajoutez une opération lorsqu’un symptôme observable le justifie, puis comparez le résultat à la configuration précédente.
AGENTS.md appartient-il à Write ou à Select ?
Aux deux selon le moment. Écrire une règle persistante relève de Write ; charger le fichier approprié dans une session relève de Select. Cette superposition montre pourquoi les quatre verbes sont une grille d’analyse plutôt que des cases étanches.
Compresser signifie-t-il supprimer les anciens messages ?
Pas forcément. Un système peut résumer, élaguer des sorties répétitives ou déplacer les données brutes dans un fichier récupérable. La méthode doit préserver les contraintes et les preuves nécessaires à la suite.
Un sous-agent isole-t-il aussi les fichiers et les permissions ?
Cela dépend du harness. Une fenêtre séparée isole le contexte du modèle, mais le sous-agent peut encore partager le dépôt ou certains outils. Vérifiez les permissions réelles et utilisez un worktree ou une sandbox quand l’isolation des effets compte.
Sources
- [1] LangChain, « Context Engineering », taxonomie Write, Select, Compress, Isolate, consultée le 4 novembre 2026.
- [2] OpenAI, « Custom instructions with AGENTS.md », hiérarchie et chargement des instructions Codex, consultée le 4 novembre 2026.
- [3] Anthropic, « Explore the context window », contenu de la fenêtre et compaction dans Claude Code, consultée le 4 novembre 2026.
- [4] Anthropic, « Create custom subagents », contexte propre et remise des sous-agents Claude Code, consultée le 4 novembre 2026.