Archify

C'EST QUOI ?

Archify est une skill pour agents de code (Claude Code, Codex CLI, Cursor, OpenCode) qui transforme une description de système ou un repo en diagramme interactif. L'agent ne dessine pas le SVG lui-même : il écrit une source JSON typée, qu'Archify valide puis compile de façon déterministe en un fichier HTML autonome. Cinq types de diagrammes sont couverts : architecture, workflow, séquence, flux de données et cycle de vie. Il n'y a pas d'éditeur WYSIWYG : le diagramme se modifie en le demandant à l'agent (« ajoute Redis », « mets l'auth à gauche »). L'installation passe par npx skills add tt-a1i/archify -g.

POURQUOI C'EST INTÉRESSANT ?

• Validation avant livraison : le schéma, la mise en page, le tracé des flèches et l'espace entre labels et liens sont vérifiés avant qu'un diagramme remplace la dernière version valide. En cas d'échec, validate --json renvoie un code de règle, l'élément en cause, la mesure relevée et les corrections supportées, que l'agent applique au lieu de relancer au hasard.
• Interactions fidèles à la source : recherche de nœuds, dépendances amont et aval, chemin entre deux composants, comparaison de rôles et stories guidées. Tout repose sur les relations déclarées dans le JSON, sans prétendre mesurer un impact au runtime. Chaque vue a un lien stable, par exemple #route=web~db.
• Revue d'architecture en PR : la commande compare confronte deux snapshots JSON validés et produit une vue Before / Delta / After qui liste les éléments ajoutés, supprimés, modifiés, déplacés ou re-routés.
• Preuves dans le code, sur demande : les nœuds d'un diagramme d'architecture peuvent renvoyer aux fichiers et plages de lignes correspondants, vérifiés par Git et figés sur un commit public. Les diagrammes ordinaires restent sans référence au code.
• Un fichier, plusieurs exports : le résultat est un HTML autonome avec thème clair ou sombre, quatre presets visuels et un mode présentation. Le menu Export produit du PNG, du SVG, du WebM et des cartes de partage 1200×630, y compris pour un chemin précis tracé dans le diagramme. Un mode preview local surveille le fichier JSON et ne recharge le rendu qu'après validation.

CAS D'USAGE

• Cartographier l'architecture runtime d'un repo inconnu en demandant à l'agent les composants principaux, le chemin critique et les frontières de confiance.
• Joindre une vue Before / Delta / After à une pull request qui touche à l'architecture.
• Documenter un appel API avec cache miss en diagramme de séquence, ou un pipeline Kafka avec DLQ en diagramme de flux de données.
• Présenter un système en réunion avec le mode présentation et une story guidée chapitre par chapitre.
• Illustrer un README ou une note de release avec une carte de partage 1200×630 générée depuis le diagramme.