Introdução

O UltraGX lê uma Knowledge Base (KB) do GeneXus, da versão 7.5 à 18, e deixa tudo o que sabe sobre ela em arquivos abertos: documentos Markdown para ler, JSON para processar e um site navegável que funciona sem conexão. O resultado serve para três coisas:

Entender o sistema sem abrir a IDE do GeneXus: o que cada objeto faz, quais regras de negócio aplica, quais tabelas lê e grava, quem o chama e quem ele chama.
Preservar o conhecimento em um formato que pode ser versionado, pesquisado e compartilhado, mesmo que as pessoas que construíram o sistema já não estejam mais lá.
Migrar: a saída foi pensada para que um agente de IA (Claude Code, Codex, Cursor, Antigravity) regenere o aplicativo em outra tecnologia, módulo por módulo, sem reinterpretar o GeneXus do zero.

O que ele faz, passo a passo

Lê a KB a partir de um export XPZ/XML, de um export de texto ou, no Windows com o GeneXus instalado, abrindo a KB diretamente com o conector.
Analisa cada objeto com regras determinísticas: tipo, estrutura, regras, eventos, variáveis, navegação, acessos a dados e referências. Nesta etapa não há palpites de um modelo de linguagem: cada conclusão fica ligada à evidência que a produziu.
Relaciona os objetos: monta o grafo de dependências, o modelo de dados, as árvores de chamadas, os diagramas de fluxo de dados e os clusters (grupos funcionais de objetos que trabalham juntos).
Escreve a documentação: um documento por objeto, o modelo de dados, os clusters, um roteiro de reconstrução e o visualizador web.
Opcionalmente, adiciona prosa com IA (a narrativa): um modelo de linguagem redige explicações e o motor verifica se cada nome citado existe no objeto antes de publicá-la.

Somente leitura

O UltraGX nunca modifica a KB. O conector abre a Knowledge Base em modo de leitura e não tem nenhum caminho de escrita; com um XPZ ou um export de texto nem é preciso ter o GeneXus instalado. Tudo o que ele gera é gravado em uma pasta de saída separada.

Edições

	Demo	Completa
Duração	10 dias a partir da instalação	conforme a licença
Inventário, grafo, modelo de dados, clusters, árvores de chamadas e diagramas	toda a KB	toda a KB
Documento detalhado por objeto (regras, pseudocódigo, SQL implícito, interface, código original)	25 objetos escolhidos pelo motor	todos
Knowledge packs, planos de reconstrução por cluster, narrativa com IA	somente para a amostra	todos
Conexão com a internet	necessária em cada execução (verificação da licença)	não é necessária

Na demo, os demais objetos recebem um documento resumido com sua identidade, localização, perfil, confiança, cluster e referências, e um aviso de que o detalhe está na edição completa.

Quais dados saem da sua máquina

A análise da KB é feita inteiramente no seu computador. O código, as regras e a estrutura dos seus objetos não são enviados a nenhum servidor do UltraGX.
Licença demo: ao se registrar, você envia seus dados de contato; em cada execução o serviço de licenças recebe o identificador da licença, o id da máquina, quantos objetos a KB tem (apenas quantidades) e os nomes dos objetos propostos para a amostra.
Licença completa: não há comunicação com o serviço depois de ativá-la.
Narrativa com IA: se você a usar, o documento de cada objeto é enviado ao provedor que você escolher (Anthropic, OpenAI, Google etc.) com a sua própria API key. Se preferir que nada saia da rede, use um modelo local (Ollama ou LM Studio). Veja Narrativa com IA.

Como ler este manual

Se você está testando a demo: Instalação → Primeiro início e licença → Documentar uma KB → Ler o resultado.
Se você já tem licença: Documentar uma KB → Narrativa com IA → Notas do usuário.
Se você faz parte da equipe de migração: Ler o resultado → Migrar com um agente de IA → Linha de comando.