Como gerar specs de código legado com IA usando Reversa

114.8K views
•
April 29, 2026
by
Sandeco
YouTube video player
Como gerar specs de código legado com IA usando Reversa

TL;DR

O vídeo mostra o Reversa, um framework que gera especificações a partir de código sem documentação, inclusive código legado. A demonstração usa o ISS Tracker para mostrar etapas: instalar o Reversa, configurar agentes, planejar a exploração, gerar specs e reconstruir o código. Também explica como dividir tarefas entre engines IA para economizar tokens e melhorar a reconstrução.

Transcript

Eu peguei um projeto inteiro de rastreamento da estação espacial internacional, [música] instalei o Reversa nele, gerei specs e deletei o projeto original. [música] Depois eu pedi para eu reversa reconstruir tudo do zero e o que aconteceu é que ficou absurdamente idêntico ao original. Hoje eu vou te mostrar como fazer isso naquele código legado seu... Read More

Key Insights

  • Reversa transforma código legado em specs prontas para IA, atuando como camada de engenharia reversa
  • O processo envolve reconhecimento, escavação, interpretação e geração das specs, com revisão final
  • É possível controlar o nível de detalhamento das specs entre essencial, completo ou detalhado
  • A arquitetura do software é mapeada com visões gerais, incluindo serviços de posição da ISS e do Sol
  • As especificações cobrem fluxos principais e alternativos, além de regras de negócio
  • Diversas engines de IA podem ser acionadas paralelamente para otimizar tokens
  • Arquitetura do sistema pode não possuir banco de dados, dependendo do projeto
  • Planos de geração guiam a escrita das specs, com pausas para validação e ajustes

Explore YouTube Video Summarizer or Get YouTube Transcript Extractor

Questions & Answers

Q: Como funciona o Reversa para gerar specs a partir de código legado

O Reversa funciona recebendo um repositório de código legado e, por meio de agentes de IA, executa uma sequência de fases: reconhecimento, escavação, interpretação e geração de specs. Durante a geração, ele cria uma pasta SD D com os documentos das especificações, incluindo serviços, fluxos e regras de negócio. O usuário pode alternar entre engines para gerenciar tokens e manter o processo estável, paralelizando etapas quando necessário. A ferramenta também permite inserir descrições de telas para reconhecimento de interfaces, facilitando a reconstrução de experiências de usuário a partir do código existente.

Q: Quais engines IA são citadas como compatíveis com o Reversa

O vídeo cita várias engines compatíveis com o Reversa como Cloud Code, Codex, Antigravity, Cursor, Windsurf e Claude Code, entre outras. O usuário pode selecionar quais agentes ativar durante a instalação do framework, escolhendo módulos como revisão, análise de interface, análise de banco de dados e design tokens. A integração entre diferentes engines facilita a geração de especificações e a reconstrução de software, especialmente em projetos com pouca ou nenhuma documentação prévia.

Q: Qual é o papel do ISS Tracker no tutorial

O ISS Tracker serve como estudo de caso para demonstrar o fluxo completo do Reversa, desde a instalação até a geração de specs e a reconstrução do código a partir das especificações. O vídeo mostra o ISS Tracker, apaga o código original mantendo apenas as specs, e utiliza as especificações geradas para reconstruir o software com IA. Esse exemplo ilustra como o framework lida com sistemas reais, incluindo aspectos de arquitetura, interfaces e fluxos de negócio.

Q: Como o vídeo aborda o detalhamento das specs

O vídeo oferece opções de detalhamento das specs: essencial, completo ou detalhado. O usuário escolhe no processo de planejamento, o que determina a profundidade da documentação gerada. Em tempo de execução, o Reversa pode adaptar o nível de detalhamento para manter o desempenho, especialmente quando usa várias engines para dividir tarefas. Essa flexibilidade permite equilibrar custo de tokens com qualidade da documentação.

Q: Quais serviços-chave são documentados pelas specs geradas

Entre os serviços documentados pelas specs estão o ISS Service, responsável por obter a posição atual da estação espacial, e o Solar Service, que calcula o ponto solar atual para representar a Terra com precisão. Além disso, a documentação aborda Fluxos principais e alternativos, e as regras de negócio associadas a cada serviço. Esses componentes ajudam a compor uma visão clara da arquitetura do sistema sem depender do código-fonte original.

Q: Como é feito o gerenciamento de tokens durante a geração

O gerenciamento de tokens é feito distribuindo a tarefa entre várias engines, permitindo que uma parte da geração ocorra no Cloud Code, outra no Codex e outra no Antigravity ou similar. Quando os tokens de uma engine se esgotam, o processo pode ser continuado em outra engine usando a referência de plano já criado. Essa estratégia reduz o risco de interrupção e permite manter o ritmo da geração de specs, mesmo em projetos grandes.

Q: O que acontece com a tela da aplicação durante a documentação

Para facilitar a documentação de interfaces, o vídeo mostra a prática de capturar telas da aplicação e permitir que o Reversa reconheça visualmente a tela para mapear elementos de interface, cores, tipografia e layout. Esse recurso auxilia na geração de um design system coerente com a aplicação original, contribuindo para a reconstrução fiel do software a partir das specs. O processo pode ser repetido conforme necessário para cobrir diferentes telas e estados.

Q: Quais são as limitações ou cuidados ao usar o Reversa

Um cuidado importante é não depender de chaves de API ou pagamentos externos para o funcionamento do Reversa, como mostrado no vídeo. O fluxo sugere manter um repositório salvo no GitHub para restauração em caso de problemas. Além disso, é essencial gerenciar o nível de detalhamento das specs para evitar consumo excessivo de tokens, especialmente durante a fase de geração, e planejar pausas para validação com o usuário.

Summary & Key Takeaways

  • O vídeo demonstra a instalação do Reversa e a configuração de agentes em Cloud Code, Codex e Antigravity para análise de um projeto legado. Em seguida, é criado um plano de exploração, que envolve reconhecimento, escavação, interpretação e geração das specs. O resultado inclui documentação de serviços chave como ISS Service e Solar Service, com fluxos e regras de negócio.

  • A demonstração utiliza o ISS Tracker como caso de uso para documentar a arquitetura, a ausência de banco de dados na versão inicial e a estratégia de documentar interfaces, cores, tipografia e design system. A ferramenta é apresentada como capaz de reconstruir código a partir das especificações geradas, salvando tudo em uma pasta SD D com níveis de detalhamento.

  • O vídeo também explora a ideia de alternar entre engines para gerenciar tokens, usar o Codex para continuar a geração quando tokens se esgotam e realizar uma revisão final das specs geradas para garantir consistência e cobertura das regras de negócio.


Read in Other Languages (beta)

Share This Summary 📚

Explore More Summaries from Sandeco 📚