O scan — ler antes de acreditar
O Silex começa lendo seu repositório localmente: parseando cada arquivo-fonte, extraindo classes, métodos e os relacionamentos entre eles — chamadas, herança, rotas HTTP cruzando fronteiras de linguagem, joins SQL crus. Nenhum código sai da sua máquina.
O resultado é um grafo local: nós são símbolos de código, arestas são relacionamentos encontrados no fonte, cada um rastreável a arquivo e linha.
O mapa de comunidades — a forma real do sistema
O Silex agrupa o grafo de relacionamentos (algoritmo de Leiden) em comunidades: grupos de classes que realmente trabalham juntas — independentemente do layout de pastas. Esta é a arquitetura como ela é, não como a árvore src/ alega que ela é. Clique num nó para ver suas classes-membro reais.
Núcleo de domínio de Ordering
49 classes · coesão 0.067A superfície de contrato do agregado Order: repositório, eventos de domínio (cancelled/shipped/paid) e os handlers de integration events que colam a saga do pedido.
Membros (nomes reais de classes)Descrição escrita por um agente de IA lendo o code pack real desta comunidade — o mesmo fluxo orquestrado pelo cliente que você recebe.
As sagas aparecem como comunidades próprias — o grafo encontrou os passos da coreografia (confirmação de estoque, pagamento) sem que ninguém dissesse o que é uma saga. O layout de pastas diz "Ordering.API"; o grafo diz "cinco slices independentes e duas pernas de saga".
Ancoragem de evidências — sem âncora, sem fato
Toda afirmação do Silex carrega uma âncora: o arquivo e o intervalo de linhas que a prova, com o trecho citado verificado contra o fonte. Uma afirmação que não pode ser ancorada não é armazenada como fato — é marcada como lacuna.
âncoras alucinadas em 328 submissões de agentes num engajamento enterprise real de 520 classes. O portão é aplicado na entrada: uma regra submetida por agente sem proveniência é rejeitada.
Confiança — honestidade em número
A confiança expressa o quanto a evidência sustenta uma afirmação — e carrega proveniência: se veio de análise estática, de um passe de LLM ou do seu próprio agente de IA. Números nunca são inventados: uma regra proposta por agente mostra n/a até um humano revisar, não uma pontuação inventada.
Território desconhecido — o que o Silex não prova, ele te conta
O inverso da confiança: as partes do código onde a evidência era fina demais. Em vez de chutar, o Silex as marca. Para uma migração ou mudança assistida por IA, saber onde o mapa termina vale tanto quanto o mapa.
Scan de referência do eShop: 14% marcado como território desconhecido por gap_analysis.
Máquinas de estado — recuperadas do código, não da documentação
Onde o estado vive no código (enums, campos de status, transições guardadas), o Silex reconstrói a máquina — cada transição ancorada. O ciclo de vida real do pedido recuperado do eShop (Order.cs:99-131): Submitted → AwaitingValidation → StockConfirmed → Paid → Shipped, com Cancelled acessível a partir dos estados iniciais.
Confira com a seção 02: os passos de saga (confirmação de estoque, pagamento) aparecem como comunidades, e as transições que eles dirigem aparecem aqui — duas reconstruções independentes concordando é exatamente a cara da arqueologia baseada em evidências.
Código vendor e gerado — classificado, nunca apagado em silêncio
Um código real carrega bundles vendor, assets minificados e migrations geradas. O Silex os classifica para fora do caminho por padrão — fora do mapa, dos packs, das estimativas de custo — mas nunca esconde o fato.
Uma regra protege você: um arquivo com cara de vendor que seu time editou (commits locais no git) é tratado como seu código e permanece no mapa, marcado. jQuery forkado de 2014 com regra de negócio dentro? Continua visível.
Revisão humana — a camada 1.5
Entre a extração bruta e um modelo de domínio canônico fica a camada de revisão: todo fato proposto por LLM ou agente é um candidato até um humano confirmar. Seu agente de IA faz o trabalho pesado via ferramentas MCP — lendo code packs de comunidades, propondo regras com âncoras — e você continua sendo a autoridade. As descrições de comunidades da seção 02 foram produzidas exatamente assim.
Gerado de um scan real do Silex no eShop (MIT) com a v0.11.35. O grafo, as tabelas e a máquina de estado são dados, não ilustração.