Understand-Anything/README.es-ES.md

Understand Anything

Convierte cualquier código fuente, base de conocimiento o documentación en un grafo de conocimiento interactivo que puedes explorar, buscar y consultar.
Compatible con Claude Code, Codex, Cursor, Copilot, Gemini CLI y más.

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe

---

Tip

¡Un enorme agradecimiento a la comunidad! El apoyo a Understand-Anything ha sido increíble. Si esta herramienta te ahorra unos minutos de buscar entre la complejidad, eso es todo lo que quería. 🚀

Acabas de unirte a un nuevo equipo. El código tiene 200,000 líneas. ¿Por dónde empiezas?

Understand Anything es un Claude Code Plugin que analiza tu proyecto con un pipeline multi-agente, construye un grafo de conocimiento de cada archivo, función, clase y dependencia, y luego te ofrece un panel interactivo para explorarlo visualmente. Deja de leer código a ciegas. Empieza a ver el panorama completo.

Grafos que enseñan > grafos que solo presumen.

---

✨ Características

Note

¿Quieres probarlo directamente? Prueba la demo en vivo en nuestra página principal — un panel interactivo donde puedes navegar, hacer zoom, buscar y explorar directamente en tu navegador.

Explora el grafo estructural

Navega tu código como un grafo de conocimiento interactivo: cada archivo, función y clase es un nodo que puedes hacer clic, buscar y explorar. Selecciona cualquier nodo para ver resúmenes en lenguaje natural, relaciones y recorridos guiados.

Comprende la lógica de negocio

Cambia a la vista de dominio y observa cómo tu código se mapea a procesos de negocio reales: dominios, flujos y pasos representados como un grafo horizontal.

Analiza bases de conocimiento

Apunta /understand-knowledge a un wiki LLM con patrón Karpathy y obtén un grafo de conocimiento dirigido por fuerzas con agrupación por comunidad. El parser determinístico extrae wikilinks y categorías de index.md, luego los agentes LLM descubren relaciones implícitas, extraen entidades y revelan afirmaciones, convirtiendo tu wiki en un grafo navegable de ideas interconectadas.

🧭 Recorridos Guiados Recorridos generados automáticamente de la arquitectura, ordenados por dependencia. Aprende el código en el orden correcto.	🔍 Búsqueda Difusa y Semántica Encuentra cualquier cosa por nombre o por significado. Busca "¿qué partes manejan la autenticación?" y obtén resultados relevantes en todo el grafo.
📊 Análisis de Impacto de Cambios Visualiza qué partes del sistema afectan tus cambios antes de hacer commit. Comprende los efectos en cascada a través del código.	🎭 Interfaz Adaptativa por Persona El panel ajusta su nivel de detalle según quién eres: desarrollador junior, PM o usuario avanzado.
🏗️ Visualización por Capas Agrupación automática por capa arquitectónica — API, Servicio, Datos, UI, Utilidades — con leyenda codificada por colores.	📚 Conceptos del Lenguaje 12 patrones de programación (genéricos, closures, decoradores, etc.) explicados en contexto donde aparecen.

---

🚀 Inicio Rápido

1. Instala el plugin

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

2. Analiza tu código

/understand

Un pipeline multi-agente escanea tu proyecto, extrae cada archivo, función, clase y dependencia, y construye un grafo de conocimiento guardado en .understand-anything/knowledge-graph.json.

3. Explora el panel

/understand-dashboard

Se abre un panel web interactivo con tu código visualizado como un grafo, codificado por colores según la capa arquitectónica, con funciones de búsqueda y clic. Selecciona cualquier nodo para ver su código, relaciones y una explicación en lenguaje natural.

4. Sigue aprendiendo

# Pregunta cualquier cosa sobre el código
/understand-chat How does the payment flow work?

# Analiza el impacto de tus cambios actuales
/understand-diff

# Profundiza en un archivo o función específica
/understand-explain src/auth/login.ts

# Genera una guía de incorporación para nuevos miembros del equipo
/understand-onboard

# Extrae conocimiento de dominio de negocio (dominios, flujos, pasos)
/understand-domain

# Analiza un wiki LLM con patrón Karpathy
/understand-knowledge ~/path/to/wiki

---

🌐 Instalación Multiplataforma

Understand-Anything funciona en múltiples plataformas de codificación con IA.

Claude Code (Nativo)

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

Codex

Dile a Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md

OpenCode

Dile a OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md

OpenClaw

Dile a OpenClaw:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.openclaw/INSTALL.md

Cursor

Cursor detecta automáticamente el plugin a través de .cursor-plugin/plugin.json cuando se clona este repositorio. No requiere instalación manual: simplemente clona y abre en Cursor.

VS Code + GitHub Copilot

VS Code con GitHub Copilot (v1.108+) detecta automáticamente el plugin a través de .copilot-plugin/plugin.json cuando se clona este repositorio. No requiere instalación manual: simplemente clona y abre en VS Code.

Para habilidades personales (disponibles en todos los proyectos), dile a GitHub Copilot:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.vscode/INSTALL.md

Copilot CLI

copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin

Antigravity

Dile a Antigravity:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.antigravity/INSTALL.md

Gemini CLI

Dile a Gemini CLI:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.gemini/INSTALL.md

Pi Agent

Dile a Pi Agent:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.pi/INSTALL.md

Compatibilidad de Plataformas

Plataforma	Estado	Método de Instalación
Claude Code	✅ Nativo	Marketplace de plugins
Codex	✅ Soportado	Instalación guiada por IA
OpenCode	✅ Soportado	Instalación guiada por IA
OpenClaw	✅ Soportado	Instalación guiada por IA
Cursor	✅ Soportado	Detección automática
VS Code + GitHub Copilot	✅ Soportado	Detección automática
Copilot CLI	✅ Soportado	Instalación de plugin
Antigravity	✅ Soportado	Instalación guiada por IA
Gemini CLI	✅ Soportado	Instalación guiada por IA
Pi Agent	✅ Soportado	Instalación guiada por IA

---

📦 Comparte el Grafo con tu Equipo

El grafo es solo JSON — confírmalo una vez y tus compañeros se saltan el pipeline. Ideal para onboarding, revisiones de PR y flujos docs-as-code.

Ejemplo: GoogleCloudPlatform/microservices-demo (fork) — referencia políglota (Go / Java / Python / Node) con el grafo ya confirmado.

Qué confirmar: todo lo que hay en .understand-anything/ excepto intermediate/ y diff-overlay.json (archivos temporales locales).

.understand-anything/intermediate/
.understand-anything/diff-overlay.json

Mantenlo al día: activa /understand --auto-update — un hook post-commit parchea el grafo de forma incremental, así cada commit llega con su grafo correspondiente. O vuelve a ejecutar /understand manualmente antes de cada release.

Grafos grandes (10 MB o más): úsalos con git-lfs.

git lfs install
git lfs track ".understand-anything/*.json"
git add .gitattributes .understand-anything/

---

🔧 Bajo el Capó

Pipeline Multi-Agente

El comando /understand orquesta 5 agentes especializados, y /understand-domain añade un sexto:

Agente	Rol
project-scanner	Descubre archivos, detecta lenguajes y frameworks
file-analyzer	Extrae funciones, clases e importaciones; produce nodos y aristas del grafo
architecture-analyzer	Identifica capas arquitectónicas
tour-builder	Genera recorridos de aprendizaje guiados
graph-reviewer	Valida la completitud y la integridad referencial del grafo (se ejecuta inline por defecto; usa --review para una revisión completa con LLM)
domain-analyzer	Extrae dominios de negocio, flujos y pasos de proceso (usado por /understand-domain)
article-analyzer	Extrae entidades, afirmaciones y relaciones implícitas de artículos wiki (usado por /understand-knowledge)

Los analizadores de archivos se ejecutan en paralelo (hasta 5 concurrentes, 20-30 archivos por lote). Soporta actualizaciones incrementales: solo reanaliza los archivos que cambiaron desde la última ejecución.

---

🤝 Contribuir

¡Las contribuciones son bienvenidas! Así puedes empezar:

1. Haz fork del repositorio
2. Crea una rama de funcionalidad (git checkout -b feature/my-feature)
3. Ejecuta las pruebas (pnpm --filter @understand-anything/core test)
4. Haz commit de tus cambios y abre un pull request

Para cambios importantes, abre primero un issue para que podamos discutir el enfoque.

---

Deja de leer código a ciegas. Empieza a entenderlo todo.

Historial de Stars

Licencia MIT © Lum1104