Cet outil permet de générer des diagrammes d'architecture système esthétiques et thématiques sombres sous forme de fichiers HTML/SVG autonomes, directement via une compétence pour l'IA Claude. Il suffit de décrire son architecture en langage naturel pour obtenir un diagramme professionnel en quelques secondes, sans compétences en design ni logiciel spécifique.
L'installation repose sur trois étapes simples : télécharger un fichier ZIP, l'importer dans les paramètres des compétences de Claude (nécessitant un abonnement Pro ou supérieur), puis décrire son architecture via une analyse automatique de codebase, une rédaction manuelle ou une demande de modèle générique. L'IA produit ensuite un fichier HTML prêt à l'emploi, modifiable à la volée par des instructions en conversation.
Le projet propose des exemples concrets pour des cas d'usage variés (applications web, architectures serverless AWS ou microservices) et permet des itérations rapides en ajustant la description initiale. Les fichiers générés sont partageables et compatibles avec tout navigateur.
L'article met en lumière les erreurs fréquentes commises lors de la création de diagrammes d'architecture technique. Parmi celles-ci, on trouve la réalisation de diagrammes théoriques plutôt que concrets, le mélange de niveaux d'abstraction, la surcharge d'informations, l'utilisation de flèches non étiquetées, des compositions trompeuses, l'absence de contexte, et le manque de texte explicatif accompagnant les diagrammes. Pour éviter ces écueils, il est recommandé de se concentrer sur des représentations spécifiques et claires, de séparer les niveaux d'abstraction, de réduire le nombre de préoccupations simultanées, d'étiqueter les relations, de fournir un contexte adéquat, et d'accompagner les diagrammes de descriptions détaillées.
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Un outil pour créer des diagrammes (UML, Gantt) à partir de fichiers textes