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

BBetter Stack
컎퓚터/소프튞웚얎찜업/슀타튞업AI/ëŻžëž˜êž°ìˆ 

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