Au début, nourrir un agent paraît simple.
Nous lui donnons une instruction, quelques documents et la demande de l’utilisateur. Puis le projet grandit. Un AGENTS.md apparaît, suivi de plusieurs ADR, de tickets, de résultats d’outils, d’un historique de conversation et de quelques milliers de lignes de logs.
Aujourd’hui, comme la fenêtre de contexte semble assez grande et que nos modèles sont de plus en plus puissant, nous empilons tout naïvement en imaginant qu’avec toutes les informations, l’agent saura s’y retrouver grâce à la magie de la “super intelligence” :

Tout est présent.
L’ADR actuel comme celui qu’il remplace. L’erreur recherchée comme les 8 000 lignes qui l’entourent. Les décisions prises comme les hypothèses abandonnées. Et quelques notes marketing venues se glisser là pour une raison inconnue.
Le modèle reçoit beaucoup d’informations. Il doit encore retrouver celles qui méritent réellement d’influencer sa réponse.
Pour éviter cet empilement, nous allons construire une chaîne de contexte :
Une chaîne de contexte est le composant du harness qui sélectionne, réduit, ordonne et trace les informations envoyées au modèle pour un appel donné. Elle transforme un ensemble de sources candidates en un contexte de travail vérifiable, dans la limite d’un budget explicite.

Nous suivrons un même incident pour construire la partie du harness — le code qui orchestre le modèle, les outils et la session — chargée de préparer chaque appel au modèle. Les documents Markdown et les logs seront nos sources ; une configuration YAML décrira les règles de sélection ; le pseudo-code Python montrera comment les appliquer. Ces formats ont des rôles distincts. Les types et fonctions auxiliaires sont simplifiés, et les explications permettent de suivre le raisonnement sans exécuter le code.
Le cas fil rouge
Notre agent doit analyser une régression sur une API de paiement :
Depuis le dernier déploiement, les anciens clients ne peuvent plus créer de paiement. Identifie la cause, propose la correction minimale et cite les sources utilisées.
Imaginons un espace de travail contenant les sources suivantes :
Sébastien Ribiere




