Archify génère des diagrammes d'architecture vérifiables
Archify est une compétence d'agent pour Cursor, Claude Code, Codex CLI et OpenCode qui transforme les bases de code ou les descriptions de système en cartes système belles, interactives et vérifiables. Il résout un problème fondamental : les agents IA inventent souvent la topologie lors de la création de diagrammes, produisant des images impossibles à vérifier ou à tracer. Sa principale différence est de faire émettre d'abord un représentant intermédiaire typé au format JSON (IR), que le système compile de manière déterministe en HTML/SVG, garantissant ainsi que chaque diagramme est vérifiable et traçable. Il prend en charge les diagrammes d'architecture, de workflow, de séquence, de flux de données et de cycle de vie, offrant la comparaison de snapshots avant/après, la recherche de nœuds, le suivi de la accessibilité amont/aval, la comparaison des rôles sémantiques et la lecture d'histoires guidées, et exporte du HTML autonome ainsi que du PNG, du SVG, du WebM et des cartes de partage 1200x630. Idéal pour l'examen d'architecture, la visualisation de base de code, les présentations de solution et la communication entre équipes.
Contexte
Lorsque les développeurs confient à un agent la tâche de dessiner une architecture, une séquence ou un flux de données, ils découvrent trop souvent que le modèle invente des composants, des connexions ou des routes qui n'ont jamais existé. Ces diagrammes paraissent professionnels mais ne peuvent être vérifiés, et une fois introduits dans une revue ou une communication transéquipes, ils menacent de fausser les décisions. Archify (tt-a1i/archify) naît précisément pour répondre à ce lacet. Ce système du Node.js de rendu et de validation s'insère comme compétence d'agent dans Cursor, Claude Code, Codex CLI et OpenCode, transformant une base de code ou une simple description système en une carte interactive et vérifiable.
Positionné à la croisée du mouvement « architecture as code » et de la chaîne d'outils des agents de codage, le projet s'inscrit dans les catégories agent-skills, architecture-diagram, codex et coding-agents. Il évolue actuellement au build de développement v2.17.0-dev.1 et cumule une attention croissante sur GitHub, signe d'un intérêt réel de la communauté pour les diagrammes d'architecture vérifiables. Son ambition est double : doter les agents d'une capacité de dessin, mais aussi satisfaire l'exigence humaine de crédibilité sur les images produites.
Analyse approfondie
Le cœur du dispositif d'Archify réside dans le découplage entre le dessin et la validation. L'agent est d'abord requis pour émettre une représentation intermédiaire typée au format JSON, que le système compile ensuite de manière déterministe en HTML ou en SVG. La图形 n'est plus le produit libre de l'échantillonnage du modèle mais le résultat contraint de vérifications de type et déterministes. Quatre capacités perceptibles en découlent. La première, l'ouverture immédiate : cinq types de diagrammes, quatre préréglages, thèmes sombres et clairs, marquage et animations mesurées rendent les images adaptées aussi bien aux fenêtres de discussion qu'aux présentations formelles.
La deuxième, la revue des changements d'architecture avant fusion : le système compare deux snapshots validés sous la forme Avant / Delta / Après, signalant avec précision ajouts, suppressions, modifications, déplacements et reroutages, rendant l'évolution architecturale auditable. La troisième, chaque interaction ancrée dans les faits : recherche de nœuds, ouverture optionnelle d'une source révisée et vérifiée, traçabilité amont-aval, comparaison des rôles sémantiques et lecture d'histoires guidées opèrent sans inventer de topologie. La quatrième, un fichier pour partager : l'IR typé et les vérifications déterministes produisent un HTML autonome, exportable en PNG, SVG, WebM et en carte de partage 1200x630.
L'installation reste volontairement sans friction : une seule commande, npx skills add tt-a1i/archify -g, suffit, les utilisateurs de Cursor disposant par ailleurs d'un démarrage rapide pour les commandes globales et de projet. Aucun dépôt n'est à cloner, il suffit de décrire le système dans un chat pour générer une image. La documentation propose trois entrées, dont une Proof Lab recensant onze scénarios validés, chacun accompagné de sa source JSON, de ses vues nommées et de ses reçus de validation, démontrant concrètement le principe de vérifiabilité.
Impact sur l'industrie
La portée d'Archify dépasse le simple outil : elle introduit le principe d'engineering de la vérifiabilité dans le dessin, historiquement la partie la moins contrôlable de la sortie des agents IA. Pour les communautés de développeurs, elle offre un paradigme traitant la sortie de l'agent comme un artefact auditable ; pour les équipes d'engineering, la comparaison des changements d'architecture avant fusion et la traçabilité au service direct de la revue de code et du contrôle des risques. Le projet ancre sa réalité en traçant une carte d'architecture générée depuis le vrai dépôt mco-org/mco à un commit déterminé, jumelée à une traçabilité de reachabilité et à une source typée.
L'outil porte toutefois des risques qu'il convient d'observer. Lorsque la crédibilité d'un diagramme dépend fortement des contraintes de type et des règles de validation de l'IR, celles-ci peuvent comporter des lacunes, ou l'agent peut s'écarter des faits lors de la génération de l'IR, réduisant la validation à une formalité. Par ailleurs, la compilation déterministe élimine le hasard mais ne garantit pas que la description topologique corresponde exactement au code réel ; les chemins critiques exigent encore une vérification manuelle. L'expérience en couches permet aux développeurs de choisir leur niveau de profondeur selon leurs besoins de confiance, du croquis rapide au livrable partageable.
Perspectives
Plusieurs orientations méritent d'être observées : la validation des reçus deviendra-t-elle une pièce standard dans les workflows d'équipe, la comparaison des rôles sémantiques et le récit guidé réduiront-ils encore les coûts de communication transéquipes, et l'outil sera-t-il nativement adopté par davantage d'agents de codage et de pipelines CI. Archify incarne une voie pragmatique : il ne poursuit pas des dessins d'IA plus ornés mais des dessins sur lesquels on puisse compter. À mesure que l'écosystème architecture-as code mûrit, son approche fondée sur la déterminisme pourrait fixer une référence pour la validation, l'audit et le partage des diagrammes générés par agents au sein des organisations d'engineering.
En définitive, le projet replace les diagrammes du statut d'images jetables vers celui d'artefacts vérifiables. La traction de ce changement dépendra de la capacité des équipes à traiter les reçus de validation comme autoritatifs et de la robustesse du modèle de compilation déterministe à remplacer, en revue de code en production, les vérifications topologiques manuelles.
Sources
FAQ
Qu'est-ce qu'Archify et quel problème majeur résout-il dans la génération de diagrammes par IA ?
Archify est une compétence d'agent IA qui transforme les bases de code en diagrammes d'architecture vérifiables. Il résout le problème de l'IA qui fabrique des topologies non traçables et non vérifiables.
Quel est l'avantage clé d'Archify et son impact sur les revues d'architecture ?
Sa force réside dans la représentation intermédiaire JSON typée et la compilation déterministe, garantissant la vérifiabilité et la traçabilité des diagrammes. Cela rend les changements d'architecture auditables.
Quelles sont les évolutions futures ou les aspects à surveiller pour Archify ?
Il faudra observer si les reçus de validation deviennent des preuves standards, comment la comparaison des rôles sémantiques réduit les coûts de communication et son adoption par les processus CI/agents.