Understand-Anything — Knowledge Graphs para Savia
Plugin externo Understand-Anything
(MIT, TypeScript/pnpm) que analiza codebases via pipeline multi-agente y genera
knowledge-graph.json con tres capas:
- Grafo estructural: archivos, funciones, clases, dependencias
- Grafo de dominio: procesos de negocio, flujos, steps
- Grafo de conocimiento: entidades, claims, relaciones (Karpathy-pattern)
Compatible con 13 lenguajes. Dashboard interactivo React con force-directed layout, búsqueda semántica y tours guiados.
Bridge
Savia accede a UA exclusivamente via scripts/ua-bridge.sh:
bash scripts/ua-bridge.sh check # UA instalado?
bash scripts/ua-bridge.sh analyze [path] # generar knowledge-graph.json
bash scripts/ua-bridge.sh diff --count # nodos afectados por cambios staged
bash scripts/ua-bridge.sh domain [path] # extraer conceptos de negocio
bash scripts/ua-bridge.sh dashboard # lanzar dashboard interactivo
bash scripts/ua-bridge.sh onboard [path] # guía de onboarding
Comandos Savia
| Comando | Función |
|---|---|
/ua-analyze [path] |
Analizar codebase y generar knowledge-graph.json |
/ua-domain [path] |
Extraer dominios de negocio |
/ua-diff |
Impacto de cambios no commiteados |
/ua-chat {query} |
Preguntas sobre el grafo |
/ua-dashboard |
Lanzar dashboard interactivo |
/ua-onboard [path] |
Generar guía de onboarding |
/ua-install |
Instalar o actualizar UA plugin |
Activación
UA no se instala con Savia. Es opt-in:
# 1. Instalar
bash scripts/ua-install.sh
# 2. Verificar
bash scripts/ua-bridge.sh check
Si check retorna exit 1, todos los comandos degradan gracefully:
diff --count→ retorna0analyze→ reporta "UA not installed", exit 0- no hay crashes
Integración con sistemas Savia
Memory Feed
knowledge-graph.json → memory-agent
DOMAIN_ENTITY edges → memoria episódica
DEPENDS_ON edges → dependencias técnicas
IMPLEMENTS edges → funciones → specs/requisitos
CI Gate G16 (WARN, no-blocking)
ua_diff_count=$(bash scripts/ua-bridge.sh diff --count)
[[ $ua_diff_count -gt 50 ]] && echo "WARN: diff impact >50 nodes affected"
Fallback
Si UA no está disponible, usar scripts/knowledge-graph.py:
python3 scripts/knowledge-graph.py .
Produce un grafo reducido compatible con la capa de memoria de Savia.
Cuándo usar
- Onboarding de proyecto nuevo (>500 ficheros)
- Análisis de impacto antes de refactoring mayor
- Extracción de dominio de negocio de codebase legacy
- Gate de CI para estimar scope de un PR
Cuándo NO usar
- Proyectos N4b (PM-Only) — el grafo mezcla código y no puede viajar al repo
- Proyectos pequeños (<100 ficheros) — overhead supera el beneficio
- Sesiones one-shot sin instalación previa de UA
Referencias
- Upstream: https://github.com/Lum1104/Understand-Anything (MIT)
- Bridge:
scripts/ua-bridge.sh - Spec:
docs/specs/SPEC-SE-088-UA-ADOPT.spec.md - Skills relacionadas:
knowledge-graph,codegraph,agent-code-map