Instalação¶
Requisitos¶
- Node.js 18+ instalado na máquina
Se você não tem Node.js, instale em nodejs.org e volte aqui.
Um comando, isso é tudo¶
Na raiz do projeto legado que você quer analisar:
O instalador faz tudo isso pra você:
- Detecta as engines de IA presentes no ambiente (Claude Code, Codex, Cursor, Gemini CLI, Windsurf)
- Pergunta quais agentes instalar (todos selecionados por padrão)
- Coleta nome do projeto, idioma e preferências
- Copia os agentes para
.agents/skills/e.claude/skills/(para Claude Code) - Cria o arquivo de entrada da engine escolhida (
CLAUDE.md,AGENTS.md, etc.) - Cria a estrutura
.reversa/com estado, configuração e plano - Gera o manifesto SHA-256 para atualizações seguras no futuro
É tipo um npm install, mas para o seu time de agentes de engenharia reversa.
O que é criado no projeto¶
projeto-legado/
├── .reversa/ ← estado, config e contexto da análise
├── .agents/skills/ ← agentes universais (todas as engines)
├── .claude/skills/ ← mirror para Claude Code
├── CLAUDE.md ← ponto de entrada para Claude Code (se detectado)
├── AGENTS.md ← ponto de entrada para Codex (se detectado)
└── _reversa_sdd/ ← onde as especificações serão geradas (vazio inicialmente)
Seus arquivos ficam intactos
O instalador só cria arquivos novos. Jamais modifica ou apaga qualquer arquivo já existente no seu projeto.
Backup antes de começar¶
Recomendação forte: faça um backup
Embora o Reversa nunca modifique seus arquivos, agentes de IA podem cometer erros. Antes de iniciar a análise:
- Certifique-se de que todos os arquivos estão commitados no Git
- Tenha o repositório no GitHub, GitLab ou Bitbucket
- Faça uma cópia local da pasta como segurança extra:
cp -r meu-projeto meu-projeto-backup
Se algo inesperado acontecer, git restore . resolve.
Instalando em outra engine depois¶
Se depois quiser adicionar suporte a mais uma engine (por exemplo, você instalou só para Claude Code e agora quer Codex também):
O instalador detecta o que já existe e adiciona só o que falta.