Plan de la formation
Ingénierie agentique : la formation pratique · Module 2: L’ingénierie du contexte
Donner les bons fichiers, docs et exemples
Pointer, coller ou laisser de côté : comment donner à un agent les fichiers, la doc et les exemples de référence dont il a besoin, et rien de plus.
Leçon 7 / 24 · ⏱ 8 min
Les agents peuvent fouiller votre dépôt tout seuls, et ils se débrouillent bien. Mais chercher coûte des étapes et du budget, et ils tombent parfois d’abord sur la mauvaise chose : le helper déprécié, le vieux pattern, le test que personne n’entretient.
La façon la plus rapide que je connaisse d’améliorer ce que produit un agent, c’est de lui donner le bon matériel d’entrée de jeu. Pas plus de matériel. Le bon.
Trois façons de donner du contexte
Pointer, c’est mon choix par défaut : un chemin et une ligne qui dit pourquoi. Coller, c’est pour ce que le dépôt ne contient pas, comme le rapport de bogue d’un client, une réponse d’API ou la section d’une spec qui s’applique.
L’exemple de référence bat la description
Si vous voulez qu’un nouvel endpoint, composant ou migration ressemble aux autres, ne décrivez pas vos conventions. Nommez le meilleur existant et dites « suis celui-là ».
Ajoute un endpoint GET /invoices/:id/pdf.
Prends src/routes/invoices/get-invoice.ts comme référence :
même validation, même gestion d'erreurs, même structure de tests.
Son test est src/routes/invoices/get-invoice.test.ts.
Règle d'affaires absente du code : une facture brouillon retourne 404, pas 403.Docs externes et versions de librairies
Les agents ont appris les librairies à partir d’un instantané du passé. Si vous utilisez une version majeure plus récente, ils risquent d’écrire l’ancienne API avec aplomb. Quand une tâche repose sur une librairie qui a changé récemment, donnez-lui la page de doc pertinente pour votre version, ou pointez vers une copie locale, et nommez la version dans le brief.
Bâtir un paquet de contexte
Pour toute tâche plus grosse qu’une ligne, je rassemble les quatre mêmes éléments avant de lancer l’agent.
- 1
Où
Les deux ou trois fichiers où le changement va atterrir.
- 2
Comme quoi
Un exemple de référence du pattern à suivre, et son test.
- 3
Ce que le code ne peut pas lui dire
Les règles d’affaires, les contraintes, le piège que vous connaissez déjà.
- 4
Faits externes
Seulement l’extrait qui s’applique : une erreur, une section de spec, une page de doc pour votre version.
La rédaction du brief complet, avec critères d’acceptation, c’est le module 3. Le paquet de contexte est la partie du brief qui répond à « qu’est-ce qu’il doit regarder? ».
Pointer, coller ou laisser de côté?
🎮 Pointer, coller ou laisser de côté?
1 / 8 · Pointage: 0
Tâche : ajouter un export CSV à la page des commandes. Comment donneriez-vous chaque élément à l’agent?
Avant de continuer
✅ À retenir
0 / 4 complété