Introducción
UltraGX lee una Knowledge Base (KB) de GeneXus, de la versión 7.5 a la 18, y deja todo lo que sabe de ella en archivos abiertos: documentos Markdown para leer, JSON para procesar y un sitio web navegable que funciona sin conexión. El resultado sirve para tres cosas:
- Entender el sistema sin abrir el IDE de GeneXus: qué hace cada objeto, qué reglas de negocio aplica, qué tablas lee y escribe, quién lo llama y a quién llama.
- Conservar el conocimiento en un formato que se puede versionar, buscar y compartir, aunque la gente que construyó el sistema ya no esté.
- Migrar: la salida está pensada para que un agente de IA (Claude Code, Codex, Cursor, Antigravity) regenere la aplicación en otra tecnología, módulo por módulo, sin volver a interpretar GeneXus desde cero.
Qué hace, paso a paso
- Lee la KB desde un export XPZ/XML, desde un export de texto o, en Windows con GeneXus instalado, abriendo la KB directamente con el conector.
- Analiza cada objeto con reglas deterministas: tipo, estructura, reglas, eventos, variables, navegación, accesos a datos y referencias. No hay adivinanzas de un modelo de lenguaje en esta etapa: cada conclusión queda atada a la evidencia que la produjo.
- Relaciona los objetos: arma el grafo de dependencias, el modelo de datos, los árboles de llamadas, los diagramas de flujo de datos y los clusters (grupos funcionales de objetos que trabajan juntos).
- Escribe la documentación: un documento por objeto, el modelo de datos, los clusters, una hoja de ruta de reconstrucción y el visor web.
- Opcionalmente, agrega prosa con IA (la narrativa): un modelo de lenguaje redacta explicaciones y el motor verifica que cada nombre citado exista en el objeto antes de publicarla.
Solo lectura
UltraGX nunca modifica la KB. El conector abre la Knowledge Base en modo lectura y no tiene ningún camino de escritura; con un XPZ o un export de texto ni siquiera hace falta tener GeneXus instalado. Todo lo que genera se escribe en una carpeta de salida aparte.
Ediciones
| Demo | Completa | |
|---|---|---|
| Duración | 10 días desde la instalación | según la licencia |
| Inventario, grafo, modelo de datos, clusters, árboles de llamadas y diagramas | toda la KB | toda la KB |
| Documento detallado por objeto (reglas, pseudocódigo, SQL implícito, interfaz, código original) | 25 objetos elegidos por el motor | todos |
| Knowledge packs, planes de reconstrucción por cluster, narrativa con IA | solo para la muestra | todos |
| Conexión a internet | necesaria en cada ejecución (verificación de la licencia) | no hace falta |
En la demo, el resto de los objetos recibe un documento resumido con su identidad, ubicación, perfil, confianza, cluster y referencias, y un aviso de que el detalle está en la edición completa.
Qué datos salen de tu máquina
- El análisis de la KB se hace entero en tu equipo. El código, las reglas y la estructura de tus objetos no se envían a ningún servidor de UltraGX.
- Licencia demo: al registrarte mandás tus datos de contacto; en cada ejecución el servicio de licencias recibe el identificador de la licencia, el id de la máquina, cuántos objetos tiene la KB (solo cantidades) y los nombres de los objetos propuestos para la muestra.
- Licencia completa: no hay comunicación con el servicio después de activarla.
- Narrativa con IA: si la usás, el documento de cada objeto se envía al proveedor que elijas (Anthropic, OpenAI, Google, etc.) con tu propia API key. Si preferís que nada salga de la red, usá un modelo local (Ollama o LM Studio). Ver Narrativa con IA.
Cómo leer este manual
- Si estás probando la demo: Instalación → Primer inicio y licencia → Documentar una KB → Leer el resultado.
- Si ya tenés licencia: Documentar una KB → Narrativa con IA → Notas del usuario.
- Si sos parte del equipo de migración: Leer el resultado → Migrar con un agente de IA → Línea de comandos.