Repolode
ShadowSwaps

ShadowSwaps/REA-Reconstruction-Companion

Una skill de agente de código abierto que ayuda a los agentes de IA a entender software existente, planificar su reconstrucción y validarla junto con la herramienta REA.

Estrellas
131
Forks
22
Issues abiertos
0
Último commit
hace 7 días

¿Qué es?

REA-Reconstruction-Companion es una skill de agente independiente del modelo, escrita como instrucciones y guías de referencia en formato Markdown conforme al formato Agent Skills. Guía al agente de IA para entender cómo se comporta el software existente, convertir esas observaciones en requisitos y un plan por etapas, y desarrollar una parte concreta solo cuando se le solicite explícitamente. En cada paso, mantiene separadas las conductas observadas, las inferencias y las decisiones de diseño, y registra las lagunas en lugar de asumir que la reconstrucción coincide con el original.

La skill está diseñada para usarse junto con REA, que proporciona herramientas para examinar software y recopilar evidencia. El complemento ayuda al mismo agente a usar esa evidencia en los requisitos, el diseño, la implementación y la validación. Incluye un instalador para Node.js 20 o posterior, compatible con Claude Code, Codex y clientes genéricos, que ofrece una vista previa de ejecución en seco, una comprobación de verificación y copias de seguridad. Al añadir la integración opcional con REA, se inserta una regla identificada en el archivo de skills de REA para que las solicitudes de reconstrucción pertinentes también carguen el complemento.

El proyecto también establece límites explícitos de costos y permisos: se indica al agente que no inicie acciones que puedan generar cargos y que omita cualquier paso cuyo costo nulo no pueda confirmarse. La comprobación opcional de actualizaciones, desactivada de forma predeterminada, se ejecuta como máximo una vez cada siete días y, aun así, requiere la aprobación del usuario antes de instalar una nueva versión.

Funciones clave

  • 01Convierte observaciones, archivos o grabaciones en descripciones de comportamiento, requisitos y preguntas pendientes.
  • 02Genera especificaciones y planes de reconstrucción por etapas, con criterios de aceptación vinculados a la evidencia.
  • 03Desarrolla el comportamiento seleccionado en incrementos comprobables, solo cuando se solicita su implementación.
  • 04Incluye orientación para la validación, como fuzzing diferencial, pruebas de mutación y contratos de interfaz.
  • 05El instalador es compatible con Claude Code, Codex y directorios genéricos de skills, y ofrece modos de ejecución en seco y de comprobación.
  • 06La integración opcional con REA añade una regla de enrutamiento reversible al archivo de skills de REA.

Casos de uso

  • Entender cómo una aplicación de escritorio o web existente gestiona el guardado, la edición o la importación antes de planificar una herramienta similar.
  • Planificar la reconstrucción de una función o un formato de archivo, con entradas, salidas y casos de error documentados.
  • Recrear un flujo de trabajo seleccionado en un proyecto local e informar de las diferencias que no se hayan verificado.
  • Recuperar y modificar una reconstrucción existente, manteniendo la compatibilidad con el trabajo anterior.

Inicio rápido

  1. 1

    Descarga o clona el repositorio desde GitHub

  2. 2

    Instala el complemento para Claude Code sin modificar REA

    node install.mjs --client claude-code --integration off
  3. 3

    Previsualiza los cambios antes de instalar (opcional)

    node install.mjs --client claude-code --integration off --dry-run
  4. 4

    Verifica la instalación

    node install.mjs --client claude-code --integration off --check

Antes de usarlo

  • Se requiere Node.js 20 o posterior para ejecutar el instalador.
  • La investigación en vivo requiere instalar y configurar REA por separado para tu cliente.
  • No se puede instalar mediante clientes que solo admiten chat o clientes de carga alojada.

En colecciones

Temas

Preguntas frecuentes

¿Qué es REA-Reconstruction-Companion?
Una skill de agente de código abierto que ayuda a los agentes de IA a entender software existente, planificar su reconstrucción y validarla junto con la herramienta REA. REA-Reconstruction-Companion es una skill de agente independiente del modelo, escrita como instrucciones y guías de referencia en formato Markdown conforme al formato Agent Skills. Guía al agente de IA para entender cómo se comporta el software existente, convertir esas observaciones en requisitos y un plan por etapas, y desarrollar una parte concreta solo cuando se le solicite explícitamente. En cada paso, mantiene separadas las conductas observadas, las inferencias y las decisiones de diseño, y registra las lagunas en lugar de asumir que la reconstrucción coincide con el original.
¿REA-Reconstruction-Companion es gratuito? ¿Qué licencia tiene?
REA-Reconstruction-Companion es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿REA-Reconstruction-Companion sigue mantenido?
Mantenimiento activo. El último commit de REA-Reconstruction-Companion fue el 30 oct 2026.
¿Para qué puedo usar REA-Reconstruction-Companion?
Entender cómo una aplicación de escritorio o web existente gestiona el guardado, la edición o la importación antes de planificar una herramienta similar. Planificar la reconstrucción de una función o un formato de archivo, con entradas, salidas y casos de error documentados. Recrear un flujo de trabajo seleccionado en un proyecto local e informar de las diferencias que no se hayan verificado. Recuperar y modificar una reconstrucción existente, manteniendo la compatibilidad con el trabajo anterior.
¿Cómo se instala REA-Reconstruction-Companion?
Descarga o clona el repositorio desde GitHub Instala el complemento para Claude Code sin modificar REA: node install.mjs --client claude-code --integration off Previsualiza los cambios antes de instalar (opcional): node install.mjs --client claude-code --integration off --dry-run Verifica la instalación: node install.mjs --client claude-code --integration off --check
¿Dónde consigo REA-Reconstruction-Companion?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ShadowSwaps/REA-Reconstruction-Companion

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados