Esta herramienta de IA mapea cualquier base de código antes de que la toques (Understand-Anything)
BBetter Stack
컴퓨터/소프트웨어창업/스타트업AI/미래기술
Transcript
00:00:00Te unes a un nuevo equipo, clonas el repositorio y abres la base de código.
00:00:04Y ahí está, una base de código de 200,000 líneas mirándote como un ciervo ante los faros.
00:00:09Así que haces lo que hace todo desarrollador.
00:00:11Usas grep, saltamos entre archivos y probablemente le pedimos a Claude que explique este repo.
00:00:17¿Qué pasaría si tuvieras un mapa, un mapa interactivo real que te enseñe la base de código?
00:00:22Flujos, capas de arquitectura, cambios, impacto; esto es “understand anything”.
00:00:27Ya ha superado las 14,000 estrellas en GitHub en semanas, y muchos desarrolladores han estado hablando
00:00:32de ello.
00:00:33En el próximo minuto, les mostraré cómo funciona esto y cómo va a acelerar inmensamente
00:00:36su comprensión de su base de código.
00:00:44“Understand anything” es un plugin de código abierto para Claude.
00:00:47También puede encajar en flujos de trabajo con herramientas como Cursor, Copilot y Gemini CLI.
00:00:53Lo apuntas a un repositorio e incluso a una base de conocimientos, y convierte ese proyecto en un grafo de
00:00:58conocimiento interactivo y consultable.
00:01:00Lo hace mediante análisis estático más procesamiento de LLM multi-agente.
00:01:05Pero la parte importante no es la pila tecnológica.
00:01:07La parte importante es el problema que realmente resuelve, porque todo desarrollador ha tenido este problema.
00:01:13Eres nuevo en algún tipo de base de código heredada, una aplicación heredada.
00:01:16La documentación está desactualizada.
00:01:18El ingeniero que sabía todo se fue hace seis meses.
00:01:22Y tu agente de programación IA sigue adivinando una y otra vez.
00:01:26Ahí es donde esta herramienta se vuelve realmente útil.
00:01:28Así que ejecutémosla.
00:01:29Si disfrutas de herramientas de programación para acelerar tu flujo de trabajo, asegúrate de suscribirte.
00:01:33Tenemos videos saliendo todo el tiempo.
00:01:35Ahora aquí hay un proyecto de tamaño mediano.
00:01:36Es lo suficientemente grande como para ser realmente molesto, pero lo suficientemente pequeño como para que pueda mostrarles
00:01:40lo genial que es esto.
00:01:42Es solo un repositorio que cloné de microservicios de Google, y es lo suficientemente pequeño como para que podamos probar
00:01:46esto sin tener que fingir nada.
00:01:49Primero, voy a instalar el plugin, aquí mismo en Claude, “plugin install, understand anything”.
00:01:54listo.
00:01:55Una vez que esto se genere, necesitamos recargar los plugins, por supuesto, y luego solo tenemos
00:01:58que ejecutar “understand”.
00:02:00Ahora va a escanear todo el repositorio.
00:02:03Extrae la estructura, las relaciones, los módulos clave y probablemente conceptos de negocio.
00:02:09Ahora podemos ejecutar el comando “dashboard” para lanzarlo todo.
00:02:11Ahora bien, primero, esto tardó una eternidad en ejecutarse, como 30 minutos, y quemó una carga de tokens.
00:02:16Así que tener un buen plan de Claude es imprescindible.
00:02:19Tengo Claude Max, y esto usó el 25% de mi tarifa, así que quema y quema rápido.
00:02:24Pero una vez que termina, podemos abrir este panel, y esta es la parte realmente genial que realmente
00:02:29te llega al alma.
00:02:30Puedo alejarme y ver la arquitectura de alto nivel.
00:02:32Puedo acercarme y acceder a las partes internas.
00:02:35Puedo hacer clic para ver el desglose del código y cómo está conectado todo.
00:02:40Incluso puedo hacer clic y ver el código real en sí.
00:02:43Entonces puedo buscar algo aquí como “payments”.
00:02:46Normalmente estaría saltando entre rutas, servicios, modelos, manejadores, solo documentos
00:02:52que ni siquiera son útiles ya, y aquí las herramientas juntan las piezas.
00:02:56Ahora puedo hacer clic en “guided tour”, y recorre el flujo en orden.
00:03:01El punto de entrada, la validación, la lógica, la base de datos, las APIs externas, el manejo de errores.
00:03:07Eso ya es realmente útil.
00:03:09Esta visita guiada desglosa todo.
00:03:11Podemos entrar, acceder a los diferentes componentes.
00:03:14Esa es la diferencia entre: “Oye, este es un gráfico genial” y “realmente
00:03:18revisaría esto antes de tocar código de producción”.
00:03:20Pero ahora la pregunta obvia aquí es, ¿no tenemos ya herramientas como esta?
00:03:25Como desarrolladores, realmente no necesitamos más paneles bonitos.
00:03:29Necesitamos menos tiempo desperdiciado, y esta herramienta va tras uno de los mayores sumideros de tiempo en el software.
00:03:35Obtener contexto, ¿verdad?
00:03:37¿Dónde está todo esto conectado?
00:03:38¿Cómo es útil?
00:03:39La gente lo está probando en proyectos grandes, monolitos de Java heredados, repositorios de microservicios, cientos
00:03:45de archivos, y la reacción es más o menos la que obtuve aquí.
00:03:48Esto me habría salvado mis primeras dos semanas en el trabajo porque desglosa todo,
00:03:53conecta todo y nos muestra cómo está entrelazado.
00:03:56Ese es el primer caso de uso realmente grande: la incorporación (onboarding).
00:03:58Así que en lugar de decir: “Lee estas 12 páginas y pregunta si algo es confuso”, eso ya
00:04:03es confuso, ahora podemos decir: “Abre el gráfico, haz el recorrido, luego podemos hacer mejores
00:04:08preguntas”.
00:04:09Ahora, el segundo caso de uso realmente bueno son los agentes de IA, porque la mayoría de las herramientas de programación
00:04:14IA son solo tan buenas como el contexto que les damos.
00:04:17Si el agente ve tres archivos, solo va a adivinar.
00:04:20Si tiene un mapa estructurado del sistema con dominios, flujos, dependencias y explicaciones reales,
00:04:27tiene una mejor oportunidad de hacer el cambio correcto desde el principio.
00:04:30Luego, por supuesto, está la refactorización, ¿verdad?
00:04:32Antes de tocar el código, ahora podemos preguntar: “¿De qué depende este código?
00:04:36¿A qué flujo pertenece?
00:04:38¿Qué podría romperse si se mueve?”
00:04:40Así es como evitas convertir un cambio de una línea en un evento mayor.
00:04:44Y esta es la verdadera razón por la que los desarrolladores están bastante emocionados con este proyecto.
00:04:48No porque nos importen los diagramas, me gustan los diagramas, ¿verdad?
00:04:51Son geniales, son útiles, soy visual, pero odiamos estar perdidos.
00:04:55Ahora, aquí es donde debemos tener cuidado porque los desarrolladores han visto herramientas de visualización de código antes.
00:05:00Gráficos de IDE, navegación al estilo Sourcegraph, gráficos de NX, visualizadores de árboles, y muchos
00:05:05de ellos tienen exactamente el mismo problema.
00:05:09¿Qué hacen?
00:05:10Muestran la estructura, pero no explican el significado real.
00:05:13Te dicen que este archivo importa aquel archivo, genial, ¿pero por qué?
00:05:18¿De qué flujo es parte esto?
00:05:19¿Dónde comienza la solicitud?
00:05:20¿Qué se rompe si lo cambio?
00:05:22Esa es la capa que falta.
00:05:24“Understand anything” está tratando de agregar esa capa.
00:05:27En lugar de solo mostrar un archivo TypeScript o algo más, intenta convertirlo en algo
00:05:31más cercano a un flujo real de cómo funcionan las cosas.
00:05:35Esas son las grandes cosas aquí.
00:05:37De archivos a significado, de importaciones a comportamiento del sistema, de “aquí están las piezas” a “aquí
00:05:42está cómo funciona la máquina”.
00:05:43Comparado con muchas herramientas de código LLM o RAG, también es más visual y más enseñable.
00:05:48Muchas herramientas de código IA son básicamente solo cajas de búsqueda.
00:05:52Haces una pregunta, obtienes una respuesta.
00:05:54Esto te da un desglose completo, ayudándonos a entender a dónde va todo, qué está
00:06:00entrelazado, cómo está conectado, permitiéndonos ver realmente el código.
00:06:04Ahora hablemos de lo que a la gente realmente le gusta.
00:06:05La victoria obvia aquí fue la incorporación.
00:06:07Si te unes a una base de código grande, esto te da un buen punto de partida.
00:06:12También las capas de arquitectura, ¿verdad?
00:06:13Estas están realmente bien construidas.
00:06:15Puedes comenzar a nivel del sistema y luego profundizar en los módulos y detalles de
00:06:20implementación.
00:06:21El impacto de los “diffs” es otro importante.
00:06:23Todo desarrollador experimentado conoce el miedo de hacer un pequeño cambio en una base de código que en realidad
00:06:27no entiende todavía.
00:06:29Para los usuarios de Claude Code, el gráfico también puede convertirse en un mejor contexto, así que en lugar de volcar
00:06:34archivos aleatorios en un prompt, le das al agente conocimiento de arquitectura estructurado.
00:06:39También es gratis, con licencia MIT, incremental y diseñado para funcionar en múltiples entornos de desarrollo.
00:06:45Ahora, en el lado escéptico, cuando un proyecto explota tan rápido, empezamos a hacer la pregunta,
00:06:49¿es esto útil o simplemente ganó al algoritmo de GitHub?
00:06:53Esa es una buena pregunta para hacer.
00:06:55También están las dependencias de LLM, eso significa costo de tokens.
00:06:59Esto explotó en los costos de tokens.
00:07:02Entonces tomó un tiempo, tomó muchos tokens.
00:07:05Asegúrate de tener un buen plan si vas a usar esto.
00:07:08Todavía necesitas buen juicio.
00:07:09Esto solo te da esa visión general.
00:07:11No reemplaza la lectura de código.
00:07:13Solo te ayuda a entenderlo mejor, hacia dónde va todo.
00:07:16Si disfrutas de herramientas y consejos de programación como este, asegúrate de suscribirte al canal “better stack”.
00:07:20Nos vemos en otro video.
Community Posts
No posts yet. Be the first to write about this video!
Write about this video