Aller au contenu
Alexandre Mahe
Tous les billets

Un harness minimal : réutiliser l'existant, encadrer l'agent

Cartographier tout le savoir du développement dans des skills coûte plus qu'il ne rapporte. Je réutilise l'existant, n'écris que les skills à forte valeur ajoutée, et le harness sert surtout à encadrer : permissions, tests, supervision.

Catégorie
Note
Publié
Temps de lecture
4 min de lecture
Étiquettes
#agents#harness#skills#claude-code#pi

Lire en anglais (traduction IA)

Quand un agent bute, la réponse facile est d'ajouter une consigne : une skill git, une skill Scrum, une skill par API. Quelques mois plus tard, l'expérience de développement est devenue un musée de consignes à entretenir, dont la moitié est périmée.

Ces consignes ne sont pas gratuites. Une étude de l'ETH Zurich montre que les fichiers de contexte comme AGENTS.md générés par un LLM réduisent légèrement le taux de réussite des agents et augmentent le coût d'inférence de plus de 20 % ; écrits par les développeurs, ils apportent un gain modeste, pour un coût en hausse. Un modèle de pointe connaît déjà git et les conventions courantes. Pour un freelance, la productivité vient moins du nombre de consignes que d'outils vérifiés, qu'il connaît et peut défendre devant un client.

Je réutilise ce qui existe, et je n'écris que les skills qui apportent une vraie valeur.

Bien utiliser une skillLien vers cette section

Un fichier de contexte aide quand il apporte ce que le modèle ignore, et nuit quand il répète ce qu'il sait. Une skill suit la même règle, avec une mécanique en plus : l'agent ne voit d'abord que son nom et sa description, et ne charge le reste qu'au besoin. La description décide donc si la skill sert ; le fichier principal reste court, et les détails vont dans des fichiers qu'il référence. Quand je l'écris, la description dit quand s'en servir plutôt que ce qu'elle est, et une étape déterministe devient un script plutôt qu'une procédure que le modèle devrait suivre à la lettre.

Pour une API sortie après l'entraînement, une skill n'est pas la meilleure réponse : Vercel a mesuré qu'un index compact dans le contexte faisait mieux qu'une skill que l'agent oubliait de charger. La documentation passe de plus en plus par llms.txt ou des serveurs MCP comme Context7.

Skills d'équipe, skills personnellesLien vers cette section

Les skills d'équipe décrivent ce qui ne se devine pas en lisant le code : la façon dont l'équipe travaille avec lui, ses conventions, ses étapes de revue. Elles vivent dans le dépôt et servent à tout le monde.

Les skills personnelles portent mes raccourcis, mes méthodes, ma façon de découper une tâche, tant qu'elles restent compatibles avec le projet. Elles me suivent d'un projet à l'autre et finissent par définir mon propre agent développeur augmenté.

C'est aussi une question de propriété intellectuelle. Ce qui relève de l'entreprise (ses workflows, ses conventions, son domaine) lui appartient ; ce qui relève de mon savoir-faire m'appartient. Des skills qui condensent des années de méthode doivent m'aider, pas nourrir les agents du client après la mission : mes skills personnelles restent dans mon propre dépôt.

Entreprise du client Freelance contexte réponses encadre commits Agent et sous-agents Fournisseur du LLM Dépôt : code, conventions,skills d'équipe Tests, CI, droits de fusion Skills personnelles,dans son dépôt Harness : permissions,sessions, supervision

Influencer le moins possible la première inférenceLien vers cette section

Pi pousse cette logique au bout : un court prompt système et quatre outils, presque rien avant le prompt de l'utilisateur.

L'abonnement Claude ne couvre que Claude Code et Claude.ai, pas Pi. Rien n'empêche de concevoir le harness avec Pi, puis de le transposer dans Claude Code en skills, hooks et sous-agents, qui gardent la session principale propre.

La sécurité d'abord, l'expérience ensuiteLien vers cette section

Le context engineering décide de ce qui arrive au modèle à chaque étape ; le harness décide de la façon dont l'agent travaille, y compris des mécanismes qui construisent ce contexte.

Mes deux priorités, dans cet ordre. La sécurité d'abord : des permissions strictes, des tests et une CI qui vérifient le résultat sans rien ajouter au prompt, et des outils relus avant d'être réutilisés. Une skill tierce peut contenir des scripts, un serveur MCP est du code qui tourne avec les droits de l'agent, et l'un comme l'autre peut glisser des instructions dans son contexte : je les traite comme des dépendances. L'expérience de développement ensuite : un dépôt agréable à travailler se maintient mieux, par l'humain comme par l'agent. Entre les deux, les prompts restent minimaux.

Une règle qui doit toujours s'appliquer n'a rien à faire dans un prompt. Les hooks de Claude Code l'exécutent de façon déterministe : bloquer une commande, formater un fichier modifié, lancer les tests avant de rendre la main. D'autres agents ont leurs équivalents, sous d'autres noms.

Le harness couvre aussi le passage d'une session locale à une session distante, l'échange avec un agent qui tourne en boucle, et la supervision des coûts, qui passe par le proxy décrit dans le billet sur les données clients.

Harness Contextece qui arrive au modèle PermissionsTests et CISupervision et coûts Configuration de l'éditeurSessions locales et distantesÉchange avec la boucle Outils et serveurs MCPSkills : équipe et développeurSous-agents

Un agent confortable en trois blocsLien vers cette section

Des préférences de travail, en quelques lignes dans le fichier de contexte. Les miennes :

Découpe le travail en petites tâches et parallélise ce qui peut l'être.
Lance les tests à la fin de chaque tâche, pas après chaque modification.
Tiens à jour un rapport d'avancement dans PROGRESS.md.
Pose une question plutôt que de deviner une exigence floue.

Des permissions, dans .claude/settings.json, versionné avec le dépôt ; la documentation détaille la syntaxe. Pi n'en a aucune par défaut ; des extensions les ajoutent.

"allow": ["Bash(npm run test *)", "Bash(git diff *)", "Bash(git commit *)", ...],
"ask":   ["Bash(git push *)", "Bash(npm install *)"],
"deny":  ["Read(./.env)", "Read(./secrets/**)", "Bash(curl *)", ...]

Une règle Read ne bloque pas pour autant un cat .env lancé par le shell : la vraie protection reste l'absence de secret dans le conteneur, comme dans le premier billet.

Enfin, une collection de skills réputée plutôt qu'une bibliothèque maison. Superpowers, de Jesse Vincent, couvre la conception, le TDD, le débogage et la revue ; le dépôt officiel d'Anthropic sert de référence pour en écrire. À relire avant installation, comme toute dépendance :

/plugin install superpowers@claude-plugins-official   # Claude Code
pi install git:github.com/obra/superpowers            # Pi

Prochain billet : le contexte, c'est-à-dire ce que l'agent sait du client, et sa mémoire.