# Reversa Agents Help > Explica com analogias o que cada agente do Reversa faz e quando usá-lo. Ative com /reversa-agents-help. - Skill: `sandeco/reversa-agents-help` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add sandeco/reversa-agents-help` - Raw SKILL.md: https://api.skillmd.com/api/skills/sandeco/reversa-agents-help/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - License: MIT - Author: sandeco (https://skillmd.com/u/sandeco) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/sandeco/reversa-agents-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. --- ## Menu principal | O que você quer fazer? | Comando | Time | |---|---|---| | Descobrir e documentar um sistema legado | `/reversa` | Reversa Agents Core | | Clarear a ideia antes de qualquer código | `/reversa-brainstorm` | Ideation Agents | | Criar um projeto novo a partir de uma ideia | `/reversa-new` | Code New Project Agents | | Implementar ou evoluir código a partir das specs | `/reversa-forward` | Code Forward Agents | | Planejar a migração de um legado | `/reversa-migrate` | Migration Agents | | Gerar um mini-site visual da documentação | `/reversa-docs` | Documentation Agents | | Entender qual agente usar | `/reversa-agents-help` | Guia de agentes | Os times de Pricing e Translators têm comandos especializados. Use `/reversa-pricing-profile`, `/reversa-pricing-size`, `/reversa-pricing-estimate` ou `/reversa-n8n` conforme a necessidade. --- ## 💡 Reversa Brainstorm, a mesa antes da obra **Comando:** `/reversa-brainstorm` Antes de o pedreiro levantar parede, alguém senta na mesa e pergunta o que se quer com a casa: para quem é, o que dói morar como está hoje, quais os caminhos possíveis, o que pode dar errado. Ninguém desenha planta nessa mesa. Só se decide o que vale construir. > Use o Reversa Brainstorm quando a ideia ainda está bruta, em projeto novo ou em legado. Ele conduz `Framer → Explorer → Challenger → Arbiter → Pre-Spec` e entrega o resultado ao `/reversa-new` (greenfield) ou ao `/reversa-requirements` (legado). **Os cinco da mesa:** | Agente | Analogia | Comando | |---|---|---| | **Framer** | O médico que não aceita "quero remédio X" e pergunta onde dói | `/reversa-framer` | | **Explorer** | O guia que mostra todas as trilhas, inclusive a de não subir a montanha | `/reversa-explorer` | | **Challenger** | O advogado do diabo que já viu esse projeto fracassar antes | `/reversa-challenger` | | **Arbiter** | O juiz que dá o veredito e assume o que se perde com ele, mas quem decide é você | `/reversa-arbiter` | | **Pre-Spec** | O escrivão que entrega o mínimo para a obra começar, e nada além | `/reversa-pre-spec` | --- ## 🆕 Reversa New — o fundador de produto **Comando:** `/reversa-new` O fundador começa com uma ideia ainda bruta, investiga o problema, entende para quem o produto existe, consolida um PRD e transforma tudo em especificações prontas para implementação. > Use o Reversa New para projetos greenfield. Ele conduz `Ideator → Researcher → Drafter → Spec SDD` e entrega o resultado ao `/reversa-forward`. --- ## 🎼 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 ``` Projeto legado: /reversa → descoberta e especificações Projeto novo: /reversa-new → PRD e specs → /reversa-forward Migração: /reversa → /reversa-migrate → /reversa-forward Pipeline legado manual: Scout → Archaeologist (N sessões) → Detective → Architect → Writer → Reviewer Opcionais em qualquer fase: Soul Extractor · Visor · Data Master · Design System · Reversa Docs ```