Aller au contenu

Freelance en France · à distance

Harness engineering pour les agents IA de code

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é.

Ce que couvre l’intervention

Chaque élément est écrit dans vos dépôts, versionné avec le code et documenté.

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.

Outils et serveurs MCP

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.

Hooks et skills

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.

Sandbox d’exécution

Un environnement isolé et reproductible, où l’agent installe le projet, exécute le code et lance les tests sans accès à la production.

Tests et boucle de validation en CI

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.

Contexte de chaque tâche

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.

Comment se déroule une intervention

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.

Préparation aux agents de code

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 :

  • des tests fiables, qui donnent le même résultat à chaque exécution ;
  • une installation reproductible, qu’un agent ou un nouveau développeur lance sans aide ;
  • un fichier d’instructions pour les agents, à jour ;
  • des périmètres clairs : ce que l’agent peut modifier, et ce qui demande une validation humaine ;
  • une CI qui bloque l’intégration quand un contrôle échoue ;
  • une revue de code qui suit le rythme des contributions.

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.

Relire le code produit par les agents

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.

Questions sur le harness engineering

Qu’est-ce que le harness engineering ?

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.

Comment accélérer une équipe avec les agents IA sans perdre en qualité ?

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 où commencer avec Claude Code dans une équipe ?

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.

Parlons de vos agents et de votre CI

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.

Accéder au formulaire de contact