---
name: understand-anything
description: "Usar cuando se necesita analizar un codebase con Understand-Anything para generar knowledge graphs estructurales y de dominio."
summary: |
  Understand-Anything (Lum1104/Understand-Anything) analiza codebases via
  pipeline multi-agente y genera knowledge-graph.json con nodos estructurales,
  de dominio y de conocimiento. Compatible con 13 lenguajes y OpenCode nativo.
  Bridge: scripts/ua-bridge.sh. Si UA no está instalado, degrada a
  scripts/knowledge-graph.py. Ref: SPEC-SE-088-UA-ADOPT.
maturity: experimental
context: project
category: "analysis"
tags: ["knowledge-graph", "codebase", "domain", "onboarding", "diff-impact", "ua"]
priority: "medium"
allowed-tools: [Bash, Read, Glob]
user-invocable: true
---

# Understand-Anything — Knowledge Graphs para Savia

Plugin externo [Understand-Anything](https://github.com/Lum1104/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
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:

```bash
# 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` → retorna `0`
- `analyze` → 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)

```bash
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`:

```bash
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`