sanky369/product-photography

Fotografia de Produto

Transforme uma descrição de produto em uma lista de fotos coerente com especificações de prompt que geram imagens de produto de nível comercial. Regra primordial: um produto, um mundo visual. Cada foto em um conjunto compartilha a iluminação, a paleta e o tratamento da marca para que listagens, landing pages e postagens sociais sejam lidas como uma única marca — uma foto herói impressionante ao lado de uma foto de estilo de vida incompatível é pior do que duas fotos medianas e combinadas.

Quando usar / quando não usar

Use para qualquer imagem cujo assunto seja um produto: listagens de e-commerce, heróis de landing page, fotos de marketing, close-ups de detalhes. Passe adiante quando:

• O ativo é uma postagem de plataforma sobre o produto (overlays de texto, layouts promocionais) → skills/creative/social-graphics
• O usuário precisa de um logotipo/ícone/padrão → skills/creative/brand-asset
• É uma imagem geral sem assunto de produto → skills/creative/image-generation
• Não existe direção visual e vários ativos estão chegando → skills/creative/creative-strategist primeiro; consuma seu bloco de estilo aqui
• O produto deve se mover → skills/creative/product-video (os stills desta skill são seus quadros de origem)

Coleta de informações

Pergunte em um único lote, apenas o que estiver faltando:

1. Produto — o que é, exatamente? Materiais, cores, detalhes distintivos. (Se existir uma foto real, peça-a como referência para precisão.)
2. Destino — listagem, landing page, anúncios, redes sociais? (determina os tipos de foto e as proporções)
3. Posicionamento — premium/luxo, acessível, lúdico, técnico?
4. Âncora de estilo — Brief de Direção Criativa / bloco de estilo, ou cores da marca?
5. Automação — FAL_API_KEY configurada, ou entregar apenas as especificações?

Infira, não pergunte: proporções a partir do destino (listagem → 1:1, herói de landing page → 16:9, feed de rede social → 4:5); resolução 2K padrão, 4K para heróis. Não pare: com produto + destino conhecidos, assuma o resto, rotule, vá em frente.

Fluxo de trabalho

1. Construa a lista de fotos. Mapeie destino → tipos de foto (regras de decisão):

   • Listagem de e-commerce → 1 foto clean + 1–2 fotos de detalhes (+ 1 lifestyle se a plataforma permitir imagens em galeria)
   • Landing page → 1 foto herói + 1 lifestyle + 1 detalhe
   • Redes sociais/anúncios → 1–2 lifestyle + 1 flat lay (famílias de produtos) ou herói
   • "Apenas uma imagem" → escolha o único tipo que atenda ao uso declarado; diga o porquê

2. Defina o tratamento compartilhado. Escolha um estilo de iluminação e uma paleta para todo o conjunto a partir do bloco de estilo (ou infira do posicionamento: premium → dramático ou estúdio; acessível → hora dourada natural; marca minimalista → high-key). Cada especificação do conjunto o utiliza.

3. Escreva uma especificação de prompt por foto usando os modelos em references/shot-library.md — leia-o agora; ele contém os cinco modelos de tipo de foto mais a linguagem de prompt de iluminação/fundo/composição. Nomeie as cores em palavras e hex. Sempre declare o que NÃO deve aparecer (sem marca d'água, sem logotipos inventados ou texto de rótulo, a menos que o texto exato seja fornecido, sem bagunça).

4. Variantes. Fotos herói e clean recebem 3–4 variantes (--num-images 3 ou especificações distintas variando composição/fundo); fotos de detalhe e lifestyle recebem 2. O usuário escolhe as vencedoras.

5. Gere ou entregue. Se FAL_API_KEY (ou FAL_KEY) estiver configurada:

   python docs/creative_cli.py product \
     --product-name "Relógio de Luxo" \
     --prompt "<prompt completo>" \
     --aspect-ratio 1:1 --resolution 2K --num-images 3
   

   As imagens são salvas em assets/product-photography/<slug-do-produto>/ como <produto>_<n>_<timestamp>.png. Se não houver chave, entregue as especificações mais os comandos exatos — nunca afirme que a geração ocorreu. Referência completa de parâmetros: skills/creative/image-generation/references/automation.md.

6. Revise de acordo com o padrão de qualidade, corrija falhas com as frases de correção em references/shot-library.md (uma rodada de iteração), então apresente as vencedoras com os caminhos dos arquivos e uma recomendação de uma linha por slot.

Formato de saída obrigatório

Entregue uma lista de fotos com estes blocos (um por foto):

## Spec da Foto — [nome da foto, ex. hero-01]
- **Tipo de foto:** clean / lifestyle / hero / detail / flat lay
- **Destino:** [listagem / herói de landing page / anúncio / rede social]
- **Assunto:** [produto, concretamente — materiais, cores, orientação]
- **Cenário / fundo:** [branco / gradiente X→Y / cenário de lifestyle / texturizado]
- **Iluminação:** [estúdio / hora dourada natural / rim dramática / high-key]
- **Composição:** [centralizado / regra dos terços / espaço negativo / vista superior]
- **Clima:** [2–3 adjetivos, do bloco de estilo]
- **Proporção:** [proporção] · **Resolução:** [1K/2K/4K] · **Formato:** png
- **Restrições negativas:** [sem marca d'água, sem texto de rótulo inventado, ...]
- **Prompt (final, pronto para colar):**
  > [prompt único e fluido]
- **Variantes:** [n] — [o que varia]
- **Nomeação de arquivo:** assets/product-photography/<slug-do-produto>/<produto>_<n>_<timestamp>.png
- **Gerar com:** `python docs/creative_cli.py product --product-name "..." --prompt "..." --aspect-ratio ... --resolution ... --num-images n`

Finalize com um Resumo do conjunto: linha de iluminação/paleta compartilhada, contagem de fotos por tipo e (se gerado) vencedor recomendado por slot com caminhos salvos.

Padrão de qualidade

• Cada foto do conjunto compartilha um estilo de iluminação e paleta (o conjunto é lido como uma única marca)
• Cada especificação nomeia explicitamente tipo de foto, fundo, iluminação, composição e clima
• A proporção corresponde ao destino, não ao padrão 1:1 por inércia
• Os detalhes do produto (materiais, cores) correspondem ao que o usuário descreveu — sem características, gravações ou textos de rótulo inventados
• Restrições negativas presentes em cada especificação
• Fotos herói/clean têm 3+ variantes; nada enviado como take único
• Apenas parâmetros reais de automação usados (o modelo é fal-ai/nano-banana-pro; não existem knobs de tamanho/passos/guidance)

Proibições rígidas: nunca renderize texto legível de marca/rótulo a menos que o usuário tenha fornecido a string exata; nunca misture iluminação dramática premium e estilos de snapshot casuais em um conjunto; nunca apresente imagens de IA como fotografias reais da unidade física do usuário — se a fidelidade ao produto físico exato for importante, diga e recomende composição ou um fluxo de trabalho com foto de referência.

Integração

• skills/creative/creative-strategist → upstream; seu bloco de estilo define os campos de iluminação, paleta e clima deste conjunto.
• skills/creative/image-generation → automação e disciplina de prompt compartilhadas; skills/creative/image-generation/references/automation.md é a fonte da verdade dos parâmetros.
• skills/creative/social-graphics → consome as fotos vencedoras como matéria-prima para postagens em plataformas.
• skills/creative/product-video → consome os stills herói/lifestyle como quadros e direção de arte.
• references/shot-library.md — modelos completos de tipo de foto, linguagem de prompt de iluminação/fundo/composição e frases de correção. Leia antes de escrever especificações.