reversa

Reversa es un marco para extraer especificaciones de sistemas heredados mediante ingeniería inversa, permitiendo que los agentes de codificación de IA trabajen con ellos de forma segura. Se instala con `npx reversa install` en la raíz de un proyecto, desplegando un equipo de agentes de IA especializados en el espacio de trabajo. El proceso central es la fase de Descubrimiento (`/reversa`), orquestada por el agente Reversa en cinco pasos: Scout mapea la superficie del proyecto, Arqueólogo analiza módulos y flujos de control, Detective extrae reglas de negocio implícitas y decisiones de arquitectura, Arquitecto sintetiza diagramas C4 y ERD, y Escritor produce contratos operativos ejecutables con trazabilidad de código. Agentes opcionales como Visor (documentación de UI desde capturas), Data Master (análisis de bases de datos), Design System (extracción de tokens de diseño) y Soul Extractor (especificación de resumen ejecutivo) están disponibles. Más allá del descubrimiento, Reversa admite varios flujos de trabajo: - `/reversa-new` — proyectos desde cero, de una idea de una línea a especificaciones completas - `/reversa-forward` — evolución de un sistema desde especificaciones a código, una característica a la vez - `/reversa-migrate` — reconstrucción de sistemas heredados en una pila moderna - `/reversa-docs` — renderizado del conocimiento extraído como un mini-sitio HTML estático - `/reversa-debugger` — seguimiento de defectos con trazabilidad causal hasta las especificaciones - `/reversa-refactor` — mejora de la calidad del código sin cambiar el comportamiento - `/reversa-pricing-*` — estimación de esfuerzo y costo desde especificaciones Las variantes autónomas (`/reversa-autonomous`, `/reversa-new expresso`, `/reversa-forward-autonomous`) ejecutan procesos de principio a fin tras una única entrevista inicial. Todas las escrituras se restringen a `.reversa/` y carpetas de salida, sin tocar nunca los archivos existentes del proyecto. Los puntos de control se guardan en `.reversa/state.json` para reanudar sesiones interrumpidas. El marco genera artefactos estructurados, incluyendo especificaciones SDD, documentos de requisitos, hojas de ruta, planes de acción y matrices de trazabilidad. La salida reside en `_reversa_sdd/` para especificaciones y `_reversa_bugs/` para seguimiento de defectos, ambos bajo control de versiones.