Instalación¶
Requisitos¶
- Node.js 18+ instalado en tu máquina
Si no tienes Node.js, instálalo en nodejs.org y vuelve aquí.
Un comando, eso es todo¶
En la raíz del proyecto heredado que quieres analizar:
El instalador hace todo esto por ti:
- Detecta los motores de IA presentes en el entorno (Claude Code, Codex, Cursor, Gemini CLI, Windsurf)
- Pregunta qué agentes instalar (todos seleccionados por defecto)
- Recopila el nombre del proyecto, idioma y preferencias
- Copia los agentes a
.agents/skills/y.claude/skills/(para Claude Code) - Crea el archivo de entrada del motor (
CLAUDE.md,AGENTS.md, etc.) - Crea la estructura
.reversa/con estado, configuración y plan - Genera el manifiesto SHA-256 para actualizaciones seguras en el futuro
Es como npm install, pero para tu equipo de agentes de ingeniería inversa.
Qué se crea en el proyecto¶
proyecto-heredado/
├── .reversa/ ← estado, config y contexto del análisis
├── .agents/skills/ ← agentes universales (todos los motores)
├── .claude/skills/ ← mirror para Claude Code
├── CLAUDE.md ← punto de entrada para Claude Code (si se detecta)
├── AGENTS.md ← punto de entrada para Codex (si se detecta)
└── _reversa_sdd/ ← donde se generarán las specs (vacío inicialmente)
Tus archivos quedan intactos
El instalador solo crea archivos nuevos. Nunca modifica ni elimina ningún archivo existente en tu proyecto.
Backup antes de empezar¶
Recomendación fuerte: haz un backup
Aunque Reversa nunca modifica tus archivos, los agentes de IA pueden cometer errores. Antes de iniciar el análisis:
- Asegúrate de que todos los archivos están commiteados en Git
- Ten el repositorio en GitHub, GitLab o Bitbucket
- Haz una copia local de la carpeta como seguridad extra:
cp -r mi-proyecto mi-proyecto-backup
Si algo inesperado ocurre, git restore . lo resuelve.
Agregar otro motor después¶
Si quieres añadir soporte para otro motor más tarde:
El instalador detecta lo que ya existe y agrega solo lo que falta.