# Instrucciones para el agente: StorePilot: combina decisiones y aprobaciones en tu tienda

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/mh-anwar/StorePilot
- Guía completa: https://lab.wisd.ai/hub/storepilot

---

## 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 Git, pnpm y Node.js ≥20.9, mínimo de Next.js 16.2.3 usado por el proyecto. Descarga el código y abre su raíz. Prepara una base de ensayo Neon Postgres accesible por su API HTTP y la configuración local antes de ejecutar las migraciones.

### Paso 1: prepara el entorno de ensayo

Descarga con `git clone https://github.com/mh-anwar/StorePilot.git`, entra con `cd StorePilot` y copia la plantilla con `cp .env.example .env.local`. El [driver del código](https://github.com/mh-anwar/StorePilot/blob/main/src/lib/db/index.ts) usa `drizzle-orm/neon-http`: utiliza la URL de una base Neon de ensayo; una instancia Postgres local sin proxy Neon no completa esta ruta. Apunta la base de datos a un entorno desechable. Crea la configuración local a partir de la plantilla del README y completa DATABASE_URL, APP_ENCRYPTION_KEY y SESSION_SECRET antes de instalar y migrar.

### Paso 2: instala y prepara el esquema

Los comandos documentados son:

```bash
pnpm install
pnpm tsx scripts/migrate-tenancy.ts
pnpm tsx scripts/migrate-new-tables.ts
pnpm tsx scripts/migrate-jobs.ts
pnpm tsx scripts/migrate-workflows.ts
pnpm db:seed
pnpm dev
```

No ejecutes migraciones ni seed contra una base con datos reales.

### Paso 3: prueba la compuerta

Abre http://localhost:3000. Crea un workspace en `/signup`, prepara un flujo en `/dashboard/workflows` y revisa su propuesta en `/dashboard/proposals`. Utiliza primero la tienda de demostración.

## Comprobación

Comprueba que una acción con aprobación queda pendiente y no modifica datos hasta aprobar. Rechaza otra propuesta y contrasta el resultado con el registro de ejecución.

## Si algo falla

Si los flujos manuales funcionan pero los programados no avanzan, revisa el worker `/api/jobs/tick` y la cola según el README. Si falta la tienda, confirma si estás usando el modo demo o la conexión Shopify.

Consulta el [README oficial](https://github.com/mh-anwar/StorePilot#readme) para el procedimiento completo y los cambios de versión.