# Instrucciones para el agente: ProofShot: reúne evidencias de verificación en el navegador

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: principiante
- Proyecto: https://github.com/AmElmo/proofshot (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/proofshot-verification

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

Comprueba Node.js ≥24 y npm para esta ruta con la versión actual de agent-browser. ProofShot por sí solo declara Node.js ≥18, pero el [paquete npm de agent-browser](https://github.com/vercel-labs/agent-browser/blob/main/package.json) exige ≥24. Abre la carpeta de una aplicación con un script `npm run dev` que escuche en el puerto 3000; adapta el ejemplo oficial si tu proyecto usa otro comando o puerto.

El manifiesto de ProofShot marca agent-browser como dependencia opcional. Para completar la preparación en una máquina nueva, instala primero [agent-browser y Chrome con su procedimiento oficial](https://github.com/vercel-labs/agent-browser#installation), y después ProofShot y su skill. En Linux sigue también las dependencias del sistema de ese README:

```bash
npm install -g agent-browser
agent-browser install
npm install -g proofshot
proofshot install
```

Desde la carpeta de tu aplicación, inicia el ejemplo oficial:

```bash
proofshot start --run "npm run dev" --port 3000 --description "Verificación de la página inicial"
```

Usa el paso intermedio `exec` del README para conservar la sesión aislada que abrió ProofShot:

```bash
proofshot exec open http://localhost:3000
proofshot exec snapshot -i
proofshot exec screenshot step-inicio.png
```

Comprueba que la captura muestra tu página. Para probar una interacción, obtén sus referencias actuales con `snapshot -i` antes de usar `exec click` o `exec fill`; no copies referencias de otro sitio. Al terminar, genera los entregables:

```bash
proofshot stop
```

Revisa los entregables localmente antes de subirlos.

## Comprobación

Abre la carpeta fechada indicada bajo `proofshot-artifacts/`: contiene `session.webm`, `viewer.html`, `SUMMARY.md` y la captura. Comprueba que vídeo, capturas y errores corresponden al recorrido realizado y permiten revisar el cambio.

## Si algo falla

Verifica que la aplicación responde y que agent-browser puede abrirla antes de iniciar otra grabación.