# Instrucciones para el agente: Compositor: edita imágenes por capas junto a 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/robbietilton/Compositor (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/compositor

---

## 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 la aplicación

Comprueba que tienes Apple silicon y macOS 26.0 o posterior. Descarga la aplicación desde las [releases oficiales](https://github.com/robbietilton/Compositor/releases/latest). El README también documenta esta instalación con Homebrew:

```sh
brew install --cask robbietilton-compositor
```

### Paso 2: crea un proyecto de prueba

Abre Compositor 1.3 o posterior. Crea y guarda un lienzo como `demo.comp` en una ubicación accesible a tu agente. Déjalo abierto. Trabaja con una copia si ya contiene material importante.

### Paso 3: pide una modificación por capas

Da al agente la [guía oficial del formato](https://github.com/robbietilton/Compositor/blob/HEAD/docs/writing-comp-files.md), la ruta absoluta de tu proyecto y una tarea breve. Pide que cambie una o dos capas cada vez.

El agente debe conservar los identificadores de las capas existentes y `documentID`, guardar primero los PNG y reemplazar después el manifiesto mediante un archivo temporal. Las imágenes de las capas son PNG RGBA de 8 bits; las máscaras, PNG en escala de grises de 8 bits.

## Comprobación

Mira si aparece la capa nueva y si puedes editarla manualmente. Comprueba que opacidad y posición coinciden con el resultado pedido. Guarda los cambios antes de alternar otra vez con el agente; una recarga elimina el historial de deshacer.

## Si algo falla

Si el lienzo no cambia, revisa que el manifiesto sea JSON válido, que los nombres PNG coincidan con los identificadores en mayúsculas y que todas las imágenes referenciadas existan. Los modos de mezcla deben usar el nombre exacto de la guía. Si una imagen nueva ocupa exactamente los mismos bytes que la anterior, cambia también un dato del manifiesto para que se detecte la actualización.