Architecture assistée par l'IA

La documentation d’architecture perd sa valeur dès qu’elle se déconnecte du code qu’elle décrit. Cette conférence présente le principe du Doc as Code : maintenir la documentation d’architecture — modèles C4, Architecture Decision Records, diagrammes — au plus près du code, versionnée avec lui, et vérifiée par des tests automatisés au même titre que le reste du système.

Nous verrons ensuite comment l’IA générative peut soutenir ce processus sans en devenir la source de vérité : un cadrage explicite du LLM par des règles de projet, des agents et des skills réutilisables, organisés dans une boucle agentic qui va du changement de code jusqu’à la mise à jour de la documentation, en passant par la validation automatisée des règles d’architecture et la revue humaine.

La démarche présentée est indépendante du framework d’IA utilisé : les principes s’appliquent quel que soit l’outil retenu par l’équipe.

Une démonstration live illustrera l’ensemble du cycle : une violation d’architecture détectée par un test automatisé, un agent proposant un correctif accompagné d’un ADR et d’un diagramme mis à jour, jusqu’à la pull request prête pour revue humaine.

Sujets abordés

• Doc as Code : principes et bénéfices
• Modèles C4
• Architecture Decision Records
• Diagrammes d’architecture as code et outillage associé
• Tests d’architecture automatisés (ArchUnit et équivalents)
• Cadrage d’un LLM par des règles de projet, agnostique du framework
• Agents et skills réutilisables
• Boucle agentic : du code à la documentation, et retour
• Démonstration live du cycle complet

Ce que le public repart avec

• Une méthode reproductible, indépendante de l’outil IA choisi
• Des points de vigilance sur les limites et la gouvernance du processus
• Des références d’outils concrets à tester dans son équipe