Pourquoi être adapté aux agents

Les agents lisent en premier

Les recruteurs, responsables du recrutement et clients demandent de plus en plus à un assistant IA avant de lire une page : « Résume ce candidat », « Cette personne convient-elle à notre poste de Head of AI ? », « Qui pourrait nous aider à définir une stratégie IA ? » L’agent récupère, lit, filtre et résume. Un site personnel qui n’est qu’une belle page laisse cet agent deviner — il racle des mises en page, manque du contexte, invente les trous.

Le travail de Jenks a toujours porté sur ce type de levier. Il a passé des années à rendre des plateformes utilisables par d’autres bâtisseurs : des APIs et SDKs chez Xero, une plateforme développeurs chez Linktree, des écosystèmes chez Filecoin et Babylon. Sa devise de leadership — « Je dirige en aidant mon équipe à rayonner » — s’étend naturellement à l’IA : construire les interfaces qui permettent à d’autres agents de bien travailler. Son propre site est donc construit comme il conseillerait à une entreprise de construire une plateforme : pour les personnes et pour les agents qui l’utilisent.

Ce que « adapté aux agents » signifie ici

• Découvrable : llms.txt à la racine liste tout ce dont un agent a besoin ; /brief.md est la page de départ en une page ; /.well-known/site-agent.json et /openapi.json décrivent les interfaces.
• Structuré : /experience.json et /llms-full.txt donnent tout le corpus avec des tags, des filtres de rôle, des dates et des résultats clés, pour qu’un agent puisse filtrer au lieu de deviner.
• Appelable : un serveur MCP distant, une REST API et une CLI qui sert aussi de serveur MCP local — les mêmes outils partout, générés à partir d’une seule spécification.
• Honnête : les réponses sont étayées, distinguent ce qui a été fait de ce qui pourrait être fait, et indiquent les lacunes (voir Ancrage et honnêteté).
• Documenté pour les agents : ces docs suivent Diátaxis — tutoriels, guides pratiques, référence et explication — et chaque page est aussi servie en Markdown brut.
• Multilingue : sept langues, avec la même structure dans chacune.

Pourquoi Diátaxis

Les agents et les personnes arrivent avec des besoins différents : apprendre le système, accomplir une tâche, rechercher un paramètre exact, ou comprendre un choix de conception. Mélanger tout cela rend chaque page moins bonne. Diátaxis garde chaque page dédiée à un seul objectif, ce qui rend aussi les pages plus faciles à retrouver et à citer par un agent.

Les règles du projet

Deux règles gardent le site adapté aux agents à mesure qu’il grandit. Elles sont écrites dans le AGENTS.md du dépôt, afin que toute IA travaillant sur le code les suive :

1. Chaque nouvelle fonctionnalité est livrée sur chaque surface. Si une capacité est ajoutée pour les personnes, elle est aussi ajoutée à la spécification — et donc à la REST API, aux serveurs MCP, à la CLI et à la documentation de référence générée — et les binaires téléchargeables de la CLI sont reconstruits et publiés sur la page des agents.
2. Chaque changement couvre chaque langue. Le contenu et les textes d’interface sont mis à jour dans les sept langues : l’anglais est rédigé, et les six autres sont régénérées et vérifiées par rapport au glossaire avant la mise en production.

Le bénéfice

Un agent qui peut appeler list_experience avec lens=solution-architect donne à son utilisateur une réponse précise et sourcée en quelques secondes. C’est mieux pour la personne qui demande, mieux pour Jenks, et un exemple concret du type d’organisation prête pour l’IA que Jenks aide les entreprises à construire.