Quand vous rédigez un README ou un document de passation, vous finissez toujours par ajouter un schéma structurel à côté du texte. Le dessiner n’est pas le plus difficile. Le plus difficile, c’est qu’il commence à devenir obsolète à la seconde où vous le terminez : deux modules sont refactorisés, une file de messages apparaît, et le diagramme montre encore la forme du mois dernier — si bien que la personne suivante qui lui fait confiance apprend le mauvais système.

Archify est un skill optionnel de Hermes qui vise exactement ce problème. Vous lui donnez une petite spécification JSON typée (ou vous collez la Mermaid que vous aviez déjà), et il produit un diagramme HTML interactif autonome — après lui avoir fait passer une passe de validation.

Ce qu’il fait réellement

Voyez archify comme traitant un diagramme comme un artefact régi par un schéma plutôt que comme une image :

• cinq types de diagrammes : architecture, workflow, sequence, dataflow et lifecycle (machine à états) ;
• la sortie est du HTML autonome : thèmes sombre et clair, panoramique et zoom, recherche, traçage des relations, animation de trace optionnelle, et export PNG / JPEG / WebP / SVG / WebM ;
• l’entrée peut être des exigences en langage naturel, ou de la Mermaid copiée d’ailleurs (flowchart, sequenceDiagram, stateDiagram) ;
• quand le diagramme doit refléter du code réel, il peut lire les preuves du dépôt au lieu de travailler uniquement à partir de votre description.

La différence importante est la dernière étape : chaque candidat passe par un reçu validate / deliver en neuf contrôles. « Ce diagramme est-il correct ? » devient quelque chose que vous pouvez vérifier, et non quelque chose que vous jugez à l’œil.

L’installer

hermes skills install official/creative/archify

C’est un skill officiel optionnel — il ne fait pas partie d’une installation par défaut. Il réside dans optional-skills/creative/archify, est écrit par tt-a1i, sous licence MIT, version 2.17.0.

Un détail de conception mérite d’être connu : côté Hermes, il s’agit d’une entrée de catalogue maintenue en amont. Le skill lui-même vit dans tt-a1i/archify (le CLI Node, les schémas, les moteurs de rendu, les exemples et les références s’y trouvent tous), et l’installation tire l’arbre courant en direct depuis ce dépôt, mis en quarantaine et analysé comme toute installation depuis le hub. L’avantage est direct : la copie que vous installez ne peut pas devenir obsolète.

Il y a exactement un prérequis : Node.js 18+ sur le PATH. L’installation tire environ 200 fichiers (~8 Mo, principalement des tests et des exemples en amont) et la récupération est épinglée à un unique SHA d’arbre. Confirmez le résultat avec :

node bin/archify.mjs doctor

Aucun npm install n’est nécessaire à l’intérieur du paquet du skill.

Cinq types, un seul workflow

Pour vous, le workflow est toujours le même : décrivez ce que vous voulez, obtenez un diagramme HTML plus un reçu de validation.

Quelques choix font gagner du temps en pratique :

• « de quoi le système est-il fait et comment les parties se connectent-elles » → architecture ;
• « dans quel ordre une requête traverse-t-elle ces étapes » → workflow ou sequence (le premier pour un flux avec branchements, le second pour les allers-retours entre participants) ;
• « d’où viennent les données, que leur arrive-t-il, où atterrissent-elles » → dataflow ;
• « quels états cet objet possède-t-il et quels événements le font changer » → lifecycle.

Si vous avez déjà de la Mermaid — beaucoup de notes de réunion et d’issues en contiennent — la coller et laisser archify la convertir en version interactive vaut mieux que de redécrire la chose depuis zéro.

Comment il répartit le travail avec le skill intégré

Hermes embarque un skill architecture-diagram : zéro dépendance, et le repli à côté d’archify (les deux partagent la même lignée Cocoon AI).

Le choix est simple :

• un diagramme, aucune installation de Node, aucune interactivité ni export nécessaire → le skill intégré ;
• un reçu de validation, la conversion de Mermaid, les types sequence/lifecycle, ou des exports au-delà d’un simple fichier HTML → archify.

Deux choses à garder en tête

1. Sa vérification de mise à jour ne fait qu’afficher un avis. L’étape amont de « sensibilisation aux mises à jour » exécute scripts/check-update.mjs, qui lit un manifeste de release depuis GitHub et ne fait qu’afficher un avis — il ne télécharge ni n’installe jamais rien. Si les appels sortants ne sont pas souhaités dans votre environnement, sautez-la.
2. Lire votre code impose une exigence de contexte. Quand vous demandez à archify d’ancrer un diagramme dans les preuves du dépôt, il lit ce qui se trouve dans votre répertoire de travail courant — donc l’invoquer depuis la racine du dépôt est bien plus utile que depuis un dossier temporaire vide.

La version courte

L’argument de vente n’est pas « l’agent sait dessiner » — cela a cessé d’être nouveau il y a un moment. C’est qu’archify traite un diagramme comme quelque chose doté d’un schéma, d’une passe de validation et d’un reçu : cinq types qui correspondent à cinq intentions claires, une entrée qui peut être du JSON typé ou de la Mermaid existante, une sortie qui est du HTML interactif avec plusieurs formats d’export, et une entrée de catalogue maintenue en amont pour que votre copie ne soit jamais obsolète.

Si vous cherchez des skills optionnels, le récapitulatif des skills optionnels offre une vue plus large. Pour la visualisation en général, voir l’article sur le bureau 3D et le hub de skills du desktop. L’ensemble des commandes pour installer, approuver et gérer les skills se trouve dans la référence hermes skills.