Método · 3 proyectos · verificador

La IA dice que entendió la app. Pida la prueba.

Cuatro reglas, tres pedidos listos y un verificador que reprueba al agente cuando adivina.

Rehaga con pruebas: lupa dorada sobre documentos con sello de aprobado
En resumen

REA con pruebas es un kit abierto y gratuito para quienes usan un agente de IA (Claude Code, Codex o el harness dsh) para estudiar una app y hacer su propia versión. REA viene de Reverse Engineer Anything, una herramienta abierta de ingeniería inversa: entender cómo se hizo un programa mirando lo que ya está hecho. El problema: el agente dice que entendió cómo funciona la app e inventa lo que no vio. El kit trae 4 reglas, 3 pedidos listos (panel de agentes, reactor de leads y sitio rehecho) y un verificador en Python que reprueba el archivo de pruebas cuando falta evidencia. Para usarlo, necesitas Python 3 y un agente de IA en la terminal.

Video

Mira: el método en menos de 3 minutos

El video muestra las 4 reglas y las 3 construcciones del kit (en portugués).

Ver en YouTube

⚠️ Seguridad y licencia — lea antes

  • Solo software propio o de código abierto cuya licencia permita estudiarlo (MIT, Apache-2.0, BSD, GPL, MPL…). No use este método en una app cerrada de otra empresa.
  • Estudiar no es copiar. Su versión se escribe desde cero, con su nombre, sus textos y su diseño. No se lleve archivos, íconos ni marcas.
  • Licencia GPL/AGPL: si reutiliza algún fragmento, siga sus condiciones. Si tiene dudas, quédese solo con la idea.
  • Ejecute el agente en una carpeta separada, sin contraseñas, claves ni datos de clientes. El kit solo lee y escribe archivos en la carpeta de trabajo; no envía, borra ni publica nada por su cuenta.

El kit es MIT. Texto completo de las reglas: REGRAS.md (en portugués).

Qué es

Pedir pruebas cambia lo que entrega el agente

Sin pruebas, el agente escribe un párrafo convincente. Con pruebas, cada frase señala un archivo y una línea que usted puede abrir.

Las piezas del kit: 4 reglas, provas.md, verificador, panel de agentes, reactor de leads y sitio rehecho
✗ Sin pruebas
C1. La app usa una arquitectura moderna
    basada en microservicios.
    Confianza: alta

Suena bien. No tiene cómo comprobarlo. A veces es verdad, a veces es una suposición.

✓ Con pruebas
C1. Cada agente es una tarjeta en una cuadrícula
- Prueba: `src/components/AgentGrid.tsx:12-48`
- Fragmento: `repeat(auto-fill, minmax(280px, 1fr))`

Abre el archivo en la línea 12 y lo verás. Si no está ahí, el agente se equivocó.

Las 4 reglas

Todo el método cabe en cuatro reglas

Pégalas junto con cualquier pedido de "estudia esta app y haz la mía".

1

Pide el provas.md

Cada conclusión con el archivo y el fragmento que la prueba, más la sección "O que NÃO deu para provar".

2

Enfócate en el código de la app

Pide que ignore node_modules, vendor y site-packages. Probarlo con una biblioteca es explicar la biblioteca, no la app.

3

Solo lo tuyo o lo abierto

Software tuyo o de código abierto con una licencia que permita estudiarlo. Después, TU versión, con tu nombre y aspecto.

4

Describe el aspecto visual

Colores con código, fuentes, movimiento y densidad en un brief de diseño. Eso es lo que separa un panel feo de una buena pantalla.

Cómo funciona

Primero la prueba, después el código

Cada pedido del kit tiene dos fases. El agente solo construye después de que el verificador aprueba el archivo de pruebas.

Tú eliges la app (tuya o abierta)→ El agente estudia→ provas.md→ confere_provas.py→ ¿APROVADO?→ Brief de diseño→ Tu versión
3 construcciones listas

Tres pedidos para pegar en el agente

En portugués, con [corchetes] donde cambias el caso por el tuyo. Funcionan en Claude Code, Codex o el harness dsh. Los agentes de las construcciones son simulados: no llaman a una IA ni a una API, ni envían mensajes de verdad.

🧩 A · Panel de agentes

Estudia cómo una app de código abierto muestra varios agentes lado a lado y construye un panel con 6 agentes activos para un negocio.

  • Ejemplo: clínica dental — captación, bandeja de entrada, SEO, agenda, soporte, informes
  • Cada tarjeta indica qué hace el agente y su estado (con una etiqueta, no solo con color)
  • Caja de comandos que envía la tarea al agente adecuado

prompts/a-painel-de-agentes.md (en portugués)

⚡ B · Reactor de prospectos

Estudia cómo una app de código abierto divide un pedido en tareas para agentes que las realizan y construye el flujo de prospectos.

  • Llega un prospecto → calificar → responder → agendar → hacer seguimiento (4 carriles)
  • El prospecto que no califica sale con el motivo por escrito
  • La pantalla celebra cuando el prospecto agenda

prompts/b-reator-de-leads.md (en portugués)

🌐 C · Sitio rehecho

Mapea tu sitio (secciones, fuentes, scripts, botones) y lo rehace en una versión prémium con tus palabras.

  • Forma 1: guarda la página con curl, sin instalar nada
  • Forma 2: el REA observa la página abierta en un Chrome local
  • Los mismos botones y destinos; sin inventar precios ni promesas

prompts/c-site-refeito.md (en portugués)

El verificador

confere_provas.py rechaza las suposiciones

Un archivo Python, solo con la biblioteca estándar y sin internet. Lee el provas.md y devuelve una nota de 0 a 10, APROVADO o REPROVADO y la lista de lo que falta. Sale con el código 0 (aprobado), 1 (reprobado) o 2 (no se pudo leer).

Reprueba cuando

  • falta la sección "O que NÃO deu para provar" (o está vacía);
  • una conclusión no cita un archivo o fragmento (por ejemplo: src/arquivo.ts:40-62);
  • todas las referencias apuntan a bibliotecas (node_modules, vendor, site-packages, dist, build, archivos .min.js…).

Avisa (sin reprobar) cuando

  • la prueba no indica la línea;
  • una conclusión solo cita una biblioteca, pero otras citan la app;
  • falta la línea "Licença:" en la sección "Alvo";
  • el título todavía tiene [corchetes] de la plantilla.

El ejemplo malo del repositorio, verificado (el verificador responde en portugués):

python3 confere_provas.py exemplos/provas-ruim.md
NOTA 0/10 — REPROVADO
Conclusões: 4 · com prova no código do app: 0

O que falta (reprova):
  ✗ Falta a seção "## O que NÃO deu para provar". Peça ao agente: "liste o que você acha mas não achou no código".
  ✗ "C1. O app usa uma arquitetura moderna baseada em microsserviços": conclusão sem prova. Falta o arquivo/trecho (ex.: `src/arquivo.ts:40-62`).
  ✗ "C4. Dá para refazer tudo em uma tarde": conclusão sem prova. Falta o arquivo/trecho (ex.: `src/arquivo.ts:40-62`).
  ✗ Todas as referências apontam para bibliotecas (node_modules, vendor, site-packages...). Mande o agente ignorar essas pastas e provar no código do app.

Avisos (não reprova, mas melhore):
  ! "C2. A grade de agentes é feita com uma biblioteca de layout": só cita biblioteca embutida; mostre onde o PRÓPRIO app usa isso.
  ! "C3. As animações deixam a experiência fluida e profissional": só cita biblioteca embutida; mostre onde o PRÓPRIO app usa isso.
  ! Sem a linha "Licença:" em "## Alvo". Confira se você pode estudar esse app.

El ejemplo bueno (exemplos/provas-boa.md) sale NOTA 10/10 — APROVADO. Los dos usan una app ficticia para mostrar el formato.

Requisitos previos

Lo que necesitas

El verificador funciona en cualquier computadora con Python. El REA es opcional: ayuda al agente a ver por dentro las apps y los sitios.

Python 3.8 o posterior

Para el verificador y las pruebas. Comprueba:

python3 --version

Un agente de IA en la terminal

Claude Code, Codex o el harness dsh (un agente de código que funciona en tu computadora). Cualquiera que lea archivos y ejecute comandos en la carpeta.

REA (opcional)

La instalación del REA, del harness y de un modelo abierto está en otra guía, paso a paso:

REA sin bloqueos — guía de instalación →

Paso a paso

Desde cero hasta tu versión

Comandos para Linux, Mac o WSL. En Windows sin WSL, cambia python3 por py.

1

Descarga el kit

Clona el repositorio en tu carpeta personal y verifica que el verificador funcione. Los siguientes pasos usan esa ruta.

cd ~   # el kit queda en tu carpeta personal: ~/rea-com-provas
git clone https://github.com/inematds/rea-com-provas.git
cd rea-com-provas
python3 -m unittest discover tests   # debe terminar con OK
2

Elige el objetivo y comprueba la licencia

Una app de código abierto (descarga el código) o tu propio sitio. Abre el archivo de licencia antes de cualquier otra cosa.

git clone https://github.com/[dono]/[app-open-source].git ~/estudo/app
cat ~/estudo/app/LICENSE   # ¿MIT, Apache-2.0, BSD, GPL…? Entonces puedes estudiar
3

Completa el brief de diseño

Copia la plantilla y cambia los [corchetes]: colores con código, fuentes, movimiento y densidad. La plantilla ya incluye un ejemplo completo con el estilo de INEMA.

cp brief/MODELO-brief-design.md ~/estudo/brief.md
4

Pega una de las 3 instrucciones en el agente

Abre el archivo en prompts/, cambia los [corchetes] y pega el bloque de texto en tu agente, abierto en la carpeta del estudio. Solo realiza la fase 1 (estudiar) y se detiene.

cd ~/estudo
claude   # o: codex — y pega el texto de prompts/a-painel-de-agentes.md
5

Revisa el provas.md

La propia instrucción le indica al agente que ejecute el verificador. Ejecútalo tú también: es tu «pide la prueba».

python3 ~/rea-com-provas/confere_provas.py provas.md
python3 ~/rea-com-provas/confere_provas.py provas.md --json   # mismo resultado en JSON

¿REPROVADO? Pega la lista «O que falta» de vuelta en el agente y pídele que lo corrija. Abre 2 o 3 pruebas en el editor y comprueba si el fragmento realmente está en esa línea: el verificador revisa el formato; quien comprueba el contenido eres tú.

6

Autoriza la construcción

Solo con APROVADO. Escribe en el agente:

pode construir

Al final, te dice cómo abrirlo, qué quedó fuera y qué necesita una prueba manual.

Prueba real

El sitio inema.club rehecho con la construcción C

El 08/11/2026 ejecutamos la construcción C (modo 1, sin REA) en Claude Code, con la suscripción, usando inema.club como "tu sitio". Las dos fases se ejecutaron de una vez, sin intervención. Números medidos.

23

conclusiones

Cada una con una línea del HTML guardado y un fragmento copiado.

10

nota del verificador

NOTA 10/10 — APROVADO, con las 23 conclusiones comprobadas en el código de la página.

4/4

pruebas revisadas a mano

Abrimos 4 líneas citadas (72, 113, 144, 161): el fragmento estaba allí.

7:52

minutos, las 2 fases

472 s y 42 turnos del agente. Se generó un index.html de 94 KB, sin desplazamiento horizontal en 390 px ni en 1440 px.

Sitio inema.club tal como estaba el 08/11/2026
Antes: el sitio publicado el 08/11/2026.
Versión premium hecha con la construcción C siguiendo el brief de diseño
Después: la versión de la fase 2, con el brief del estándar INEMA (fondo #0c0c10, amarillo #FACC15, Sora).

Lo que el propio agente señaló como límite: las fuentes y los colores del sitio original están en un CSS que no se guardó (solo se guardó el HTML), y no pudo abrir el navegador para probar el celular (lo comprobamos después). Archivos de la ronda en el repositorio: exemplos/rodada-real (en portugués) (pedido usado, provas.md, HTML guardado y versión nueva).

Verificador reprobando el ejemplo sin pruebas
exemplos/provas-ruim.md: NOTA 0/10 — REPROVADO.
Verificador aprobando el ejemplo con pruebas
exemplos/provas-boa.md: NOTA 10/10 — APROVADO.
Qué incluye el repositorio

Archivos del kit

ArchivoPara qué sirve
REGRAS.mdLas 4 reglas y el aviso de seguridad y licencia.
prompts/Las 3 instrucciones: a-painel-de-agentes, b-reator-de-leads, c-site-refeito.
provas/MODELO-provas.mdEl formato del archivo de pruebas que debe entregar el agente.
confere_provas.pyEl verificador: puntaje, APROVADO/REPROVADO y lo que falta.
brief/MODELO-brief-design.mdPlantilla del brief de diseño, con un ejemplo completo al estilo de INEMA.
exemplos/provas-boa.md (aprobada), provas-ruim.md (reprobada) y la ronda real.
tests/Pruebas del verificador, sin internet.