CodeWiki Skill : une approche multi-agents pour documenter le code automatiquement

La documentation est le casse-tête éternel des développeurs. Tout le monde sait qu'elle est nécessaire, personne ne veut l'écrire, et quand quelqu'un s'y met enfin, le résultat est périmé avant que l'encre du dernier commit n'ait séché. CodeWiki Skill, un nouvel outil qui transforme les agents IA en rédacteurs techniques, s'attaque précisément à ce problème ancien.

Le projet, présenté sur Habr, dépasse l'approche habituelle du « donnez le code à un modèle et obtenez la description des fonctions ». CodeWiki Skill est conçu comme une extension de Claude Code, l'assistant IA en terminal d'Anthropic, mais son architecture permet aussi de l'intégrer à d'autres environnements de développement. Le système ne se contente pas de faire passer les fichiers un par un dans un modèle de langage. Il repose sur une approche multi-agents, où plusieurs agents spécialisés travaillent en parallèle, chacun dans son domaine de responsabilité.

Pour comprendre l'intérêt de la démarche, il faut se rappeler à quoi ressemble la base de code d'un projet mature. Ce n'est pas un ensemble linéaire de fichiers, mais un réseau complexe de dépendances, où la logique métier s'entremêle avec le code d'infrastructure, les configurations et les tests. Un agent analyse la structure du projet et dresse la carte des dépendances. Un autre étudie la logique de chaque module. Un troisième veille à la cohérence du document final, afin d'obtenir un wiki lisible, avec navigation et renvois croisés, plutôt qu'un fatras de descriptions éparses. Cette répartition du travail permet de traiter même de gros dépôts, où une approche monolithique se noierait tout simplement dans la fenêtre de contexte.

Le contexte général compte ici. Les systèmes multi-agents font partie des pistes de l'IA appliquée qui progressent le plus vite. Si, en 2024, l'industrie était obsédée par la taille de la fenêtre de contexte et la qualité de chaque modèle, en 2026 l'attention s'est déplacée vers l'orchestration : comment faire travailler plusieurs agents ensemble sur une tâche trop complexe pour un seul. CodeWiki Skill en est une mise en œuvre pratique et concrète. Il montre que le multi-agents n'est pas un concept de recherche abstrait, mais un patron d'ingénierie opérationnel, déjà appliqué aux tâches quotidiennes des développeurs.

Le choix du format mérite aussi l'attention. Dans l'écosystème Claude Code, un skill est en substance un plugin : un ensemble d'instructions et d'outils qui étendent les capacités de l'agent de base. L'auteur a publié CodeWiki en projet ouvert, ce qui signifie que la communauté peut l'adapter et le faire évoluer. C'est important, car les besoins en documentation varient radicalement d'un projet à l'autre : une startup avec un monorepo TypeScript n'a pas besoin de la même documentation qu'une équipe enterprise avec des microservices Java.

Il faut reconnaître que la génération automatique de documentation n'est pas une idée neuve. Des outils comme Sphinx, JSDoc et leurs équivalents existent depuis des décennies. Mais ils travaillent au niveau des fonctions et des classes, en extrayant l'information de commentaires que le développeur doit écrire à la main. CodeWiki Skill vise un autre niveau : une documentation à l'échelle de l'architecture, qui explique non seulement ce que fait le code, mais aussi pourquoi il est conçu ainsi. Naturellement, la qualité de cette documentation dépend directement des capacités du modèle sous-jacent, et un scepticisme sain s'impose : les modèles de langage peuvent toujours halluciner et mal interpréter une logique peu évidente.

La direction n'en est pas moins la bonne. Le problème de la documentation est, au fond, un problème de diffusion du savoir au sein de l'équipe. Chaque fois qu'un nouveau développeur rejoint un projet, il passe des semaines à comprendre la base de code, car la documentation est soit absente, soit décrit un code vieux de deux ans. Si les agents IA parviennent à maintenir la documentation à jour en la révisant automatiquement à chaque changement significatif, cela modifiera l'économie de l'onboarding des développeurs. CodeWiki Skill ne règle pas encore la mise à jour incrémentale, mais il pose les fondations sur lesquelles une telle solution pourrait être bâtie.

L'industrie se dirige vers un point où écrire du code et le documenter ne seront plus deux processus distincts. Des outils comme CodeWiki Skill sont les premiers signes de cette transition, et leur apparition témoigne de la maturité des architectures multi-agents comme de l'écosystème des assistants IA pour développeurs.