Archify : l’open source qui transforme vos bases de code en architecture visuelle (Cursor, Claude Code)
Quand vous travaillez sur un système complexe — 200 microservices, 5 frontends, 3 data pipelines — le plus dur n’est jamais pas d’écrire la suite. C’est d’expliquer ce qui existe déjà à quelqu’un qui débarque. Et malgré tous les progrès des LLMs sur le code, générer une vue d’ensemble correcte reste un échec patent : les agents peuvent placer les nœuds, mais le rendu final est rarement lisible.
C’est précisément le problème qu’attaque Archify, l’open source repo qui a décroché le GitHub Trending #1 le 28 août 2026 (visible sur le Reel Instagram de justinmendez.ai). On a creusé, et c’est plus intéressant qu’un simple outil de visualisation.
Le vrai problème : les agents produisent du code, mais pas de la carte
On le voit tous les jours chez Beemm : les clients qui utilisent Cursor, Claude Code ou Codex CLI peuvent faire générer du code, mais galèrent à maintenir une vue d’ensemble de leur système. Pourquoi ? Parce que les LLMs excellent à raisonner localement (une fonction, un fichier, un module) mais échouent sur la spatialisation — le rendu géométrique d’un graphe qui doit être lisible.
Les symptômes sont toujours les mêmes :
- Diagrammes avec 50 boîtes empilées sans hiérarchie visuelle
- Arêtes qui se croisent dans tous les sens
- Aucune indication de ce qui est critique vs vs ce qui est périphérique
- Couleurs et icônes incohérentes entre les vues
Archify propose de régler ça en partant d’une approche opposée aux solutions “drag and drop draw.io”. Pas de canvas manuel. On décrit le système en langage naturel (ou via l’agent de codage), et Archify produit une architecture visuelle typée, validée, rendue de manière déterministe.
Comment Archify marche (le truc technique important)
Le pipeline est en 3 étapes :
1. Interprétation typée par l’agent
L’agent (Cursor, Claude Code, Codex CLI ou OpenCode) lit le codebase ou la description textuelle du système, puis produit un JSON IR (Intermediate Representation) typé. Pas de SVG, pas de HTML en sortie directe — du JSON structuré qui décrit les nœuds, les arêtes, les groupes, les annotations.
2. Compilation déterministe par Archify
À partir du JSON IR, Archify génère du HTML/SVG statique de manière déterministe (même input = même output). C’est crucial : ça veut dire que vous pouvez versionner vos diagrammes dans Git, faire de la review de PR sur une architecture, et rollback si quelqu’un casse le rendu.
3. Rendu interactif
Le HTML/SVG final est servi comme une page web interactive : pan, zoom, navigation entre les nœuds, dark/light mode, brand marks customisables.
L’outil supporte 5 types de diagrammes (architecture système, data flow, sequence, dependency graph, deployment map) et 4 presets (overview, focus, technical, executive) pour adapter le rendu à votre audience.
Pourquoi on le recommande chez Beemm
Trois raisons concrètes :
1. Ça matche notre stack agence
Chez Beemm on a déjà adopté Cursor + Claude Code pour développer nos SaaS (BeeMM Enhancer, beemmvision.com, photobeemm.com). Avant Archify, on documentait nos archis sur des Notion rébarbatifs ou des draw.io partagés. Maintenant on génère la doc d’archi à chaque PR majeure. Le gain de temps sur les onboardings est mesurable (~30% plus rapide sur nos 2 derniers recrutements).
2. L’open source change la donne vs Mermaid ou draw.io
Mermaid est génial pour des diagrammes rapides mais plante sur les graphes >30 nœuds. Draw.io demande trop de maintenance manuelle. Archify prend le meilleur des deux : déclaratif comme Mermaid (l’agent écrit le JSON IR), rendu riche comme draw.io (interactive HTML/SVG).
3. Le typage strict évite les hallucinations visuelles
Les LLMs sont notoirement mauvais sur la spatialisation. En imposant un JSON IR typé, Archify force l’agent à décomposer le problème : d’abord identifier les composants et leurs relations (logique), puis les rendre géométriquement (visuel). Cette séparation réduit drastiquement les rendus absurdes.
Limites connues (à connaître avant d’adopter)
- Coût en tokens : générer le JSON IR via un agent consomme pas mal de tokens sur les très gros codebases (un user Reddit note “10x time and loops to fix itself” — voir les commentaires du Reel). Sur un projet de 100k+ lignes, ça peut chiffrer.
- Pas de live update : le diagramme est généré à un instant T, pas synchronisé en temps réel avec le code. Faut regénérer manuellement ou via un hook Git.
- Pas de collaboration simultanée : contrairement à Figma ou Excalidraw, on édite pas à plusieurs sur le même canvas. C’est un outil one-shot, pas un whiteboard.
L’avis d’un utilisateur dans les commentaires du Reel
Un commentaire du Reel Instagram résume bien le retour terrain :
“Archify not worth it. Because it takes a lot of tokens plus take 10x time and loops to fix itself continuously before generating for the 1st time. Currently connecting eraser.io with claude mcp works for me.”
Donc oui, c’est pas magique. Mais pour des diagrammes finaux d’archi qu’on veut versionner et partager, c’est une alternative crédible aux outils existants.
Comment Beemm intègre ça dans ses projets SaaS
Pour nos clients qui développent des produits complexes (typiquement scale-ups tech qui ont dépassé le stade MVP), on installe systématiquement :
- Un hook Git post-merge qui déclenche une regénération automatique du diagramme d’archi
- Une page
/architecture dans leur admin qui affiche le SVG statique
- Une convention “diagrams as code” : tout changement d’archi doit passer par une PR qui modifie le JSON IR
Pour les clients qui n’ont pas l’équipe pour maintenir ça, on le fait pour eux dans le cadre de notre offre SaaS (beemm.io/saas/).
Verdict
Archify n’est pas pour tout le monde. Si votre archi tient sur un post-it, pas la peine. Si vous galérez à onboarder des nouveaux devs ou à expliquer votre système à des stakeholders, c’est une option sérieuse à évaluer.
On l’a ajouté à notre stack interne et à notre catalogue de recommandations pour les clients SaaS. Pas de lock-in (c’est open source MIT), pas de coût récurrent, juste un investissement initial pour configurer le pipeline.
Sources : GitHub Trending 28 août 2026, Reel Instagram @justinmendez.ai (DclksZuoDtx), repo GitHub plainenglish/archify. Article écrit par l’équipe Beemm — usage interne validé sur BeeMM Enhancer et beemmvision.com.
