--- name: reversa-agents-help description: Explica com analogias o que cada agente do Reversa faz e quando usá-lo. Ative com /reversa-agents-help. license: MIT compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills. metadata: author: sandeco version: "1.0.0" framework: reversa role: help --- Apresente exatamente o texto abaixo, sem alterações, sem resumir. --- # Agentes do Reversa — guia com analogias O Reversa é um time de especialistas. Cada agente faz uma coisa só — e faz bem. --- ## 🎼 Reversa — orquestrador central **Comando:** `/reversa` Um regente de orquestra não toca nenhum instrumento. Ele conhece a partitura inteira e diz quem entra quando, em que ordem, em que ritmo. Sem ele, cada músico tocaria sua parte sem se conectar com os outros. > Use o Reversa para iniciar ou retomar a análise completa. Ele cuida da sequência por você. --- ## 🗺️ Scout — o corretor de imóveis **Comando:** `/reversa-scout` O corretor faz o primeiro tour no imóvel. Não abre gavetas, não lê documentos, não mexe em nada. Só mapeia: quantos cômodos, qual o bairro, que instalações existem, qual o estado geral. > Use o Scout no começo. Ele gera o inventário do projeto — linguagens, frameworks, módulos, dependências — sem entrar no código. --- ## 🧬 Soul Extractor: o biógrafo expresso **Comando:** `/reversa-extract-soul` O biógrafo expresso visita o personagem, lê as anotações do corretor (Scout), folheia rapidamente alguns álbuns de família e o histórico de cartas (git log), e produz uma biografia de uma página: quem é, o que faz, e as decisões fundadoras que moldaram a vida toda. Não é a história completa, é a alma destilada. > Use o Soul Extractor logo após o Scout, quando quiser uma síntese executiva do sistema (propósito, entidades centrais e decisões fundadoras) numa única Spec, sem esperar todo o pipeline. Não substitui Archaeologist nem Detective. --- ## ⛏️ Archaeologist — o escavador **Comando:** `/reversa-archaeologist` O arqueólogo escava o terreno com paciência, camada por camada. Cataloga cada artefato encontrado: tamanho, material, localização, forma. Ele não interpreta a civilização, só descreve com precisão o que está lá. > Use o Archaeologist para analisar o código módulo a módulo. Ele extrai funções, algoritmos, estruturas de dados e fluxos de controle. **Roda um módulo por sessão** para economizar tokens. --- ## 🔍 Detective — o Sherlock Holmes **Comando:** `/reversa-detective` Sherlock Holmes chega depois do arqueólogo. Olha para os artefatos catalogados e pergunta: *"Mas por que isso está aqui? Quem colocou? O que isso revela sobre quem viveu aqui?"* Ele não escava. Ele interpreta. > Use o Detective após o Archaeologist. Ele extrai regras de negócio implícitas, lê o histórico git como um diário e reconstrói decisões que ninguém documentou. --- ## 📐 Architect — o cartógrafo **Comando:** `/reversa-architect` O cartógrafo visita um território e produz mapas formais: planta baixa, mapa de elevação, planta estrutural. Alguém que nunca pisou lá consegue entender tudo olhando para os mapas. > Use o Architect após o Detective. Ele sintetiza tudo em diagramas C4, ERD completo e mapa de integrações. --- ## 📝 Writer — o tabelião **Comando:** `/reversa-writer` O tabelião transforma o que foi descoberto em contratos formais, precisos e rastreáveis. Cada cláusula tem grau de certeza declarado. O documento vale como contrato: um agente de IA pode reimplementar o sistema a partir dele. > Use o Writer após o Architect. Ele gera as specs SDD, OpenAPI e user stories com rastreabilidade de código. --- ## ⚖️ Reviewer — o revisor de specs **Comando:** `/reversa-reviewer` O Reviewer pega os contratos do Writer e tenta furar: *"Isso é contradição. Esse ponto não tem prova. Essa regra some se o usuário fizer X."* Ele não quer destruir, quer garantir que o que ficou de pé seja sólido. > Use o Reviewer após o Writer. Ele revisa criticamente as specs, reclassifica confiança e levanta perguntas para validação humana. --- ## 🖼️ Visor — o ilustrador forense **Comando:** `/reversa-visor` O ilustrador forense trabalha só com imagens. Recebe screenshots do sistema e reconstrói fielmente a interface: telas, formulários, fluxos de navegação. Não precisa que o sistema esteja rodando — só das fotos. > Use o Visor quando tiver screenshots disponíveis. Ele documenta a UI sem precisar de acesso ao sistema. --- ## 🗄️ Data Master — o geólogo **Comando:** `/reversa-data-master` O geólogo mapeia o subsolo — a camada que ninguém vê mas que sustenta tudo. Tabelas, relacionamentos, constraints, triggers, procedures. A fundação invisível sobre a qual a aplicação está construída. > Use o Data Master quando houver DDL, migrations ou modelos ORM disponíveis. Ele documenta o banco completamente. --- ## 🎨 Design System — o estilista **Comando:** `/reversa-design-system` O estilista cataloga o guarda-roupa: paleta de cores, tipografia, espaçamentos, tokens de design. As "regras de moda" que governam a aparência do sistema — o que pode e o que não pode ser combinado. > Use o Design System quando houver arquivos CSS, temas ou screenshots de interface. Ele extrai os tokens visuais do projeto. --- ## Sequência recomendada ``` /reversa → orquestra tudo automaticamente Ou manualmente: Scout → Archaeologist (N sessões) → Detective → Architect → Writer → Reviewer Opcionais em qualquer fase: Soul Extractor · Visor · Data Master · Design System ```