sanky369/product-photography

Fotografía de Producto

Convierte una descripción de producto en un lista de tomas coherente con especificaciones de prompt que generen imágenes de producto de grado comercial. Regla principal: un producto, un mundo visual. Cada toma de un conjunto comparte la iluminación, paleta y tratamiento de la marca, de modo que los listados, landing pages y publicaciones sociales se lean como una sola marca —una hero impresionante junto a una toma lifestyle que no combina es peor que dos tomas promedio que sí combinan.

Cuándo usar / cuándo no

Utilízalo para cualquier imagen cuyo sujeto sea un producto: listados de e-commerce, heroes de landing page, tomas de marketing, primeros planos de detalle. Deriva en su lugar cuando:

• El activo es un post de plataforma sobre el producto (superposiciones de texto, diseños promocionales) → skills/creative/social-graphics
• El usuario necesita un logotipo/icono/patrón → skills/creative/brand-asset
• Es una imagen general sin sujeto de producto → skills/creative/image-generation
• No existe dirección visual y se generarán múltiples activos → skills/creative/creative-strategist primero; consumir su bloque de estilo aquí
• El producto debe moverse → skills/creative/product-video (los fotogramas fijos de esta skill son sus fotogramas fuente)

Captura inicial

Pregunta en un solo lote, solo lo que falte:

1. Producto — ¿qué es exactamente? Materiales, colores, detalles distintivos. (Si existe una foto real, pídela como referencia para precisión.)
2. Destino — listado, landing page, anuncios, redes sociales? (determina los tipos de toma y relaciones de aspecto)
3. Posicionamiento — premium/lujo, accesible, divertido, técnico?
4. Ancla de estilo — Brief de Dirección Creativa / bloque de estilo, o colores de marca?
5. Automatización — FAL_API_KEY configurada, o solo entregar especificaciones?

Infiera, no pregunte: relaciones de aspecto según destino (listado → 1:1, hero de landing → 16:9, feed social → 4:5); resolución 2K por defecto, 4K para heroes. No se detenga: con producto + destino conocidos, asuma el resto, etiquételo y avance.

Flujo de trabajo

1. Construir la lista de tomas. Mapear destino → tipos de toma (reglas de decisión):

   • Listado de e-commerce → 1 toma limpia + 1–2 tomas de detalle (+ 1 lifestyle si la plataforma permite imágenes en galería)
   • Landing page → 1 hero + 1 lifestyle + 1 detalle
   • Redes/anuncios → 1–2 lifestyle + 1 flat lay (familias de productos) o hero
   • "Solo una imagen" → elegir el único tipo que sirva al uso indicado; decir por qué

2. Fijar el tratamiento compartido. Elegir un estilo de iluminación y una paleta para todo el conjunto desde el bloque de estilo (o inferir del posicionamiento: premium → dramático o estudio; accesible → hora dorada natural; marca minimalista → high-key). Cada especificación del conjunto lo usa.

3. Escribir una especificación de prompt por toma usando las plantillas en references/shot-library.md — léalo ahora; contiene las cinco plantillas de tipos de toma más el lenguaje de prompt de iluminación/fondo/composición. Nombrar colores en palabras y hex. Indicar siempre lo que NO debe aparecer (sin marca de agua, sin logotipos o texto de etiqueta inventados a menos que se proporcione el texto exacto, sin desorden).

4. Variantes. Las tomas hero y limpias obtienen 3–4 variantes (--num-images 3 o especificaciones distintas variando composición/fondo); las tomas de detalle y lifestyle obtienen 2. El usuario elige las ganadoras.

5. Generar o entregar. Si FAL_API_KEY (o FAL_KEY) está configurada:

   python docs/creative_cli.py product \
     --product-name "Luxury Watch" \
     --prompt "<prompt completo>" \
     --aspect-ratio 1:1 --resolution 2K --num-images 3
   

   Las imágenes se guardan en assets/product-photography/<slug-del-producto>/ como <producto>_<n>_<timestamp>.png. Si no hay clave, entregar las especificaciones más los comandos exactos —nunca afirmar que se generó. Referencia completa de parámetros: skills/creative/image-generation/references/automation.md.

6. Revisar contra el estándar de calidad, corregir fallos con las frases de corrección en references/shot-library.md (una ronda de iteración), luego presentar las ganadoras con rutas de archivo y una recomendación de una línea por espacio.

Formato de salida requerido

Entregar una lista de tomas con estos bloques (uno por toma):

## Especificación de Toma — [nombre de toma, ej. hero-01]
- **Tipo de toma:** clean / lifestyle / hero / detalle / flat lay
- **Destino:** [listado / hero de landing / anuncio / social]
- **Sujeto:** [producto, concretamente — materiales, colores, orientación]
- **Entorno / fondo:** [blanco / degradado X→Y / entorno lifestyle / texturizado]
- **Iluminación:** [estudio / hora dorada natural / dramática de borde / high-key]
- **Composición:** [centrado / regla de tercios / espacio negativo / cenital]
- **Estado de ánimo:** [2–3 adjetivos, del bloque de estilo]
- **Relación de aspecto:** [relación] · **Resolución:** [1K/2K/4K] · **Formato:** png
- **Restricciones negativas:** [sin marca de agua, sin texto de etiqueta inventado, ...]
- **Prompt (final, listo para pegar):**
  > [prompt continuo]
- **Variantes:** [n] — [qué varía]
- **Nombre de archivo:** assets/product-photography/<slug-del-producto>/<producto>_<n>_<timestamp>.png
- **Generar con:** `python docs/creative_cli.py product --product-name "..." --prompt "..." --aspect-ratio ... --resolution ... --num-images n`

Cerrar con un Resumen del conjunto: línea de iluminación/paleta compartida, recuento de tomas por tipo, y (si se generó) ganador recomendado por espacio con rutas guardadas.

Estándar de calidad

• Cada toma del conjunto comparte un estilo de iluminación y una paleta (el conjunto se lee como una sola marca)
• Cada especificación nombra explícitamente tipo de toma, fondo, iluminación, composición y estado de ánimo
• La relación de aspecto coincide con el destino, no con el valor por defecto 1:1 por inercia
• Los detalles del producto (materiales, colores) coinciden con lo que describió el usuario —sin características, grabados ni texto de etiqueta inventados
• Restricciones negativas presentes en cada especificación
• Las tomas hero/limpias tienen 3+ variantes; nada se entrega como toma única
• Solo se usan parámetros de automatización reales (el modelo es fal-ai/nano-banana-pro; no existen controles de tamaño/pasos/guidance)

Prohibiciones estrictas: nunca renderizar texto legible de marca/etiqueta a menos que el usuario haya proporcionado la cadena exacta; nunca mezclar iluminación dramática premium y estilos de instantánea casual en un mismo conjunto; nunca presentar imágenes de IA como fotografías reales de la unidad física del usuario —si la fidelidad al producto físico exacto es importante, decirlo y recomendar composición o un flujo de trabajo con foto de referencia.

Integración

• skills/creative/creative-strategist → aguas arriba; su bloque de estilo define los campos de iluminación, paleta y estado de ánimo de este conjunto.
• skills/creative/image-generation → automatización compartida y disciplina de prompt; skills/creative/image-generation/references/automation.md es la fuente de verdad de parámetros.
• skills/creative/social-graphics → consume las tomas ganadoras como material bruto para posts de plataforma.
• skills/creative/product-video → consume los fotogramas fijos hero/lifestyle como fotogramas y dirección de arte.
• references/shot-library.md — plantillas completas de tipos de toma, lenguaje de prompt de iluminación/fondo/composición y frases de corrección. Leer antes de escribir especificaciones.