Cet outil IA cartographie n'importe quel codebase avant même d'y toucher (Comprenez tout)

Françaisالعربية Deutsch English Español हिन्दी Bahasa Indonesia 日本語 한국어 Русский 中文

Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00Vous rejoignez une nouvelle équipe, vous clonez le dépôt et vous ouvrez la base de code.

00:00:04Et voilà, une base de code de 200 000 lignes qui vous regarde comme un lapin pris dans les phares.

00:00:09Alors, vous faites ce que tout développeur fait.

00:00:11Vous utilisez grep, on saute entre les fichiers, et on demande probablement à Claude d'expliquer ce dépôt.

00:00:17Et si vous aviez une carte, une vraie carte interactive qui vous apprend la base de code ?

00:00:22Flux, couches d'architecture, changements, impacts, c'est “Understand Anything”.

00:00:27Il a déjà dépassé les 14 000 étoiles sur GitHub en quelques semaines, et beaucoup de développeurs en parlent.

00:00:32à son sujet.

00:00:33Dans la minute qui suit, je vais vous montrer comment ça marche et comment cela va immensément accélérer

00:00:36votre compréhension de votre base de code.

00:00:44Understand Anything est un plugin open source pour Claude Code.

00:00:47Il peut aussi s'intégrer dans des flux de travail avec des outils comme Cursor, Copilot et Gemini CLI.

00:00:53Vous le pointez vers un dépôt ou même une base de connaissances, et il transforme ce projet en un graphe

00:00:58de connaissances interactif et interrogeable.

00:01:00Il fait cela avec de l'analyse statique et un traitement LLM multi-agents.

00:01:05Mais le plus important n'est pas la pile technologique.

00:01:07Le plus important, c'est le problème qu'il résout réellement, car chaque développeur a déjà connu ce problème.

00:01:13Vous êtes nouveau sur une sorte de base de code héritée, une application héritée.

00:01:16La documentation est obsolète.

00:01:18L'ingénieur qui savait tout est parti il y a six mois.

00:01:22Et votre agent de codage IA ne fait que deviner encore et encore.

00:01:26C'est là que cet outil devient vraiment utile.

00:01:28Alors, lançons-le.

00:01:29Si vous aimez les outils de codage pour accélérer votre flux de travail, assurez-vous de vous abonner.

00:01:33Nous publions des vidéos tout le temps.

00:01:35Voici un projet de taille moyenne.

00:01:36Il est assez grand pour être vraiment ennuyeux, mais assez petit pour que je puisse vous montrer à quel point

00:01:40c'est cool.

00:01:42C'est juste un dépôt que j'ai cloné à partir de microservices Google, et il est assez petit pour que nous puissions

00:01:46tester cela sans avoir à faire semblant de quoi que ce soit.

00:01:49D'abord, je vais installer le plugin, juste ici dans Claude, avec la commande plugin install, understand

00:01:54anything.

00:01:55Une fois généré, nous devons recharger les plugins, bien sûr, et ensuite nous devons juste

00:01:58exécuter understand.

00:02:00Maintenant, il va scanner tout le dépôt.

00:02:03Il en extrait la structure, les relations, les modules clés et probablement les concepts métier.

00:02:09Maintenant, nous pouvons exécuter la commande dashboard pour tout lancer.

00:02:11Tout d'abord, cela a pris une éternité, genre 30 minutes, et ça a brûlé un paquet de jetons.

00:02:16Donc, avoir un bon forfait Claude est indispensable.

00:02:19J'ai Claude Max, et cela a utilisé 25% de ma limite, donc ça consomme et ça consomme vite.

00:02:24Mais une fois que c'est fait, nous pouvons ouvrir ce tableau de bord, et c'est la partie vraiment cool qui

00:02:29marque les esprits.

00:02:30Je peux faire un zoom arrière et voir l'architecture de haut niveau.

00:02:32Je peux zoomer et accéder aux parties internes.

00:02:35Je peux cliquer pour voir la répartition du code et comment tout ce code est connecté.

00:02:40Je peux même cliquer et voir le code lui-même.

00:02:43Ensuite, je peux chercher quelque chose ici, comme les paiements.

00:02:46Normalement, je sauterais entre les routes, les services, les modèles, les gestionnaires, juste des docs

00:02:52qui ne sont même plus utiles, et ici, les outils rassemblent les pièces.

00:02:56Maintenant, je peux cliquer sur “guided tour” (visite guidée), et cela parcourt le flux dans l'ordre.

00:03:01Le point d'entrée, la validation, la logique, la base de données, les API externes, la gestion des erreurs.

00:03:07C'est déjà très utile.

00:03:09Cette visite guidée décompose tout.

00:03:11Nous pouvons entrer dedans, accéder aux différents composants.

00:03:14C'est la différence entre “Hé, c'est un graphique vraiment cool” et “Je vérifierais réellement

00:03:18cela avant de toucher au code de production.”

00:03:20Mais maintenant, la question évidente est : n'avons-nous pas déjà des outils comme celui-ci ?

00:03:25En tant que développeurs, nous n'avons pas vraiment besoin de plus de jolis tableaux de bord.

00:03:29Nous avons besoin de moins de temps perdu, et cet outil s'attaque à l'un des plus grands gouffres à temps du logiciel.

00:03:35Obtenir du contexte, n'est-ce pas ?

00:03:37Où tout cela est-il connecté ?

00:03:38Comment est-ce utile ?

00:03:39Les gens le testent sur de grands projets, des monolithes Java hérités, des dépôts de microservices, des centaines

00:03:45de fichiers, et la réaction est un peu ce que j'ai obtenu ici.

00:03:48Cela m'aurait sauvé mes deux premières semaines dans le travail car il décompose tout,

00:03:53il connecte tout, et il nous montre comment c'est entrelacé.

00:03:56C'est le premier très gros cas d'utilisation : l'intégration (onboarding).

00:03:58Donc, au lieu de dire : “Lisez ces 12 pages et demandez autour si quelque chose est confus”, c'est déjà

00:04:03confus, nous pouvons maintenant dire : “Ouvrez le graphique, faites la visite, puis nous pourrons poser de meilleures

00:04:08questions.”

00:04:09Maintenant, le deuxième très bon cas d'utilisation concerne les agents IA, car la plupart des outils de codage

00:04:14IA ne sont bons qu'en fonction du contexte que nous leur donnons.

00:04:17Si l'agent voit trois fichiers, il va juste deviner.

00:04:20S'il a une carte structurée du système avec des domaines, des flux, des dépendances et des explications réelles,

00:04:27il a plus de chances de faire le bon changement dès le départ.

00:04:30Ensuite, bien sûr, il y a la refactorisation, n'est-ce pas ?

00:04:32Avant de toucher au code, nous pouvons maintenant demander : “De quoi dépend ce code ?

00:04:36À quel flux appartient-il ?

00:04:38Qu'est-ce qui pourrait casser si ça bouge ?”

00:04:40C'est comme ça qu'on évite de transformer un changement d'une ligne en un événement majeur.

00:04:44Et c'est la vraie raison pour laquelle les développeurs sont assez enthousiastes à propos de ce projet.

00:04:48Pas parce qu'on se soucie des diagrammes, j'aime les diagrammes, d'accord ?

00:04:51Ils sont cool, ils sont utiles, je suis visuel, mais on déteste être perdu.

00:04:55Maintenant, c'est là qu'il faut être prudent, car les développeurs ont déjà vu des outils de visualisation de code.

00:05:00Les graphes IDE, la navigation de style Sourcegraph, les graphes NX, les visualiseurs Tree-sitter, et beaucoup

00:05:05d'entre eux ont exactement le même problème.

00:05:09Que font-ils ?

00:05:10Ils montrent la structure, mais ils n'expliquent pas la signification réelle.

00:05:13Ils vous disent que ce fichier importe ce fichier, super, mais pourquoi ?

00:05:18De quel flux fait-il partie ?

00:05:19Où commence la requête ?

00:05:20Qu'est-ce qui casse si je le change ?

00:05:22C'est la couche manquante.

00:05:24Understand Anything essaie d'ajouter cette couche.

00:05:27Au lieu de montrer seulement un fichier TypeScript ou autre, il essaie de se transformer en quelque chose

00:05:31plus proche d'un flux réel de la façon dont les choses fonctionnent.

00:05:35C'est la grande chose ici.

00:05:37Des fichiers à la signification, des importations au comportement du système, d'ici sont les pièces, à voici

00:05:42comment la machine fonctionne.

00:05:43Comparé à de nombreux outils de code LLM ou RAG, il est aussi plus visuel et plus enseignable.

00:05:48Beaucoup d'outils de code IA ne sont essentiellement que des boîtes de recherche.

00:05:52Vous posez une question, vous obtenez une réponse.

00:05:54Cela vous donne une répartition complète, nous aidant à comprendre où tout va, ce qui est

00:06:00entrelacé, comment c'est connecté, tout en nous permettant de voir réellement le code.

00:06:04Maintenant parlons de ce que les gens aiment vraiment.

00:06:05La victoire évidente ici était l'intégration (onboarding).

00:06:07Si vous rejoignez une grande base de code, cela vous donne un bon point de départ.

00:06:12Aussi les couches d'architecture, n'est-ce pas ?

00:06:13Celles-ci sont vraiment bien construites.

00:06:15Vous pouvez commencer au niveau du système puis descendre dans les modules et les détails d'implémentation.

00:06:20L'impact des différences est un autre grand point.

00:06:21Chaque développeur expérimenté connaît la peur de faire un minuscule changement dans une base de code qu'ils ne comprennent

00:06:23pas encore réellement.

00:06:27Pour les utilisateurs de Claude Code, le graphique peut aussi devenir un meilleur contexte,

00:06:29donc au lieu de vider des fichiers aléatoires dans un prompt, vous donnez à l'agent des connaissances d'architecture structurées.

00:06:34C'est aussi gratuit, sous licence MIT, incrémental et conçu pour fonctionner à travers plusieurs environnements de développement.

00:06:39Maintenant, du côté sceptique, quand un projet explose aussi rapidement, on commence à poser la question,

00:06:45est-ce utile ou a-t-il juste gagné l'algorithme GitHub ?

00:06:49C'est une bonne question à poser.

00:06:53Il y a aussi les dépendances LLM, cela signifie le coût des jetons.

00:06:55Cela a explosé sur les coûts en jetons.

00:06:59Cela a pris du temps, ça a pris beaucoup de jetons.

00:07:02Assurez-vous d'avoir un bon forfait si vous comptez utiliser ceci.

00:07:05Vous avez toujours besoin d'un bon jugement.

00:07:08Cela vous donne juste cet aperçu.

00:07:09Cela ne remplace pas la lecture du code.

00:07:11Cela vous aide juste à mieux le comprendre là où tout va.

00:07:13Si vous appréciez les outils et astuces de codage comme celui-ci, assurez-vous de vous abonner à la chaîne Better Stack.

00:07:16On se voit dans une autre vidéo.

00:07:20à bientôt.

Key Takeaway

Understand Anything accelerates developer onboarding and system refactoring by transforming static codebases into interactive, flow-based knowledge graphs that provide context on how components behave rather than just where they reside.

Highlights

Understand Anything maps codebases into interactive, queryable knowledge graphs using static analysis and multi-agent LLM processing.
The tool accumulated over 14,000 stars on GitHub within a few weeks of its launch.
Scanning a medium-sized project can take approximately 30 minutes and consume significant token limits, requiring a high-capacity Claude subscription.
The guided tour feature visually maps execution flows from entry points through validation, logic, database interaction, and external API calls.
Unlike standard visualization tools that only show file structures, this plugin explains the functional significance and interdependencies of code components.

Timeline

Le problème de la compréhension des bases de code

Les outils traditionnels comme grep et la lecture manuelle ralentissent l'intégration sur de nouvelles bases de code.
La documentation obsolète et le départ des ingénieurs clés compliquent la compréhension des systèmes hérités.

L'analyse d'une nouvelle base de code de 200 000 lignes repose souvent sur des méthodes fragmentées. Les agents de codage IA classiques manquent de contexte global, ce qui les conduit à formuler des suppositions imprécises.

Fonctionnement et installation de Understand Anything

L'outil s'installe en tant que plugin open source pour Claude Code avec la commande plugin install understand anything.
Le processus utilise l'analyse statique et un traitement LLM multi-agents pour générer une carte interactive du dépôt.
L'exécution initiale nécessite environ 30 minutes de traitement et une consommation importante de jetons LLM.

Après l'installation et l'exécution de la commande dashboard, le système extrait la structure, les relations entre modules et les concepts métier. Il est recommandé de disposer d'un forfait Claude de capacité maximale, car l'analyse peut consommer jusqu'à 25 % d'une limite d'utilisation sur un projet moyen.

Utilisation pratique et cas d'usage

La visite guidée (guided tour) permet de visualiser le flux logique d'une requête, incluant validation, base de données et erreurs.
Le graphique sert de contexte structuré pour les agents IA afin d'améliorer la précision des modifications proposées.
L'outil aide à identifier les dépendances avant la refactorisation pour éviter de briser des fonctionnalités en production.

L'interface permet de zoomer de l'architecture de haut niveau jusqu'au code source. Cette visualisation permet de passer d'une simple observation de graphique à une vérification réelle du fonctionnement du système avant toute modification.

Différenciation des outils de visualisation

La plupart des visualiseurs existants montrent la structure des imports mais échouent à expliquer le comportement du système.
Understand Anything ajoute une couche de signification en reliant les fichiers au comportement métier réel.
L'outil reste un complément à la lecture du code et ne remplace pas le jugement critique de l'ingénieur.

Contrairement aux graphes IDE ou Tree-sitter, Understand Anything met l'accent sur les flux de fonctionnement plutôt que sur les liens statiques. Bien que l'outil aide à comprendre les entrelacements complexes, une utilisation prudente reste nécessaire en raison des coûts de jetons et de la nécessité de vérifier les résultats.

Community Posts

No posts yet. Be the first to write about this video!

Write about this video