Flujo de trabajo complementario de Understand Anything

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> Understand Anything y Tesserae son proyectos complementarios.

• Understand Anything es excelente para producir un grafo de conocimiento de la base de código y un panel interactivo.
• Tesserae se centra en memoria de agente duradera: documentos, compilación markdown/wiki, publicación estática, historial de sesiones y exportaciones orientadas a agentes.

Tesserae no debe incorporar ni absorber Understand Anything. Trátalo como un acompañante independiente que puede producir artefactos de grafo útiles.

¿Por qué usar ambos?

Understand Anything puede escribir:

.understand-anything/knowledge-graph.json

Ese grafo captura la estructura del código, como archivos, funciones, clases, módulos, conceptos, dependencias, capas y recorridos.

Luego Tesserae puede conservar ese artefacto junto con el resto de la memoria del proyecto:

• documentos fuente y páginas markdown;
• archivos del repositorio;
• notas de investigación;
• historial local de sesiones Claude Code / Codex;
• páginas wiki estáticas generadas;
• vistas web del grafo 2D / 3D;
• llms.txt, llms-full.txt, search-index.json, graph.json y siblings de agente por página.

Flujo actual de baja fricción

La ruta recomendada es el asistente de configuración:

tesserae project setup

Elige Understand Anything en el paso de herramientas complementarias. Tesserae instala/actualiza las skills complementarias cuando se solicita y escribe un comando de actualización administrado en .tesserae/config.json. Las llamadas futuras a tesserae project compile ejecutan automáticamente ese wrapper cuando falta el grafo de UA o está obsoleto.

Para automatización no interactiva, usa:

tesserae project setup \
  --yes \
  --with-understand-anything \
  --install-understand-anything \
  --understand-anything-platform codex
tesserae project compile

El comando almacenado pertenece a Tesserae; no es algo que el usuario tenga que inventar:

tesserae project refresh-understand-anything --platform codex

Durante la compilación, Tesserae:

1. comprueba si .understand-anything/knowledge-graph.json existe y coincide con el commit git actual cuando hay metadatos disponibles;
2. ejecuta la plataforma de agente configurada (codex, opencode o claude) solo cuando falta el grafo, está obsoleto o se fuerza la actualización;
3. verifica que el grafo se haya escrito;
4. materializa .tesserae/external/understand-anything.md;
5. continúa la compilación normal de memoria.

Puedes forzar todos los comandos externos de actualización configurados antes de compilar:

tesserae project compile --refresh-external-tools

¿También necesitas Cognee? Añade las banderas de memoria en tiempo de ejecución al mismo comando setup:

tesserae project setup \
  --yes \
  --with-understand-anything \
  --install-understand-anything \
  --understand-anything-platform codex \
  --run-cognee \
  --install-cognee

Equivalente manual

Se prefiere la ruta de configuración administrada. Si intencionalmente quieres usar UA fuera de Tesserae, ejecuta primero Understand Anything dentro de tu entorno de agente:

/understand

Luego ejecuta tesserae project setup --with-understand-anything para que Tesserae registre la fuente de proyección markdown. Los archivos JSON directos se mantienen como artefactos complementarios sin procesar, no como rutas fuente introducidas a mano.

tesserae project setup --with-understand-anything
tesserae project compile
tesserae project build-site

Si también quieres memoria local de sesiones de agente:

tesserae project sessions discover --import
tesserae project build-site

Sincronización nativa de grafos

Tesserae mantiene la markdown projection para legibilidad y también importa el grafo de UA de forma nativa durante compile cuando la herramienta configurada usa sync_mode: native_graph.

El adaptador nativo lee .understand-anything/knowledge-graph.json, mapea nodos/aristas de UA a la ontology controlada de Tesserae y escribe un sync manifest:

.tesserae/external/understand-anything-sync.json

Mapeo actual:

Concept synchronization se canonicaliza en vez de duplicarse a ciegas. Si UA emite Mermaid Rendering y Tesserae ya tiene Mermaid rendering, compile conserva un único concept node y añade provenance de UA en metadata.external_refs.

Tesserae sigue siendo el memory compiler; UA sigue siendo un companion graph generator independiente.

Principio de colaboración

No presentes Tesserae como reemplazo de Understand Anything.

Un mejor encuadre:

• Understand Anything ayuda a un desarrollador a entender una base de código ahora.
• Tesserae ayuda a los agentes a recordar, buscar, citar, actualizar y publicar conocimiento del proyecto con el tiempo.