# Instrucciones para el agente: OpenMontage: organiza la producción de vídeo con tu agente

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: intermedio
- Proyecto: https://github.com/calesthio/OpenMontage (licencia AGPL-3.0)
- Guía completa: https://lab.wisd.ai/hub/openmontage-video-agent

---

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

### Paso 1: instala en una carpeta propia

Comprueba que tienes Git, make, Python ≥3.10, FFmpeg y Node.js ≥22 con npm/npx antes de ejecutar la preparación. El README pide Node ≥18, pero el [Makefile](https://github.com/calesthio/OpenMontage/blob/main/Makefile) también descarga HyperFrames mediante npx, cuyo [manifiesto publicado](https://registry.npmjs.org/hyperframes/latest) exige ≥22. Python necesita venv y pip, o uv para crear ese entorno. Elige después la ruta multimedia que pueda funcionar con tus medios o proveedores.

```bash
git clone https://github.com/calesthio/OpenMontage.git
cd OpenMontage
make setup
```

### Paso 2: prepara al agente

La preparación crea `.venv`, instala las dependencias Python y el compositor Remotion, y prepara la configuración local. Activa el entorno desde la raíz:

```bash
source .venv/bin/activate
```

Comprueba la capacidad real con el comando del README:

```bash
python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.support_envelope(), indent=2))"
```

Abre esa raíz en tu agente y haz que lea `AGENT_GUIDE.md` y `PROJECT_CONTEXT.md`. Pide una pieza breve y define duración, material permitido y criterio de aprobación. Selecciona el manifiesto de la cadena de producción antes de generar medios.

## Comprobación

Comprueba que las herramientas requeridas están disponibles. Revisa guion y recursos antes de renderizar, y reproduce el archivo final con audio.

## Si algo falla

Si falta una capacidad, consulta el catálogo de proveedores y la ruta elegida. No sustituyas una pieza con metraje por imágenes sin ajustar la propuesta.