Documentação e arquitetura do sistema **Nano Banana 2 Image…
INEMA
Nao é sobre o skill mas um video valido
quando
📂 Estrutura do Sistema — Image Generation (Nano Banana 2)⌗
Você tem 4 arquivos com funções diferentes e complementares:
1️⃣ orientation.md (guia)⌗
- 👉 Arquivo principal
- 👉 Função: Orquestrador do sistema
📌 O que ele faz⌗
Ele define:
- Quando ativar geração de imagem
- O fluxo completo (1–6)
- Estratégia de autenticação
- Lógica de polling
- Extração de URL
- Tratamento de erros
- Batch generation
Ele não é a skill em si, mas o manual operacional.
🧠 Papel no sistema⌗
É o cérebro organizador.
Ele diz:
- Quando usar o enhancement
- Quando chamar a API
- Como reagir a falhas
- Como entregar o resultado
2️⃣ prompt-enhancement.md⌗
📄 Referência técnica do motor de melhoria de prompt
📌 O que ele contém⌗
- 14 categorias de estilo
- Prefixos e sufixos de qualidade
- 6 regras obrigatórias
- Specificity boosters
- Template de montagem do prompt
- Biblioteca de linguagem fotográfica e artística
🧠 Papel no sistema⌗
É o motor de qualidade visual.
Ele transforma:
"a cat on a windows"
em
Prompt cinematográfico, técnico e profissional
Sem ele, o sistema vira apenas um wrapper de API.
3️⃣ api-reference.md⌗
📄 Especificação técnica da Kie.ai
📌 O que ele contém⌗
- Endpoints
- Headers
- Formato do request
- Parâmetros suportados
- Estratégia de polling
- Estados da task
- Cadeia de extração da URL (9 níveis)
- Tratamento de erro
🧠 Papel no sistema⌗
É o manual de integração técnica.
Sem ele:
- Você não sabe como montar o POST
- Não sabe extrair o taskId
- Não sabe parsear
resultJson - Não sabe como encontrar a URL final
Ele garante robustez.
4️⃣ CLAUDE (13).md⌗
📄 Regras de frontend e workflow visual
📌 O que ele contém⌗
- Regras obrigatórias de execução
- Uso de localhost
- Screenshot workflow
- Guardrails de design
- Regras anti-genéricas
- Padrões de tipografia, cores, animações
🧠 Papel no sistema⌗
Ele não faz parte direta da geração da imagem via API.
Mas ele é o manual de execução visual para projetos frontend, garantindo:
- Consistência estética
- Qualidade de layout
- Workflow disciplinado
Ele é um manual de produção visual, não de geração de imagem API.
🧩 Como os 4 trabalham juntos⌗
Fluxo real:
Usuário pede imagem
↓
orientation.md
↓
prompt-enhancement.md (melhora prompt)
↓
api-reference.md (envia para Kie.ai)
↓
Imagem retorna
↓
Entrega estruturada ao usuário
Separadamente:
CLAUDE.md
↓
Controla padrões de frontend
🏗 Arquitetura Conceitual⌗
| Arquivo | Tipo | Papel |
|---|---|---|
| orientation.md | Manual operacional | Orquestra o sistema |
| prompt-enhancement.md | Engine criativa | Eleva qualidade do prompt |
| api-reference.md | Engine técnica | Integra com Kie.ai |
| CLAUDE.md | Manual visual | Regra projetos frontend |
🎯 Conclusão Estratégica⌗
Você montou um sistema com:
- 🔥 Motor criativo (enhancement)
- ⚙️ Motor técnico (API)
- 🧠 Orquestrador (orientation)
- 🎨 Guardrails visuais (Claude rules)
Isso é muito mais que uma “skill”. É uma infraestrutura modular de geração visual.
📘 Apresentação — Nano Banana 2 Image Generation System⌗
O documento “Nano Banana 2 — Image Generation Skill” não é apenas uma skill operacional, mas sim um manual estratégico completo de geração de imagens via Kie.ai.
Ele define toda a arquitetura de funcionamento do sistema, incluindo:
- Lógica de detecção de estilo
- Motor de prompt enhancement
- Estrutura de requisição à API
- Estratégia de polling
- Extração robusta de URL
- Tratamento progressivo de erros
- Batch generation
- Integração com arquivos de referência técnicos
Em vez de ser apenas um gatilho simples de execução, este documento funciona como um framework de geração de imagens, centralizando regras, padrões e boas práticas que garantem consistência e qualidade profissional nos resultados.
Por isso, ele deve ser tratado como:
Documento de orientação (orientation.md) e não como uma skill simples (skill.md).
A skill em si deve ser leve e apenas ativar esse motor. Já este documento é o que garante que a execução seja estruturada, robusta e escalável.
Separar “skill” de “orientação” torna o sistema mais modular, mais fácil de manter e preparado para evoluções futuras (novos modelos, novas APIs ou melhorias no motor de enhancement).
Skill para NanoBanana 2
1