Esta ferramenta de IA mapeia qualquer base de código antes de você mexer nela (Understand-Anything)
BBetter Stack
Computing/SoftwareSmall Business/StartupsInternet Technology
Transcript
00:00:00Você entra em uma nova equipe, clona o repositório e abre a base de código.
00:00:04E lá está ela, uma base de código de 200.000 linhas olhando para você como um cervo diante dos faróis.
00:00:09Então você faz o que todo desenvolvedor faz.
00:00:11Você usa o grep, pulamos entre arquivos e provavelmente pedimos ao Claude para explicar este repositório.
00:00:17E se você tivesse um mapa, um mapa interativo real que te ensina a base de código?
00:00:22Fluxos, camadas de arquitetura, mudanças, impacto, isto é o understand anything.
00:00:27Ele já ultrapassou 14.000 estrelas no GitHub em poucas semanas, e muitos desenvolvedores têm falado
00:00:32sobre isso.
00:00:33No próximo minuto, vou te mostrar como isso funciona e como vai acelerar
00:00:36imenso a sua compreensão da sua base de código.
00:00:44O Understand Anything é um plugin de código aberto para o Claude.
00:00:47Ele também pode se encaixar em fluxos de trabalho com ferramentas como Cursor, Copilot e Gemini CLI.
00:00:53Você o aponta para um repositório ou até mesmo uma base de conhecimento, e ele transforma esse projeto em um grafo
00:00:58de conhecimento interativo e consultável.
00:01:00Ele faz isso com análise estática combinada com processamento de LLM multiagente.
00:01:05Mas a parte importante não é a pilha tecnológica.
00:01:07A parte importante é o problema que ele realmente resolve, porque todo desenvolvedor já passou por isso.
00:01:13Você é novo em algum tipo de base de código ou aplicativo legado.
00:01:16A documentação está desatualizada.
00:01:18O engenheiro que sabia de tudo saiu há seis meses.
00:01:22E o seu agente de IA para codificação continua adivinhando repetidamente.
00:01:26É aí que esta ferramenta se torna realmente útil.
00:01:28Então vamos executá-la.
00:01:29Se você gosta de ferramentas de programação para acelerar seu fluxo de trabalho, não deixe de se inscrever.
00:01:33Temos vídeos novos o tempo todo.
00:01:35Agora aqui está um projeto de tamanho médio.
00:01:36Ele é grande o bastante para ser realmente irritante, mas pequeno o suficiente para que eu possa mostrar
00:01:40o quão legal isso é.
00:01:42É apenas um repositório que clonei dos microsserviços do Google, e é pequeno o suficiente para podermos
00:01:46testar isso sem precisar fingir nada.
00:01:49Primeiro, vou instalar o plugin, bem aqui no Claude: plugin install, understand
00:01:54anything.
00:01:55Assim que isso for gerado, precisamos recarregar os plugins, é claro, e então basta
00:01:58executar o understand.
00:02:00Agora ele vai escanear todo o repositório.
00:02:03Ele extrai a estrutura, os relacionamentos, os módulos principais e os prováveis conceitos de negócios.
00:02:09Agora podemos executar o comando de painel para iniciar tudo.
00:02:11Primeiro, demorou uma eternidade para rodar, tipo 30 minutos, e consumiu uma tonelada de tokens.
00:02:16Portanto, ter um bom plano no Claude é essencial.
00:02:19Eu uso o Claude Max, e isso usou 25% do meu limite, então ele gasta e gasta rápido.
00:02:24Mas assim que termina, podemos abrir este painel, e esta é a parte realmente legal que
00:02:29faz sentido.
00:02:30Posso aplicar o zoom out e ver a arquitetura de alto nível.
00:02:32Posso dar zoom in e acessar as partes internas.
00:02:35Posso clicar para ver o detalhamento do código e como todo esse código está conectado.
00:02:40Posso até clicar e visualizar o código em si.
00:02:43Então posso pesquisar algo aqui, como pagamentos.
00:02:46Normalmente eu estaria pulando entre rotas, serviços, modelos, manipuladores, apenas documentos
00:02:52que nem são mais úteis, e aqui a ferramenta junta as peças.
00:02:56Agora posso clicar em tour guiado, e ele percorre o fluxo em ordem.
00:03:01O ponto de entrada, a validação, a lógica, o banco de dados, APIs externas, tratamento de erros.
00:03:07Isso já é muito útil.
00:03:09Este tour guiado divide tudo.
00:03:11Podemos entrar nele e acessar os diferentes componentes.
00:03:14Essa é a diferença entre “Ei, este é um gráfico muito legal” e “Eu realmente verificaria
00:03:18isso antes de mexer no código de produção.”
00:03:20Mas agora a pergunta óbvia aqui é: nós já não temos ferramentas assim?
00:03:25Como desenvolvedores, não precisamos de mais painéis bonitos.
00:03:29Precisamos de menos tempo desperdiçado, e esta ferramenta ataca um dos maiores ralos de tempo no software.
00:03:35Obter contexto, certo?
00:03:37Onde tudo isso está conectado?
00:03:38Como isso é útil?
00:03:39As pessoas estão testando em grandes projetos, monólitos legados em Java, repositórios de microsserviços, centenas
00:03:45de arquivos, e a reação é parecida com a que tive aqui.
00:03:48Isso teria me poupado minhas primeiras duas semanas no emprego porque divide tudo,
00:03:53conecta tudo e nos mostra como as coisas estão entrelaçadas.
00:03:56Esse é o primeiro grande caso de uso: integração de novos devs.
00:03:58Então, em vez de dizer: “Leia estas 12 páginas e pergunte por aí se algo estiver confuso”, o que
00:04:03já é confuso, agora podemos dizer: “Abra o gráfico, faça o tour, e então poderemos fazer perguntas
00:04:08melhores.”
00:04:09Agora, o segundo caso de uso muito bom são os agentes de IA, porque a maioria das ferramentas de IA para código é apenas
00:04:14tão boa quanto o contexto que fornecemos a elas.
00:04:17Se o agente vir três arquivos, ele vai apenas adivinhar.
00:04:20Se ele tiver um mapa estruturado do sistema com domínios, fluxos, dependências e explicações reais,
00:04:27ele terá uma chance muito melhor de fazer a alteração certa logo de cara.
00:04:30E claro que há a refatoração, certo?
00:04:32Antes de tocarmos no código, agora podemos perguntar: “Do que este código depende?
00:04:36A qual fluxo ele pertence?
00:04:38O que pode quebrar se ele for movido?”
00:04:40É assim que você evita transformar uma mudança de uma linha em um grande evento.
00:04:44E esse é o verdadeiro motivo pelo qual os desenvolvedores estão bem animados com este projeto.
00:04:48Não porque nos importamos com diagramas — eu gosto de diagramas, certo?
00:04:51Eles são legais, são úteis, sou visual —, mas nós odiamos estar perdidos.
00:04:55Agora, aqui é onde precisamos ter cuidado, porque os desenvolvedores já viram ferramentas de visualização de código antes.
00:05:00Gráficos de IDE, navegação estilo Sourcegraph, gráficos do Nx, visualizadores de tree-sitter, e muitos
00:05:05deles têm exatamente o mesmo problema.
00:05:09O que eles fazem?
00:05:10Eles mostram a estrutura, mas não explicam o significado real.
00:05:13Eles dizem que este arquivo importa aquele outro arquivo, ótimo, mas por quê?
00:05:18De qual fluxo isso faz parte?
00:05:19Onde a requisição começa?
00:05:20O que quebra se eu mudar isso?
00:05:22Essa é a camada que falta.
00:05:24O Understand Anything está tentando adicionar essa camada.
00:05:27Em vez de apenas mostrar como um arquivo TypeScript ou algo parecido, ele tenta transformar em algo
00:05:31mais próximo de um fluxo real de como as coisas funcionam.
00:05:35Essas são as grandes questões aqui.
00:05:37De arquivos para significado, de importações para o comportamento do sistema, de “aqui estão as peças” para “aqui
00:05:42é como a máquina funciona”.
00:05:43Em comparação com muitas ferramentas de código baseadas em LLM ou RAG, ele também é mais visual e didático.
00:05:48Muitas ferramentas de código de IA são basicamente caixas de pesquisa.
00:05:52Você faz uma pergunta e obtém uma resposta.
00:05:54Isso te dá um detalhamento completo, ajudando-nos a entender para onde tudo está indo, o que está
00:06:00entrelaçado, como está conectado, permitindo-nos ver o código de fato.
00:06:04Agora vamos falar sobre o que as pessoas realmente gostam.
00:06:05A vantagem óbvia aqui foi a integração de novos devs.
00:06:07Se você está entrando em uma grande base de código, isso oferece um bom ponto de partida.
00:06:12E também as camadas de arquitetura, certo?
00:06:13Elas são realmente bem construídas.
00:06:15Você pode começar no nível do sistema e depois detalhar os módulos e os detalhes
00:06:20de implementação.
00:06:21O impacto do diff é outro ponto forte.
00:06:23Todo desenvolvedor experiente conhece o medo de fazer uma pequena alteração em uma base de código que ainda não
00:06:27compreende totalmente.
00:06:29Para os usuários do Claude Code, o grafo também pode se tornar um contexto melhor, então em vez de despejar
00:06:34arquivos aleatórios em um prompt, você fornece ao agente conhecimento arquitetural estruturado.
00:06:39Ele também é gratuito, com licença MIT, incremental e projetado para funcionar em vários ambientes de desenvolvimento.
00:06:45Agora, no lado cético, quando um projeto explode tão rápido, começamos a nos fazer a pergunta:
00:06:49isso é útil ou apenas venceu o algoritmo do GitHub?
00:06:53Essa é uma boa pergunta a se fazer.
00:06:55Há também as dependências de LLM, o que significa custo de tokens.
00:06:59Isso estourou nos custos de tokens.
00:07:02Portanto, levou um tempo, consumiu muitos tokens.
00:07:05Certifique-se de ter um bom plano se for usar isso.
00:07:08Você ainda precisa de bom senso.
00:07:09Isso apenas fornece essa visão geral.
00:07:11Não substitui a leitura do código.
00:07:13Apenas ajuda a entendê-lo melhor, sabendo para onde tudo está indo.
00:07:16Se você curte ferramentas de programação e dicas como esta, não deixe de se inscrever no canal Better Stack.
00:07:20Nos vemos em outro vídeo.