# Previews, artefactos y correcciones

El artefacto es una interfaz visual que genera tu agente para este proyecto. Puede mostrar propuestas, un video de muestra o la entrega. No es otro editor que trabaja por su cuenta.

## En computadora

El flujo principal es local: se abre un HTML con una copia ligera del video. Puedes reproducirlo, señalar un momento y escribir qué quieres cambiar. Según lo que incluya ese artefacto, puedes revisar texto/transcripción, decisiones o comparaciones disponibles.

**Los botones del HTML local no envían trabajo automáticamente al agente.** Preparan un mensaje con tu elección o comentarios. Cópialo y pégalo en el mismo chat de Claude/Codex para continuar. Si un host no muestra HTML dentro del chat, abre el archivo en el navegador.

## En el teléfono

Una URL `localhost` de la computadora no funciona por sí sola en tu teléfono. Pide una revisión web: se prepara y sube una copia ligera autorizada, se registra con su proyecto y se entrega un enlace comprobado. No necesitas subir originales ni masters para cada iteración.

Los enlaces privados/compartidos y las revisiones de equipo tienen permisos y vencimientos distintos. No asumas que cualquier persona con una cuenta puede ver tu material.

## Corrige un momento, conserva el resto

> En 00:08–00:11 cambia el gráfico por una captura del producto. Conserva el audio, los subtítulos y el resto del montaje.

La corrección debe estar vinculada a una versión. Si ya hay una nueva, el agente debe comprobar si sigue aplicando; no marcarla resuelta solo por leerla. Aprobar significa aprobar esa muestra y contexto, no todas las versiones futuras.

## Para automatizaciones

Un artefacto local se crea a partir de un JSON. Este ejemplo requiere un MP4 real y ligero en la ruta indicada:

```json
{
  "schemaVersion": 1,
  "projectId": "mi-proyecto",
  "version": "preview-v1",
  "title": "Primera revisión",
  "stage": "review",
  "video": {"file": ".editorbrain-local/previews/revision.mp4"}
}
```

```sh
editorbrain production review-artifact --file review.json --out .editorbrain-local/revision-v1.html
```

El modo local crea un HTML ligero, un manifiesto y una carpeta con las copias de preview. Conserva los tres juntos. Para abrirlo:

```sh
editorbrain production review-open --file .editorbrain-local/revision-v1.html
```

Mantén ese proceso abierto y usa la URL que devuelva en el panel de navegador de Claude Code Desktop, Codex o el navegador de tu computadora. El agente debe comprobar reproducción, saltos en el video y comentarios; la comprobación HTTP no certifica la reproducción. Para cerrar el servidor usa Ctrl+C. Guarda o exporta tus notas antes de cerrarlo o cambiar de puerto: los borradores pertenecen al navegador y puerto usados.

Cada medio admite hasta 24 MiB. `--media-mode embedded` conserva la exportación de un solo HTML; puede superar el límite del visor del chat. No pegues el video en base64 al agente ni publiques sus archivos para intentar evitar ese límite. El servidor solo funciona en esa computadora; para teléfono usa la revisión privada del proyecto con una subida autorizada. El comando crea la interfaz; no crea el MP4. Los estados son `directions`, `review` y `delivery`. No fabriques imágenes de preview ni declares un render inexistente.

## Revisión técnica y editorial

```sh
editorbrain production verify --project mi-proyecto --file ./renders/final.mp4
editorbrain production review-sheet --file ./renders/final.mp4 --out .editorbrain-local/hoja --platform reels
```

La revisión técnica analiza el archivo y produce evidencia. Las zonas seguras son ayudas; para detectar texto/logos tapados hace falta geometría o inspección. Una hoja de cuadros no acredita que se haya escuchado el audio ni visto todo el movimiento.

El agente también revisa cortes de palabras, ideas omitidas, ritmo, rostro, texto, sonido y parecido editorial con las referencias elegidas. Un informe técnico aprobado no convierte automáticamente el proyecto en terminado.