Arriver sur un projet de 200 000 lignes de code sans savoir par où commencer est une situation que beaucoup de développeurs connaissent. Understand Anything propose une approche différente : au lieu de parcourir le code fichier après fichier, l’outil construit une représentation visuelle de l’architecture du projet.
Ce projet open source utilise une pipeline composée de plusieurs agents IA pour analyser le codebase et construire un graphe de connaissances reliant les différents éléments du projet.
L’objectif n’est pas simplement de produire un joli diagramme. Le graphe doit permettre de comprendre comment les différentes parties du logiciel fonctionnent ensemble.
Une carte du code plutôt qu’une simple liste de fichiers
Understand Anything analyse notamment les fichiers, fonctions, classes et dépendances afin de construire un graphe de connaissances interactif.
Chaque élément devient un nœud que l’on peut explorer. Les relations entre les différents composants permettent ensuite de visualiser la structure du projet et de comprendre les dépendances entre ses différentes parties.
Le dashboard permet de naviguer dans cette représentation, de rechercher des éléments et d’obtenir des explications en langage naturel.
Demander directement à l’IA comment fonctionne le projet
L’un des aspects les plus intéressants est la possibilité de poser des questions directement sur le codebase.
Vous pouvez par exemple chercher les composants qui gèrent l’authentification ou demander comment fonctionne un flux de paiement. L’outil propose une recherche floue et sémantique, ce qui permet de rechercher une idée plutôt qu’un simple nom de fichier.
Il est également possible d’expliquer en profondeur un fichier ou une fonction particulière, ou encore de générer un parcours de découverte destiné à une personne qui rejoint l’équipe.
Un véritable outil d’onboarding
Comprendre un nouveau projet ne consiste pas uniquement à savoir où se trouvent les fichiers. Il faut également comprendre l’architecture et l’ordre dans lequel les différents composants interviennent.
Understand Anything propose justement des visites guidées de l’architecture, organisées en fonction des dépendances. L’objectif est d’aider un nouveau développeur à découvrir progressivement le fonctionnement du projet.
L’outil peut également visualiser différentes couches architecturales, comme l’API, les services, les données ou l’interface utilisateur.
Il ne se limite pas à comprendre le code
Understand Anything propose également une vue orientée logique métier. Celle-ci permet de représenter les domaines, les flux et les différentes étapes d’un processus.
Le projet peut aussi analyser certaines bases de connaissances et transformer leur contenu en graphe navigable. Cela élargit l’utilisation de l’outil au-delà du simple code source.
Et si le projet évolue ?
L’analyse n’a pas besoin d’être entièrement recommencée à chaque modification. Après l’analyse initiale, Understand Anything fonctionne de manière incrémentale par défaut et réanalyse uniquement les fichiers qui ont changé.
Il est également possible d’analyser l’impact des modifications actuelles afin de visualiser les différentes parties du système susceptibles d’être affectées avant de valider les changements.
Pensé pour les nouveaux outils de développement assisté par IA
Le projet est particulièrement intéressant dans le contexte actuel du développement assisté par IA. Understand Anything est compatible avec plusieurs environnements de coding agents, notamment Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI et OpenCode, entre autres.
Cette compatibilité permet de l’intégrer directement dans des workflows où l’IA participe déjà à l’écriture, la modification ou l’analyse du code.
Une précision importante sur l’analyse initiale
À savoir : la première analyse porte sur l’ensemble du codebase et peut consommer une quantité importante de tokens sur les projets volumineux. Le projet recommande notamment l’utilisation d’un abonnement adapté ou d’un modèle local pour cette phase. Les analyses suivantes sont incrémentales.
Un outil intéressant pour les gros projets
Pour un développeur qui découvre une nouvelle base de code, un responsable technique qui souhaite améliorer l’onboarding ou un chercheur qui analyse un projet open source, l’approche est particulièrement intéressante.
Understand Anything ne remplace pas la lecture du code : il cherche plutôt à donner une carte pour savoir où regarder, dans quel ordre et comment les différents composants sont reliés.
Et lorsqu’un projet devient suffisamment complexe pour que son architecture ne puisse plus être comprise simplement en parcourant quelques fichiers, disposer d’une représentation interactive peut devenir un véritable gain de temps.
