Archify : transformer une description en anglais en diagramme d’architecture vérifiable

TL;DR — Archify en une minute

• Ce que c’est : Archify (skill open source MIT, ~42k étoiles), un skill pour Claude Code (et Cursor, Codex, OpenCode) qui transforme une description en anglais en diagramme — archi, workflow, séquence, data-flow, lifecycle.
• Le vrai plus vs un mermaid : un IR JSON typé + validation (layout, routage, clearances) → des diagrammes vérifiables et propres, pas l’à-peu-près qui casse à la première modif.
• Itération en langage naturel (« ajoute Redis », « déplace l’auth à gauche ») sans casser le reste ; export PNG/SVG/WebM + share cards.
• Ce que ce n’est PAS : un audit de sécurité. Il dessine ton intention de design, il n’inspecte pas ton système live.
• Notre verdict : à tester — excellent pour documenter/partager une archi, si tu diagrammes souvent.

« Décris ton système en anglais, obtiens un diagramme d’architecture en secondes. » Séduisant — mais Claude sait déjà te pondre un mermaid. Alors qu’est-ce qu’Archify (42k étoiles, #1 du Trending GitHub) ajoute vraiment ? Réponse : la rigueur. Et non, ça ne « sécurise » pas tes projets — on va être clairs là-dessus.

Ce que fait Archify

• Un skill (installation : npx skills add tt-a1i/archify -g) pour Claude Code, Cursor, Codex, OpenCode.
• Tu décris en anglais ; il génère 5 types de diagrammes : architecture (composants, services, trust boundaries), workflow (CI/CD, approbations), séquence (appels API, auth), data-flow (pipelines, PII), lifecycle (états, retries).
• Export PNG (presse-papier/fichier), SVG (print), WebM (animation), share cards 1200×630 pour tes README.
• Local, MIT, pas de clé API payante.

Le vrai plus vs « demande un mermaid à Claude »

C’est LA question. Un mermaid, Claude t’en fait un en 2 secondes — mais c’est souvent approximatif, incohérent, et ça casse dès que tu veux modifier un bout. Archify ajoute la rigueur :

• IR JSON typé : l’agent génère un JSON structuré conforme à un schéma.
• Validation avant rendu : règles de layout, correction du routage, « clearance checks ». Si c’est faux, tu reçois un guide de réparation lisible par la machine, pas une erreur cryptique. Seul un artefact vérifié remplace le précédent.
• Itération non destructive : « ajoute une couche Redis », « surligne le chemin de rollback » — chaque changement est précis et ne casse pas le reste.

Résultat : des diagrammes publiables, pas des brouillons.

L’angle honnête : ce n’est PAS de la sécu

La vidéo qui circule vend ça comme un « skill pour sécuriser tes projets ». Faux. Le repo lui-même le dit : *« diagramming tool, not infrastructure scanner »* — il visualise ton intention de design, il n’inspecte pas ton système en prod, ne détecte aucune vulnérabilité, ne déduit pas le comportement runtime.

Ce qui est vrai : bien voir son archi aide à repérer des trous (un service exposé, une donnée PII qui traverse une zone sensible). Mais c’est toi (ou Claude) qui raisonne — Archify dessine, il n’audite pas. Ne confonds pas « comprendre » et « sécuriser ».

Pour qui c’est vraiment utile

• Tu documentes une archi (README, onboarding, specs) et tu veux des schémas propres, cohérents, à jour : gros gain de temps.
• Tu bosses avec Claude Code sur du multi-services (Supabase + Netlify Functions + Edge) : visualiser le flux aide à raisonner et à partager.
• Tu veux partager une archi (client, associé, doc) : les exports SVG/PNG/share cards sont faits pour ça.

À l’inverse : si tu fais un schéma une fois par trimestre, un mermaid vite fait suffit — Archify brille quand tu diagrammes souvent et que tu itères.

Notre verdict : à tester

Archify répond bien à la question « pourquoi pas un simple mermaid » : la rigueur (JSON typé + validation), l’itération non destructive, et des exports publiables. Pour qui documente et partage des archis régulièrement, c’est un vrai cran au-dessus du diagramme jetable. Skill, MIT, local, sans clé payante — le coût d’essai est nul.

Les deux choses à garder en tête : ce n’est pas un outil de sécurité (juste du diagramme), et c’est un skill de plus — installe-le si tu diagrammes vraiment souvent, pas par réflexe collectionneur (la règle anti-scope-creep vaut aussi ici).

Points de vigilance

• Ce n’est PAS de la sécu : Archify dessine ton intention, il n’inspecte pas le système live ni ne détecte de faille.
• Skill de plus : utile SI tu diagrammes souvent (sinon un mermaid suffit).
• Version dev (v2.17) : quelques aspérités à prévoir.
• Le layout dépend de l’agent : Archify valide, mais c’est Claude qui décide la hiérarchie et l’emphase — pas d’auto-layout magique, pas d’éditeur WYSIWYG.