Instructions pour les agents
Un fichier AGENTS.md ou CLAUDE.md qui décrit l’architecture, les conventions et les commandes du projet, tenu à jour avec le code.
Freelance en France · à distance
Le harness engineering désigne tout ce qui entoure le modèle d’un agent IA de code : les instructions qu’il lit, comme AGENTS.md ou CLAUDE.md, les outils et serveurs MCP qu’il peut appeler, les hooks et les skills, la sandbox où il s’exécute, les tests et la boucle de validation en CI.
Je le mets en place avec votre équipe, dans vos dépôts, avec les outils qu’elle utilise : Claude Code, Codex ou Gemini. Les agents travaillent sur vos tâches réelles, la CI vérifie chaque commit, et l’équipe décide de ce qui est intégré.
Chaque élément est écrit dans vos dépôts, versionné avec le code et documenté.
Un fichier AGENTS.md ou CLAUDE.md qui décrit l’architecture, les conventions et les commandes du projet, tenu à jour avec le code.
Les outils que l’agent peut appeler, et les serveurs MCP (Model Context Protocol) qui lui donnent accès à vos systèmes, chacun avec des droits définis.
Des hooks qui bloquent une action interdite au moment où l’agent la tente, et des skills qui décrivent les tâches récurrentes de l’équipe.
Un environnement isolé et reproductible, où l’agent installe le projet, exécute le code et lance les tests sans accès à la production.
Des tests fiables et des contrôles d’architecture à chaque commit et en CI. Quand un contrôle échoue, l’agent reçoit l’erreur et corrige avant toute revue humaine.
Ce que l’agent reçoit pour une tâche donnée : les fichiers utiles, les décisions déjà prises, les critères de fin. Ce travail, appelé context engineering, fait partie du harness engineering.
L’intervention commence par un périmètre réduit : un dépôt, quelques tâches réelles, et des règles écrites pour l’agent dès le premier jour.
Viennent ensuite les contrôles automatiques en CI, réglés sur vos standards, vos tests et votre architecture. Chaque écart constaté sur les tâches suivantes devient une règle ou un contrôle.
Une fois le cadre éprouvé, il s’étend aux autres dépôts et au reste de l’équipe. Le même cheminement vaut avec Claude Code, Codex ou Gemini.
Avant d’étendre l’usage des agents, je vérifie des critères observables dans le dépôt et dans l’organisation de l’équipe :
Ce point peut se faire seul, sous la forme d’un audit de préparation aux agents de code : vous recevez un diagnostic écrit, avec les priorités dans l’ordre.
Quand les agents produisent davantage de code, la revue devient le point où le travail s’accumule. Les contrôles automatiques prennent en charge ce qui se vérifie mécaniquement : conventions, tests, dépendances entre modules. La revue humaine se concentre sur les choix qui demandent du jugement.
Cette pratique est parfois appelée agentic engineering : le développeur spécifie la tâche, relit les diffs, vérifie le résultat et reste responsable du code intégré.
Avec l’équipe, j’écris les règles de revue : ce qu’un agent peut proposer, ce qui doit être relu par un humain, ce que la CI refuse avant toute relecture.
C’est la construction de l’environnement de travail des agents IA de code : le contexte qu’ils reçoivent, les règles qu’ils suivent et les contrôles automatiques qui valident leur travail. Le code produit par les agents reste ainsi vérifiable, maintenable et conforme à l’architecture du projet.
En automatisant ce que la relecture ne peut plus couvrir seule : chaque commit et chaque merge request passent des contrôles qui vérifient vos standards, vos tests et votre architecture. La revue humaine se concentre sur les choix qui demandent du jugement, et les agents produisent davantage sans que la qualité baisse. C’est l’objet de l’offre harness engineering.
Par un périmètre réduit : un dépôt, quelques tâches réelles, et des règles écrites pour l’agent dès le premier jour. Viennent ensuite les contrôles automatiques en CI, puis l’extension aux autres dépôts une fois le cadre éprouvé. Le même cheminement vaut avec Codex ou Gemini.
Quelques lignes sur votre dépôt, vos outils et ce qui bloque suffisent. Le périmètre se précise lors d’un premier échange.