Agentes¶
O Reversa coordena 9 Teams especializados de agentes. Cada agente faz uma coisa só e faz bem; cada Team agrupa os agentes em torno de uma fase do trabalho.
O orquestrador central (o próprio Reversa) coordena quem entra quando, em que ordem e em que ritmo. Mas você também pode acionar qualquer agente diretamente quando precisar.
Os 9 Teams¶
| Team | Função | No instalador |
|---|---|---|
| Reversa Agents Core | Descoberta e orquestração do legado: mapeia, escava, interpreta e documenta. Detalhado nas tabelas abaixo. | Sempre instalado |
| Code New Project Agents | Pipeline greenfield, da ideia em uma linha até specs SDD. Veja Code New Project Agents. | Marcado por padrão |
| Code Forward Agents | Conduzem a evolução a partir das specs: requirements, plan, to-do, audit, quality, coding. Veja Code Forward Agents. | Marcado por padrão |
| Migration Agents | Transformam as specs do legado em um plano de reconstrução em stack moderna. Veja Migração. | Marcado por padrão |
| Pricing and Size Agents | Estimam esforço, tamanho e precificação a partir das specs. Veja Pricing. | Marcado por padrão |
| Documentation Team | Renderiza o conhecimento extraído como mini-site HTML autocontido. Veja Time de Documentação. | Marcado por padrão |
| Bug Agents | Rastreia, debate e corrige defeitos com rastreabilidade causal até as specs. Veja Bug Agents. | Sempre instalado |
| Code Quality Agents | Melhoram o código existente sem mudar o comportamento: refatoram, modularizam, desacoplam, otimizam, simplificam, padronizam, removem código morto. Veja Code Quality Agents. | Marcado por padrão |
| Translators N8N->Specs->Python | Adaptadores que transformam artefatos estruturados (ex.: workflow N8N) em specs. Veja N8N Translator. | Desmarcado |
As tabelas abaixo detalham os agentes que compõem o Team Reversa Agents Core.
Agentes obrigatórios¶
Esses fazem parte do pipeline principal. O orquestrador os executa na sequência certa.
| Agente | Fase | Analogia | Função |
|---|---|---|---|
| Reversa | Orquestração | O regente de orquestra | Coordena todos os agentes, salva checkpoints e guia o usuário |
| Scout | Reconhecimento | O corretor de imóveis | Mapeia a superfície: pastas, linguagens, frameworks, dependências, entry points |
| Archaeologist | Escavação | O escavador | Análise profunda módulo a módulo: algoritmos, fluxos, estruturas de dados |
| Detective | Interpretação | Sherlock Holmes | Extrai regras de negócio implícitas, ADRs, máquinas de estado, permissões |
| Architect | Interpretação | O cartógrafo | Sintetiza tudo em diagramas C4, ERD e mapa de integrações |
| Writer | Geração | O tabelião | Gera specs SDD, OpenAPI e user stories com rastreabilidade de código |
Agentes opcionais¶
Instalados por padrão, mas podem ser acionados de forma independente em qualquer momento.
| Agente | Analogia | Quando usar |
|---|---|---|
| Reviewer | O revisor de specs | Após o Writer: revisa criticamente as specs e valida lacunas |
| Visor | O ilustrador forense | Quando tiver screenshots do sistema disponíveis |
| Data Master | O geólogo | Quando houver DDL, migrations ou modelos ORM para analisar |
| Design System | O estilista | Quando houver arquivos CSS, temas ou screenshots de interface |
| Soul Extractor | O ensaísta | Logo após o Scout, para uma Spec executiva única (soul.md) com propósito, entidades centrais e decisões fundadoras |
| Agents Help | O guia turístico | Quando quiser cada agente do Reversa explicado com analogias |
| Reconstructor | O pedreiro | Quando quiser reconstruir o software de baixo para cima a partir das specs geradas, uma tarefa por vez |
| Autonomous | O turno da noite | Quando ninguém vai acompanhar: executa toda a sequência do /reversa de ponta a ponta, com uma entrevista única no início |
Modo autônomo¶
O /reversa-autonomous herda o orquestrador reversa: mesmo plano, mesma sequência de agentes, mesmos checkpoints e mesma escala de confiança. A diferença está em quando ele pergunta. Toda decisão que o fluxo normal distribui pelo caminho (dados de instalação, nível de documentação, organização das specs) é concentrada em uma entrevista única no início; perguntas já respondidas no state.json ou no config.toml não são refeitas.
Foi desenhado para sessões com aprovação automática de ferramentas (modo YOLO do Claude Code ou equivalente). Como não há um humano aprovando cada ação, as travas são mais rígidas: a escrita fica restrita a .reversa/ e à pasta de saída, nenhum comando destrutivo ou de efeito externo (apagar, git push, publicar, instalar) é executado por conta própria, e o que for ambíguo fora das pastas do Reversa é deixado intacto e reportado no fim.
Depois da entrevista, ele só para diante de uma parada legítima: uma lista fechada de situações que realmente exigem um humano. O resto roda até o fim.
Tradutores (adaptadores de entrada)¶
Use quando o "código" legado não for código-fonte, e sim um artefato estruturado como um workflow visual. Geram uma spec SDD e preparam o estado para o pipeline principal continuar.
| Agente | Analogia | Quando usar |
|---|---|---|
| N8N Translator | O tradutor juramentado | Quando tiver um workflow N8N exportado em JSON e quiser documentá-lo como spec ou portar para Python |
Sequência recomendada¶
/reversa → orquestra tudo automaticamente, pausando entre agentes
/reversa-autonomous → mesma sequência, entrevista única no início, sem paradas intermediárias
Ou manualmente, se preferir controlar cada passo:
Scout → Archaeologist (N sessões) → Detective → Architect → Writer → Reviewer
Opcionais em qualquer fase:
Visor · Data Master · Design System