# Instrucciones para el agente: Super Simple Software Factory: ejecuta fases con controles en código

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/disler/super-simple-software-factory (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/super-simple-software-factory

---

## 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, uv, Python, Pi en PATH, sqlite3 y just para los comandos siguientes. El README no fija una versión mínima de Python; uv resuelve las dependencias declaradas en cada script. Para instalar Pi por npm necesitas npm y Node.js ≥20.6.0, declarado en el [paquete actual](https://www.npmjs.com/package/@mariozechner/pi-coding-agent); el comando es `npm install -g @mariozechner/pi-coding-agent`. Bun solo es necesario para el visor opcional. Abre la raíz del proyecto de ensayo y revisa el proveedor de cada agente antes de copiar la skill.

### Paso 1: prepara una copia y revisa las fases

Obtén el repositorio y lee `.claude/skills/sssf`. En un proyecto de ensayo copia la carpeta siguiendo el README:

```bash
mkdir -p .claude/skills
cp -r /path/to/super-simple-software-factory/.claude/skills/sssf .claude/skills/
```

Sustituye la ruta del ejemplo por tu copia real.

### Paso 2: instala la estructura

Desde la raíz del proyecto de ensayo:

```bash
uv run .claude/skills/sssf/scripts/install.py
pi --version
```

Copia `.env.sample` a `.env` y configura `OPENROUTER_API_KEY` para el agente scout de la demostración, según el README. Revisa `~/.pi/agent/models.json`: ese mapeo sirve `google/gemini-3.6-flash` a través de OpenRouter. Si cambias el modelo o proveedor, adapta también ese mapeo y la clave; no deduzcas el destino solo del prefijo del ID. La plantilla completa añade `FIREWORKS_API_KEY` y `OPENAI_API_KEY` para otros agentes, que esta prueba de scout no necesita.

### Paso 3: prueba lectura

La comprobación inicial documentada es:

```bash
just demo
just sessions
```

## Comprobación

Comprueba que el recorrido de lectura termina, que hay eventos de las fases y que los criterios rechazan entregables ausentes. Revisa la configuración antes de habilitar cadenas que escriban o hagan commits.

## Si algo falla

Si Pi no está disponible, corrige su instalación o la ruta admitida por el proyecto. Si falta just, consulta la forma directa con uv que publica el README.

Consulta el [README oficial](https://github.com/disler/super-simple-software-factory#readme) para el procedimiento completo y los cambios de versión.