# Instrucciones para el agente: pi-autoresearch: optimiza código con experimentos medidos

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: avanzado
- Proyecto: https://github.com/davebcn87/pi-autoresearch (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/pi-autoresearch-experiments

---

## 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

Comprueba Node.js ≥22, mínimo del [paquete](https://github.com/davebcn87/pi-autoresearch/blob/main/package.json), y que pi abre una sesión con tu proveedor configurado. Trabaja en una rama o un espacio de trabajo Git separado, con el árbol limpio, y revisa los scripts de medición antes de instalar. Instala la extensión desde pi:

```sh
pi install npm:pi-autoresearch
pi
```

Dentro de pi, el README propone:

```
/autoresearch optimiza el tiempo de las pruebas unitarias y vigila que sigan siendo correctas
```

Adapta el objetivo a tu proyecto y define la medición antes de dejar correr el bucle.

## Comprobación

Comprueba que un experimento registra la métrica y que los tests de corrección siguen pasando. Al terminar la prueba pulsa Escape para interrumpir o usa `/autoresearch finalize`, que detiene el bucle y prepara las ramas de revisión. El ciclo continúa hasta que se interrumpe. Inspecciona los cambios conservados antes de usarlo.

## Si algo falla

Si los resultados varían demasiado, estabiliza los datos y la prueba comparativa. Si no hay un objetivo comprobable, detén el ciclo y redefine la tarea.

Consulta [el README oficial](https://github.com/davebcn87/pi-autoresearch#readme) para requisitos y variantes de instalación.