iron-edge 2.37.1 → 2.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -260,7 +260,7 @@ O que esperar:
260
260
 
261
261
  **Funil e precificação** (desde a 2.14.0): o retrato dos anúncios traz o funil (parou nos 3 s, ficou assistindo, clicou no link, clique virou visita, visita virou carrinho, carrinho virou checkout, checkout virou compra, compras por visita, vezes por pessoa) e o resultado de cada campanha no nome certo ("engajamentos" não cai em "compras"). A skill `anuncios` lê a régua em `skills/anuncios/funil.md` e responde onde o funil vaza e, com a precificação preenchida na aba Anúncios, o CPA real contra o máximo (sobra, paga a conta, prejuízo). Na skill `loja`, "custos da loja" grava o custo dos produtos na Shopify (você confirma antes; só o custo passa). Desde a 2.14.1 o Iron lê sempre o texto das peças (inclusive as de vídeo) e a aba diz quantas conferiu.
262
262
 
263
- **Imagens** (skill `imagens`, desde a 2.15.0): no chat, "gera uma imagem do <produto> pro feed" (ou story, quadrado, banner). O Iron monta o pedido com o produto e a marca da loja, mostra quanto vai custar na sua conta do provedor e só gera no seu sim. Quem gera é o site, com a chave da OpenAI ou do fal que você cola em Integrações → Imagens (fica cifrada no servidor, nunca volta pro computador); a imagem fica na aba Imagens da loja, no tamanho certo do destino. As regras da casa (sem logo desenhado, roupa lisa, sem texto) ficam em `skills/imagens/regras.md`. Desde a 2.16.0: com produto da Shopify, a imagem nasce da **foto real** dele (sai a mesma peça, muda a cena); "sobe essa na página do produto" põe a imagem na Shopify depois do seu sim (e "tira essa da Shopify" desfaz); sem chave de provedor, o Iron entrega o **pedido pronto** pra você colar na ferramenta de imagem que já usa, com a foto do produto anexada. Na aba Imagens, o botão **Pedir imagem** monta o pedido e leva pro chat. Desde a 2.16.1, a imagem com a foto real mantém a marcação do próprio produto (logo, selo, texto impresso); pra tirar, peça "sem a marcação". Desde a 2.37.0 (plugin 0.29.0): com duas ou mais imagens, o Iron mostra as **miniaturas** no chat e você clica na que quer; na aba Imagens, o botão **Escolhi esta** faz o mesmo. O Iron traz o **arquivo original** pro cofre (`Projetos/<loja>/marca/originais/`, ferramenta `image_get`), nunca redesenha a imagem que você aprovou, e o logo aprovado sai também **sem fundo** (PNG transparente, recortado pelo site quando o fundo é liso). Desde a 2.37.1 (plugin 0.29.1): peça "vetorize a logo" e o **site** faz o vetor (SVG) do logo de uma cor só sobre fundo liso, mede se ficou igual e manda um link pra você comparar o original com o vetor; só no seu "Sim, ficou igual" o vetor entra no kit, em cor, preto e branco (`marca/vetor/`). O Iron nunca traça, converte ou redesenha por conta própria.
263
+ **Imagens** (skill `imagens`, desde a 2.15.0): no chat, "gera uma imagem do <produto> pro feed" (ou story, quadrado, banner). O Iron monta o pedido com o produto e a marca da loja, mostra quanto vai custar na sua conta do provedor e só gera no seu sim. Quem gera é o site, com a chave da OpenAI ou do fal que você cola em Integrações → Imagens (fica cifrada no servidor, nunca volta pro computador); a imagem fica na aba Imagens da loja, no tamanho certo do destino. As regras da casa (sem logo desenhado dentro da cena, roupa lisa, sem texto) ficam em `skills/imagens/regras.md`. Desde a 2.16.0: com produto da Shopify, a imagem nasce da **foto real** dele (sai a mesma peça, muda a cena); "sobe essa na página do produto" põe a imagem na Shopify depois do seu sim (e "tira essa da Shopify" desfaz); sem chave de provedor, o Iron entrega o **pedido pronto** pra você colar na ferramenta de imagem que já usa, com a foto do produto anexada. Na aba Imagens, o botão **Pedir imagem** monta o pedido e leva pro chat. Desde a 2.16.1, a imagem com a foto real mantém a marcação do próprio produto (logo, selo, texto impresso); pra tirar, peça "sem a marcação". Desde a 2.37.0 (plugin 0.29.0): com duas ou mais imagens, o Iron mostra as **miniaturas** no chat e você clica na que quer; na aba Imagens, o botão **Escolhi esta** faz o mesmo. O Iron traz o **arquivo original** pro cofre (`Projetos/<loja>/marca/originais/`, ferramenta `image_get`), nunca redesenha a imagem que você aprovou, e o logo aprovado sai também **sem fundo** (PNG transparente, recortado pelo site quando o fundo é liso). Desde a 2.37.1 (plugin 0.29.1): peça "vetorize a logo" e o **site** faz o vetor (SVG) do logo de uma cor só sobre fundo liso, mede se ficou igual e manda um link pra você comparar o original com o vetor; só no seu "Sim, ficou igual" o vetor entra no kit, em cor, preto e branco (`marca/vetor/`). O Iron nunca traça, converte ou redesenha por conta própria. Desde a 2.37.2: "cria o logo da minha marca" gera o logo pelo site (uma cor só, fundo liso, com custo e o seu sim); a regra "sem logo desenhado" vale só pra foto de produto, anúncio, banner e página. Confira cada letra do nome antes de escolher. Desde a 2.38.0 (plugin 0.30.0): **uma pasta por loja**. A ficha e a marca moram na mesma pasta do cofre (`Projetos/<pasta>/`, a que aparece em Integrações como "Pasta no cofre"); se a marca de uma loja ficou numa pasta separada antes, o Iron pergunta se junta, e só move no seu sim, sem sobrescrever nada.
264
264
 
265
265
  **Página de vendas na lógica de quem já vende** (skill `clone-persuasion`, desde a 2.17.0): no chat, "quero vender como esta página: <link>" e diga o produto. O Iron estuda por que a página vende (gancho, oferta, provas, ordem das partes, imagens) e escreve a sua com essa lógica e com as suas palavras: antes, pergunta como você fala com seu cliente (uma pergunta por vez) e grava na ficha da loja. Nada é copiado: um verificador barra 8 palavras seguidas iguais à página de referência (se você preferir reaproveitar frases, ele pergunta antes e avisa o risco). O que você não informou (preço, depoimento, garantia) fica marcado `[PREENCHER]` e listado no fim, nunca inventado. A página entra em Entregas e em Páginas como rascunho. Desde a 2.17.1, o que falta (preço, garantia, frete…) vira um formulário no próprio chat: você responde, pula o que não sabe, e o Iron devolve a página com as respostas no lugar.
266
266
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iron-edge",
3
- "version": "2.37.1",
3
+ "version": "2.38.0",
4
4
  "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 26 skills, com quality gate, memoria, instalador que nunca sobrescreve o comando office (chat do Iron Office no dashboard; confere a chave com o site antes de abrir o Claude) e o doctor (mede a maquina e acende o Setup do site).",
5
5
  "keywords": [
6
6
  "claude",
@@ -22,17 +22,19 @@ description: Cria identidade visual completa e kit de logo premium para QUALQUER
22
22
 
23
23
  ---
24
24
 
25
+ > **Aluno do Iron Office que só quer o logo** ("cria o logo da minha marca", sem imagem aprovada ainda): comece pela skill `imagens`, seção "Logo da marca" (o site gera, com custo e sim). As Fases 1 a 7 daqui são pra quem pede identidade completa, brandbook ou kit; com a imagem aprovada como logo, vale a regra 0.
26
+
25
27
  ## REGRAS DE OURO (valem o tempo todo)
26
28
 
27
29
  0. **O Iron não traça, não converte e não redesenha imagem. Sem condição.** Vetor, SVG, "sem fundo", "em preto", "em branco" ou "outra cor" de uma imagem gerada (ou de um logo que o aluno aprovou) só saem pelo SITE: `image_vectorize` e `image_get`. Proibido, sempre: escrever traçador ou script de conversão (Python, Node, PIL, qualquer um), usar traçador que já esteja na máquina, instalar um, converter por código, redesenhar à mão, refazer a partir de print de tela, "limpar" ou "melhorar" letra, trocar fonte, cor ou proporção. A ferramenta recusou (`infiel`, `fora_da_classe`, `fundo_nao_liso`, `grande_demais`, `recusado`) ou deu erro: diga ao aluno a frase do retorno e pare ali. **Mudar só o TAMANHO de um arquivo oficial não é traçar:** os ícones saem do PNG sem fundo ou do SVG aprovado, no mesmo desenho, com `sips -Z <lado> arquivo.png --out icone-<lado>.png` no Mac (o `-Z` maiúsculo mantém a proporção). Fora do Mac: entregue os arquivos oficiais e diga ao aluno que os ícones em outros tamanhos saem em qualquer editor de imagem (redimensionar, sem mexer no desenho); não escreva script pra isso. Nada além do tamanho muda: nem desenho, nem cor, nem proporção, nem fundo.
28
30
  **Logo aprovado é o logo oficial.** O aluno aprovou uma imagem gerada por IA COMO O LOGO? Ela é o logo, do jeito que está. Clicar numa miniatura (ou em "Escolhi esta") é escolher a imagem; antes de travar, confirme com UMA `ask`: "Esta imagem é o logo final da sua marca?" (opções "Sim, é o logo" · "Não, é só a direção"). "Sim" = esta regra. "Só a direção" = siga as fases do vetor desenhado do zero, dizendo que o desenho novo vai ser outro, inspirado nela. Sem confirmar, não trave nada. O caminho é um só:
29
- - `image_get` (skill `imagens`, seção "Imagem escolhida") traz o arquivo ORIGINAL pro cofre (`Projetos/<loja>/marca/originais/`);
31
+ - `image_get` (skill `imagens`, seção "Imagem escolhida") traz o arquivo ORIGINAL pro cofre (`Projetos/<pasta>/marca/originais/`, a pasta do `pasta:` da linha `[loja: …]`, a mesma da ficha);
30
32
  - `image_get` com `kind: "alpha"` traz o mesmo desenho em PNG sem fundo, recortado pelo site. Esse PNG transparente é o **logo oficial em imagem**;
31
- - vetor (SVG): `image_vectorize` (o site traça o logo de uma cor só sobre fundo liso e mede se ficou igual) → mande o `compare_url` no `reply` → `ask` com `vector: <id>` (o site pergunta "O vetor ficou igual ao seu logo?"; só o clique do aluno aprova) → no "Sim, ficou igual", `image_get` com `kind` `svg`, `svg-preto` e `svg-branco` (gravam em `marca/vetor/`). "Não ficou igual" ou recusa: fica a imagem, e diga: "O logo oficial fica em imagem, com fundo transparente. Se você precisar dele em vetor (gráfica, bordado, placa grande), um designer redesenha a partir deste arquivo."
33
+ - vetor (SVG): `image_vectorize` (o site traça o logo de uma cor só sobre fundo liso e mede se ficou igual) → mande o `compare_url` no `reply` → `ask` com `vector: <id>` (o site pergunta "O vetor ficou igual ao seu logo?"; só o clique do aluno aprova) → no "Sim, ficou igual", `image_get` com `kind` `svg`, `svg-preto` e `svg-branco` (gravam em `marca/vetor/`). "Não ficou igual" ou recusa: fica a imagem, e diga: "O logo oficial fica em imagem (o original e, se o site tirou o fundo, o PNG sem fundo). Se você precisar dele em vetor (gráfica, bordado, placa grande), um designer redesenha a partir deste arquivo."
32
34
  - Preto e branco são o MESMO vetor em outra cor, feitos pelo site depois do Sim. Outra cor (dourado, degradê, contorno), outra fonte ou outra proporção: não existe aqui. Diga o que existe (cor, preto, branco) e a frase do designer.
33
35
  - Com logo aprovado, **pule as Fases 3, 4 e 5** (não se desenha nem refina símbolo, nem se monta lockup com outro desenho) e, na Fase 6, o kit é: o original (`kind: "original"`), o PNG sem fundo (`kind: "alpha"`), e, se o aluno aprovou o vetor, o SVG, o SVG preto e o SVG branco; os tamanhos de ícone saem só por redimensionamento desses arquivos. A Fase 7 (guidelines) usa esses arquivos como estão.
34
36
  - `image_get` deu erro (imagem não encontrada, de outra loja, site fora do ar): diga ao aluno em 1 linha o que o retorno disse e pare ali. Nunca contorne com `curl`, print, navegador ou redesenho.
35
- - Os arquivos ficam no cofre (`Projetos/<loja>/marca/`) ou, sem cofre, em `Iron Office/<loja>/marca/` na pasta do usuário: diga o `path` que o `image_get` devolveu.
37
+ - Os arquivos ficam no cofre (`Projetos/<pasta>/marca/`, a pasta do `pasta:` da linha `[loja: …]` (sem `pasta:` na linha, Iron antigo: a pasta da ficha; sem ficha, a regra do nome da skill `loja`, seção 2)) ou, sem cofre, em `Iron Office/<pasta>/marca/` na pasta do usuário: diga o `path` que o `image_get` devolveu.
36
38
  As regras 2 e 6, as Fases 3 a 5 e a seção "Conceitos de símbolo por IA" valem só quando **não** há imagem aprovada (logo que nasce em vetor, desenhado aqui do zero, com a decisão do aluno de fazer um desenho novo).
37
39
  1. **Decisão é do cliente, com base visual.** Nunca adivinhe gosto. Mostre opções lado a lado (renderizadas) e recomende uma. Ele escolhe.
38
40
  2. **Logo premium é FLAT.** Forma sólida, uma cor chapada, sem gradiente, sem 3D, sem sombra. Estude como Nike (forma única com movimento), Apple (negative space + grid) e Whoop (geometria + 1 acento) são construídos. Tem que funcionar a **16px** e em **preto e branco**. Se precisa de brilho pra ficar bonito, não está resolvido.
@@ -42,7 +42,7 @@ cada uma manda num pedaço:
42
42
  seu jeito"). Nunca o contrário.
43
43
 
44
44
  **De onde vem a voz, nesta ordem:**
45
- 1. A ficha da loja (`Projetos/<pasta>/PROJETO.md`, seção `## Voz` ou o campo
45
+ 1. A ficha da loja (`Projetos/<pasta>/PROJETO.md`, pasta do `pasta:` da linha `[loja: …]` ou, sem ela, a da ficha, seção `## Voz` ou o campo
46
46
  "Tom de voz"). Página para cliente seu: o `## Voz` do Brandkit dele, se existir.
47
47
  2. **Ouvir o dono antes de escrever** quando a ficha não tem voz, ou só tem o rótulo
48
48
  ("Próximo"). No Iron Office isso já veio no pedido (a sessão principal perguntou
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: imagens
3
- description: Gera imagem da loja (feed, story, quadrado, banner) pelo Iron Office, com a chave do provedor do aluno (OpenAI ou fal) que fica no servidor, e guarda na aba Imagens da loja. Mostra o custo e pede o sim antes de gerar. Use quando o aluno disser "gera uma imagem", "faz uma imagem do produto", "imagem pro feed", "imagem pro story", "banner da loja", "variação da imagem <id>", "sobe essa na Shopify", "tira essa da Shopify", ou pedir arte de produto pra anúncio ou página.
3
+ description: Gera imagem da loja (feed, story, quadrado, banner) e o logo da marca pelo Iron Office, com a chave do provedor do aluno (OpenAI ou fal) que fica no servidor, e guarda na aba Imagens da loja. Mostra o custo e pede o sim antes de gerar. Use quando o aluno disser "gera uma imagem", "faz uma imagem do produto", "imagem pro feed", "imagem pro story", "banner da loja", "cria o logo da minha marca", "faz um logo", "variação da imagem <id>", "sobe essa na Shopify", "tira essa da Shopify", ou pedir arte de produto pra anúncio ou página.
4
4
  ---
5
5
 
6
6
  # imagens — imagem da loja, com custo e sim antes
@@ -12,7 +12,8 @@ O aluno pede no chat; você monta o pedido com o produto e a marca da loja, most
12
12
  - **Nunca repita às cegas.** Resposta `provedor fora`, `sem resposta` ou `gravar` pode ter cobrado: mande o aluno conferir a aba Imagens antes de pedir de novo.
13
13
  - Nunca invente número: o custo é o que o `dry_run` devolveu (estimado) e, depois, o `cost_usd` da resposta (medido quando `cost_kind` = "medido"). **Nunca cite valor de crédito nem preço de ferramenta de terceiro** ("US$ 5 já dá"): você não mediu.
14
14
  - **Nunca suba na Shopify sem o sim** (passo 9). Subir mexe na loja do aluno, visível na hora.
15
- - **Nunca peça logo desenhado.** O logo da marca da loja entra depois, pelo kit. Com a foto real, a marcação que já está no produto (logo, selo, texto impresso) **fica**; só sai se o aluno pedir "sem a marcação".
15
+ - **Foto de produto, anúncio, banner e página não levam logo desenhado.** Dentro da cena o modelo erra o logo (troca letra, inventa símbolo); o logo da marca entra depois, pelo kit. Com a foto real, a marcação que já está no produto (logo, selo, texto impresso) **fica**; só sai se o aluno pedir "sem a marcação".
16
+ - **Pedido cujo objeto é o próprio logo, símbolo ou ícone da marca: gere pelo site.** Siga a seção "Logo da marca" (abaixo). Nunca mande o aluno contratar um designer pra ter o primeiro logo.
16
17
  - As regras da casa pra montar o pedido estão em `regras.md` (nesta pasta): leia antes do passo 4.
17
18
 
18
19
  ## 1. Entender o pedido
@@ -46,14 +47,14 @@ Aviso único por conversa: com a foto real, etiqueta **anúncio** e marca visív
46
47
  A mesma chamada (mesmo `prompt`, `destination`, `provider`, `n`, `reference`) **sem** `dry_run` e **com o `quote`**. Leva até 2 minutos: antes, um `reply` curto "Gerando, leva até 2 minutos. Não peça de novo enquanto isso." Passaram 15 minutos desde o custo? Peça o custo de novo (o `quote` venceu).
47
48
 
48
49
  ## 8. Responder
49
- "Pronta: <destino> <largura>×<altura> · US$ <cost_usd> · <url>. Está na aba Imagens da loja." e mais 1 frase: **com a foto real** → "A marcação do produto ficou como na foto."; **com "sem a marcação"** → "Tirei a marcação do produto de propósito, como você pediu."; **sem foto real** → "Ela sai sem logo de propósito: ponha o logo da marca depois, no editor que você usa." (O `url` abre a imagem na aba Imagens do site, com o botão Baixar. Mande esse link como veio, nunca um link do Supabase.) **Com `images` (duas ou mais), não mande os links:** mande a frase de custo num `reply` curto e, logo depois, a `ask` "Qual destas?" com `images` = os `id` na ordem (até 8) e `skip: true`. O aluno clica na miniatura; o clique chega como `imagem escolhida: <id>` (seção abaixo). Com `partial`: "Gerei <generated> e cobrei todas, mas só <saved> foram guardadas." Guarde o `id` da imagem (pro passo 9). Com a foto real, termine com "Se quiser, eu ponho na página do produto na Shopify: é só pedir." (sem subir e sem perguntar de novo).
50
+ "Pronta: <destino> <largura>×<altura> · US$ <cost_usd> · <url>. Está na aba Imagens da loja." e mais 1 frase: **com a foto real** → "A marcação do produto ficou como na foto."; **com "sem a marcação"** → "Tirei a marcação do produto de propósito, como você pediu."; **sem foto real** (e o pedido NÃO era o logo) → "Ela sai sem logo de propósito: ponha o logo da marca depois, no editor que você usa."; **pedido de logo** → nenhuma dessas frases (siga a seção "Logo da marca"). (O `url` abre a imagem na aba Imagens do site, com o botão Baixar. Mande esse link como veio, nunca um link do Supabase.) **Com `images` (duas ou mais), não mande os links:** mande a frase de custo num `reply` curto e, logo depois, a `ask` "Qual destas?" com `images` = os `id` na ordem (até 8) e `skip: true`. O aluno clica na miniatura; o clique chega como `imagem escolhida: <id>` (seção abaixo). Com `partial`: "Gerei <generated> e cobrei todas, mas só <saved> foram guardadas." Guarde o `id` da imagem (pro passo 9). Com a foto real, termine com "Se quiser, eu ponho na página do produto na Shopify: é só pedir." (sem subir e sem perguntar de novo).
50
51
 
51
52
  ## 9. Subir na Shopify (só se o aluno pedir)
52
53
  "sobe essa na página do produto", "coloca na loja": mande a `ask` "Subo a imagem na página do produto <título>? Fica visível na loja na hora. Se não gostar, é só pedir 'tira essa da Shopify'." (Sim / Não; se ele citou variante: "…e prendo na variante <x>"). **Só no Sim**, `image_to_shopify` com `image_id`, `project_id`, `product_handle` e `variant_ids` (os `id` das variantes, se pediu). Responda: `status: "pronta"` → "Está na página do produto <título> (última foto). Pra tirar: 'tira essa da Shopify' ou o botão no detalhe da imagem." · `"processando"` → "Subiu; a Shopify ainda está processando. Confira a página em 1 minuto."
53
54
  "tira essa da Shopify": `image_to_shopify` com `remove: true` (desfazer não precisa de sim) e "Saiu da página do produto."
54
55
 
55
56
  ## Erros
56
- - `reason: "sem provedor"` (aluno sem chave): **entregue o pedido pronto**, sem gerar, no formato "Pedido pronto" da `regras.md` (frase da foto anexada + cena), num bloco de código, com 1 linha de tradução, o tamanho do destino ("1080×1350, vertical") e "Baixe a 1ª foto do produto (admin da Shopify → Produtos → o produto → clique na foto → baixar), anexe na ferramenta de imagem que você já usa e cole esse texto. A marcação do produto fica como na foto; não acrescente outro logo por cima." Feche com: "Se quiser que eu gere direto daqui: crie a chave na sua conta da OpenAI ou do fal, coloque crédito e cole em Integrações → Imagens." Sem valor de crédito, sem preço de ferramenta.
57
+ - `reason: "sem provedor"` (aluno sem chave): **entregue o pedido pronto**, sem gerar, no formato "Pedido pronto" da `regras.md` (frase da foto anexada + cena), num bloco de código, com 1 linha de tradução, o tamanho do destino ("1080×1350, vertical") e "Baixe a 1ª foto do produto (admin da Shopify → Produtos → o produto → clique na foto → baixar), anexe na ferramenta de imagem que você já usa e cole esse texto. A marcação do produto fica como na foto; não acrescente outro logo por cima." Feche com: "Se quiser que eu gere direto daqui: crie a chave na sua conta da OpenAI ou do fal, coloque crédito e cole em Integrações → Imagens." Sem valor de crédito, sem preço de ferramenta. **Pedido de logo sem chave:** não há foto pra anexar; entregue só o texto do pedido da seção "Logo da marca" (bloco de código, 1 linha de tradução, "1080×1080, quadrado") e diga: "Cole na ferramenta de imagem que você já usa. Peça uma cor só, fundo liso e traço firme, e confira cada letra do nome."
57
58
  - `reason: "sem foto"`, `"sem produto"` ou `"sem shopify"`: diga a frase do site e ofereça gerar sem a foto (custo de novo, sim de novo).
58
59
  - `reason: "limite do dia"`: "O limite de hoje acabou (US$ <cap>). Amanhã volta, ou mude em Integrações → Imagens."
59
60
  - `reason: "por minuto"`: espere 1 minuto e diga que vai tentar de novo.
@@ -64,13 +65,21 @@ A mesma chamada (mesmo `prompt`, `destination`, `provider`, `n`, `reference`) **
64
65
  - `image_to_shopify` com `reason: "outra loja"`: a imagem é de outra loja; suba lá ou gere de novo nesta. `"já está"`: tire antes de subir em outro produto. `"subindo"`: espere 1 minuto e confira.
65
66
  - Qualquer outro `reason` (`shopify`, `shopify fora`, `limite indisponível`, `pedido inválido`, `erro`…): diga a frase que o site mandou; se for tentar de novo, avise antes e tente uma vez só.
66
67
 
68
+ ## Logo da marca ("cria o logo da minha marca", "faz um logo", "símbolo", "ícone da marca")
69
+ O objeto da imagem é o logo: aqui ele é o pedido, não uma intrusão na cena. Gere pelo site, com o mesmo custo e o mesmo sim (passos 5 a 7).
70
+ 1. **Destino** quadrado (1080×1080), **etiqueta** outro, sem `reference` (não é foto de produto). Nome da marca: o da ficha da loja ou o que o aluno disse; não sabe, pergunte numa `ask` antes do custo.
71
+ 2. **Pedido** (em inglês, `regras.md`, item 1 da lista): o nome da marca entre aspas, se o aluno quer o nome no logo; símbolo simples; **uma cor só, chapada, sobre fundo liso claro** (é o que o site consegue vetorizar depois); **traço e letra firmes, nada de fio fino** (traço fino some no vetor); nada de degradê, brilho, sombra, 3D, textura ou mockup. Ex. (exemplo): "minimal flat logo for a shoe store named \"Exemplo\", a simple symbol above the name, one solid dark brown color on a plain light background, bold strokes and letters, no hairlines, no gradient, no shadow, no 3D, no texture, no mockup".
72
+ 3. Na `ask` do custo, 1 linha antes: "A IA pode errar letra do nome: confira cada letra antes de escolher, e no vetor você compara com o original."
73
+ 4. Com 2 ou mais, a `ask` "Qual destas?" (passo 8). O clique chega como `imagem escolhida: <id>`: o pedido em andamento é de logo, então vem a `ask` "Esta imagem é o logo final da sua marca?" (seção abaixo). **Com 1 só** (não há o que clicar): depois do "Pronta", siga direto a seção "Imagem escolhida" com o `id` dela (o `image_get` e a mesma `ask`). "Sim, é o logo" = é o logo oficial; o vetor sai por "vetorize a logo" (seção "Vetor, sem fundo, preto e branco").
74
+
67
75
  ## Variação ("variação da imagem <id>: …")
68
76
  Pra ver a imagem, traga o original com `image_get` (`project_id` e o id COMPLETO) e leia o arquivo. Se você só tem os 8 primeiros (o botão "Pedir variação" manda assim), peça ao aluno, numa `ask`, pra abrir a imagem na aba Imagens e tocar em **Escolhi esta** (o clique traz o id completo); nunca peça pra ele copiar código. Pegue o que vem depois dos dois-pontos como a mudança pedida; se estiver vazio, pergunte "o que você quer diferente nela?". Monte um pedido novo (passos 2 a 4, com a foto real do produto quando houver) com a mudança e siga do passo 5: variação também custa e também pede o sim.
69
77
 
70
78
  ## Imagem escolhida ("imagem escolhida: <id>")
71
79
  Chega quando o aluno clica numa miniatura da `ask` ou no botão **Escolhi esta** (aba Imagens). O `<id>` é o id COMPLETO.
72
- 1. `image_get` com `project_id` (a linha `[loja: …]`) e `image_id` = esse id. Volta o `path` do arquivo original (no cofre, `Projetos/<loja>/marca/originais/`; sem cofre, `Iron Office/<loja>/marca/originais/` na pasta do usuário) e o `sha256`. Leia o arquivo pelo `path` pra ver a imagem. Deu erro (não encontrada, outra loja, site fora): diga em 1 linha o que o retorno disse e pare; nunca contorne.
80
+ 1. `image_get` com `project_id` (a linha `[loja: …]`) e `image_id` = esse id. Volta o `path` do arquivo original e o `sha256`. A pasta é a que esse `path` mostra: a da loja (`pasta:` da linha `[loja: …]`), a MESMA da ficha (no cofre, `Projetos/<pasta>/marca/originais/`; sem cofre, `Iron Office/<pasta>/marca/originais/` na pasta do usuário). Nunca escolha outra pasta por conta própria. Leia o arquivo pelo `path` pra ver a imagem. Deu erro (não encontrada, outra loja, site fora): diga em 1 linha o que o retorno disse e pare; nunca contorne.
73
81
  2. Responda em 1 linha: "Guardei o original da imagem que você escolheu, na pasta marca/originais da sua loja." e siga o pedido que estava em andamento (no brand kit, a regra 0 da skill `brandkit`). **O pedido em andamento era de logo, marca ou ícone?** Antes de seguir, UMA `ask`: "Esta imagem é o logo final da sua marca?" (opções "Sim, é o logo" · "Não, é só a direção"). "Sim" = é o logo oficial (regra 0 da `brandkit`); "Só a direção" = a imagem serve de referência pra um desenho novo.
82
+ **Pasta antiga.** O retorno trouxe `pasta_antiga` (a marca desta loja ficou numa pasta separada, antes de ficha e marca morarem juntas)? Depois da resposta do "logo final?" (se houver), UMA `ask`: "Achei arquivos da marca desta loja em outra pasta (<pasta_antiga>). Junto tudo em <pasta_nova>?", com as duas pastas escritas a partir de `Projetos/` (ex.: `Projetos/loja-velha/marca`), nunca o caminho inteiro do computador (opções "Sim, junta" · "Não, deixa como está"). No Sim: mova arquivo por arquivo, sem sobrescrever (`mv -n`; no Windows, `Move-Item` sem `-Force`), criando antes a subpasta que faltar no destino (`originais/`, `vetor/`…); nunca mova a pasta inteira de uma vez. Arquivo com o mesmo nome nos dois lugares fica onde está. Apague a pasta antiga só se ela ficou vazia. Diga em 1 linha o que foi junto e o que ficou na antiga. No Não, deixe tudo como está. Nunca mova sem o Sim.
74
83
  3. Chegou outra `imagem escolhida` depois? A escolha nova vale: traga o original dela e diga "Troquei: agora vale a imagem <8 primeiros do id>."
75
84
  4. **Imagem que o aluno aprovou é a imagem.** Nunca redesenhe, nunca refaça a partir de print de tela, nunca baixe por `curl` nem pelo navegador: o original vem só pelo `image_get`. Logo, marca ou ícone: peça também o sem fundo (`image_get` com `kind: "alpha"`, PNG recortado pelo site). Volta `ok: false` (fundo não liso, ou desenho com brilho, sombra ou degradê): fica o original, e diga ao aluno a frase do retorno. Vetor, preto e branco: seção abaixo.
76
85
 
@@ -80,7 +89,7 @@ Chega quando o aluno clica numa miniatura da `ask` ou no botão **Escolhi esta**
80
89
  2. **Vetor:** `image_vectorize` com `project_id` e o id COMPLETO. O site faz o vetor do logo de UMA cor sobre fundo liso e mede se ficou igual.
81
90
  - `ok: true`: mande o `compare_url` no `reply` ("Compare o original com o vetor neste link.") e, logo depois, a `ask` com `vector: <id>` (o site põe a pergunta "O vetor ficou igual ao seu logo?" e os botões). Nada vai pra `marca/vetor/` antes da resposta.
82
91
  - "Sim, ficou igual" (o clique já gravou a aprovação no site): `image_get` com `kind: "svg"`, depois `"svg-preto"` e `"svg-branco"`. Diga os 3 `path` (pasta `marca/vetor/` da loja).
83
- - "Não ficou igual": "Tudo bem: o logo oficial fica em imagem, com fundo transparente. Se você precisar dele em vetor (gráfica, bordado, placa grande), um designer redesenha a partir do arquivo original."
84
- - `ok: false` (`fora_da_classe`, `infiel`, `fundo_nao_liso`, `grande_demais`, `sem_desenho`, `recusado`): diga a frase do `error`, com todas as letras, e pare. `recusado` = o aluno já disse "Não ficou igual" na comparação.
92
+ - "Não ficou igual": "Tudo bem: o logo oficial fica em imagem (o original, na aba Imagens). Se você precisar dele em vetor (gráfica, bordado, placa grande), um designer redesenha a partir do arquivo original."
93
+ - `ok: false` (`fora_da_classe`, `infiel`, `fundo_nao_liso`, `grande_demais`, `sem_desenho`, `recusado`): diga a frase do `error`, com todas as letras, e pare. `recusado` = o aluno já disse "Não ficou igual" na comparação. **O logo foi gerado aqui pela seção "Logo da marca"** e o vetor ou o sem fundo deu `infiel`, `fora_da_classe` ou `fundo_nao_liso`: depois da frase, ofereça numa `ask` gerar o logo de novo (uma cor chapada, fundo liso, traço mais grosso), com custo e sim como sempre; não mande procurar designer de primeira.
85
94
  - A resposta pode chegar como mensagem "Sim, ficou igual (vetor da imagem <id>)" ou "Não ficou igual (vetor da imagem <id>)": é o aluno respondendo pela página da comparação. Vale igual ao botão da `ask`.
86
95
  3. **Preto e branco** são o mesmo vetor em outra cor, e só existem depois do "Sim". **Outra cor** (dourado, degradê, contorno), outra fonte ou outra proporção não existem aqui: diga o que existe (na cor, em preto, em branco) e a frase do designer.
@@ -3,7 +3,7 @@
3
3
  Leia antes de montar o pedido. Os exemplos marcados "exemplo" são inventados.
4
4
 
5
5
  ## O que nunca vai no pedido
6
- 1. **Logo que o modelo inventaria.** Modelo de imagem erra logo (troca letra, inventa símbolo, põe logo de outra marca). O logo da marca da loja entra depois, pelo kit. Sem foto real, escreva no pedido: "no logos, no brand marks". **A marcação que já está no produto fica** (modo foto real, abaixo).
6
+ 1. **Logo dentro de foto de produto, anúncio, banner ou página.** Na cena o modelo erra logo (troca letra, inventa símbolo, põe logo de outra marca). O logo da marca da loja entra depois, pelo kit. Sem foto real, escreva no pedido: "no logos, no brand marks". **A marcação que já está no produto fica** (modo foto real, abaixo). **Exceção: quando o pedido É o logo** (logo, símbolo ou ícone da marca), ele é o objeto da imagem: siga "Logo da marca" na `SKILL.md` (uma cor chapada, fundo liso claro, sem degradê, sombra ou 3D) e avise que a IA pode errar letra.
7
7
  2. **Pessoa com estampa ou texto na roupa.** Pessoa sempre de roupa lisa, sem estampa, sem texto, sem marca: "plain clothing, no prints, no text on clothes".
8
8
  3. **Texto legível na imagem**, a não ser que o aluno peça. Pediu: no máximo 3 palavras, entre aspas no pedido, e avise que o modelo pode errar letra.
9
9
  4. **Marca de terceiro, celebridade, personagem conhecido.** Nem "no estilo de" uma marca famosa.
@@ -30,13 +30,13 @@ O pedido começa sempre por esta frase, e só depois vem a cena:
30
30
  - story (9:16): produto no meio, 250 px livres em cima e embaixo (a interface do app cobre).
31
31
  - quadrado (1:1): produto centralizado, fundo simples.
32
32
  - banner (16:9): produto num lado, o outro lado limpo pro título.
33
- - **Evitar** (sem foto real): "no logos, no brand marks, no watermark, no text" (tire o "no text" só se o aluno pediu texto). Com a foto real, o fecho é o da seção acima.
33
+ - **Evitar** (sem foto real): "no logos, no brand marks, no watermark, no text" (tire o "no text" só se o aluno pediu texto). Com a foto real, o fecho é o da seção acima. **Pedido do próprio logo:** nada de "no logos" (o logo é o pedido); o fecho é o da seção "Logo da marca" da `SKILL.md` ("no gradient, no shadow, no 3D, no texture, no mockup").
34
34
 
35
35
  ## 10 erros comuns
36
36
  1. Pedido curto demais ("bota bonita"): o modelo inventa o produto. Descreva o que ele é.
37
37
  2. Pedido longo demais (mais de ~900 caracteres): o modelo ignora o fim. Corte adjetivo repetido.
38
38
  3. Pedir "foto realista" e "ilustração" juntos.
39
- 4. Pedir o logo.
39
+ 4. Pedir o logo dentro da cena (foto de produto, anúncio, banner). Logo como objeto da imagem é outro pedido: "Logo da marca", na `SKILL.md`.
40
40
  5. Esquecer o destino: feed recortado de banner perde o produto.
41
41
  6. Cor da marca pintando o produto inteiro.
42
42
  7. Fundo cheio de coisa em imagem de produto.
@@ -33,9 +33,14 @@ Chame `shop_status` (plugin `iron-office`). Ele devolve `{ stores: [...], active
33
33
 
34
34
  ## 2. A pasta e a ficha que já existe
35
35
 
36
- **Se a linha `[loja: …]` do pedido já traz `ficha: Projetos/<pasta>/PROJETO.md`**, essa é a pasta desta loja: use ela e pule a regra abaixo.
36
+ **Uma pasta por loja: ficha e marca moram juntas.** A pasta desta loja sai, nesta ordem:
37
+ 1. A linha `[loja: …]` traz `ficha: Projetos/<pasta>/PROJETO.md`: essa é a pasta. Use ela.
38
+ 2. Senão, a linha traz `pasta: Projetos/<pasta>` (loja ainda sem ficha): essa é a pasta, a MESMA em que o logo e os arquivos da marca já caem. Use ela.
39
+ 3. Só se a linha não traz nenhuma das duas (Iron antigo), a regra do nome logo abaixo.
37
40
 
38
- **O nome da pasta** (loja ainda sem ficha) sai do NOME da loja: minúsculas, sem acento, e **tudo que não for letra (a-z) ou número vira hífen**; hífens repetidos viram um só, e sem hífen no começo ou no fim. Exemplos: "Loja Exemplo" → `loja-exemplo`; "Casa & Praia" → `casa-praia`; "../x" → `x`. Se sobrar vazio, use `loja`. O caminho final é sempre `Projetos/<pasta>/`, nunca outro lugar.
41
+ O `ficha_path` que você grava (`store_update`) é sempre `Projetos/<pasta>/PROJETO.md` com a pasta escrita igual à da linha (minúsculas, sem espaço nem acento), mesmo que a pasta no disco apareça com maiúscula: senão o site e o Iron não reconhecem a pasta da ficha e a marca vai pra outra.
42
+
43
+ **O nome da pasta pela regra do nome** (só no caso 3) sai do NOME da loja: minúsculas, sem acento, e **tudo que não for letra (a-z) ou número vira hífen**; hífens repetidos viram um só, e sem hífen no começo ou no fim. Exemplos: "Loja Exemplo" → `loja-exemplo`; "Casa & Praia" → `casa-praia`; "../x" → `x`. Se sobrar vazio, use `loja`. O caminho final é sempre `Projetos/<pasta>/`, nunca outro lugar.
39
44
 
40
45
  **Pasta que já existe** (mesmo nome, qualquer caixa, ex.: `Loja-Exemplo`): abra o `PROJETO.md` dela.
41
46
  - O frontmatter tem `project_id` igual ao desta loja, ou o arquivo não tem `project_id` e não fala de outra loja Shopify: é a pasta dela. Reaproveite.
@@ -65,7 +65,7 @@ O sintoma de errar aqui é o pior possível: **não aparece erro nenhum.** O Iro
65
65
  genérico e oferece criar um cofre — com o cofre do usuário cheio, ali do lado. Se isso acontecer,
66
66
  o `vault_path` é o primeiro lugar a olhar.
67
67
 
68
- Cada projeto novo ganha `Projetos/<Nome>/PROJETO.md` com este frontmatter e estas seções — preenchidas SÓ com o que o usuário contar, o resto "(a preencher)":
68
+ Cada projeto novo ganha `Projetos/<Nome>/PROJETO.md` (no Iron Office, `<Nome>` é a pasta do `pasta:` da linha `[loja: …]`, onde a marca da loja também mora) com este frontmatter e estas seções — preenchidas SÓ com o que o usuário contar, o resto "(a preencher)":
69
69
 
70
70
  ```
71
71
  ---
@@ -12,7 +12,7 @@ Esta skill é o suporte de tráfego do dono do negócio. Ele diz o que quer, do
12
12
 
13
13
  Serve igual para o próprio negócio e para cliente: onde este texto diz "negócio" ou "dono", leia "o negócio dono daquela conta de anúncio".
14
14
 
15
- **A ficha do negócio** é o `Projetos/<pasta>/PROJETO.md` que a skill `loja` monta no cofre (o caminho chega na linha `[loja: … · ficha: …]` do pedido). Se a máquina não tiver a skill `loja` nem essa ficha, use a nota do negócio que o dono indicar.
15
+ **A ficha do negócio** é o `Projetos/<pasta>/PROJETO.md` que a skill `loja` monta no cofre (o caminho chega na linha `[loja: … · ficha: … · pasta: …]` do pedido; sem ficha, a pasta da loja é a do `pasta:`; sem as duas, a regra do nome da skill `loja`, seção 2). Se a máquina não tiver a skill `loja` nem essa ficha, use a nota do negócio que o dono indicar.
16
16
  **"Informação que vence"** é um bloco curto dentro da ficha com o que tem prazo: a promoção que vale agora e até quando, o preço anunciado, o estoque, a URL de destino e o WhatsApp. É o que a campanha não pode contradizer; se o bloco não existir, crie com o que o dono responder.
17
17
 
18
18
  ## Quando NÃO usar esta skill
@@ -27,7 +27,7 @@ Sem a linha `[loja: …]` ou sem a ferramenta `trail_status` (plugin antigo): di
27
27
 
28
28
  ## 2. Leia a ficha antes de perguntar
29
29
 
30
- Se a linha traz `ficha: Projetos/<pasta>/PROJETO.md`, leia o bloco `<!-- iron:ficha -->` desse arquivo (a sessão está no cofre). O que já está lá não se pergunta de novo.
30
+ A pasta da loja no cofre é a do `pasta:` da linha (a mesma da ficha) (sem `pasta:` na linha, Iron antigo: a pasta da ficha; sem ficha, a regra do nome da skill `loja`, seção 2). Se a linha traz `ficha: Projetos/<pasta>/PROJETO.md`, leia o bloco `<!-- iron:ficha -->` desse arquivo (a sessão está no cofre). O que já está lá não se pergunta de novo.
31
31
 
32
32
  ## 3. Execute a etapa
33
33
 
@@ -2,4 +2,4 @@
2
2
 
3
3
  Derivada: o site marca sozinho quando a ficha foi gravada. Nunca chame `trail_update` aqui.
4
4
 
5
- Rode a skill `loja` (ela lê a Shopify, aponta o que está errado, pergunta uma coisa por vez e grava `Projetos/<pasta>/PROJETO.md`). Quando ela terminar, a etapa aparece pronta no site.
5
+ Rode a skill `loja` (ela lê a Shopify, aponta o que está errado, pergunta uma coisa por vez e grava `Projetos/<pasta>/PROJETO.md`, na pasta do `pasta:` da linha `[loja: …]`). Quando ela terminar, a etapa aparece pronta no site.
@@ -1,7 +1,7 @@
1
1
  # Etapa: marca (Marca pronta: logo, cores, fontes)
2
2
 
3
3
  ## Medir
4
- Procure `Projetos/<pasta>/brand.json` (a pasta da linha `ficha:`). Existe e tem pelo menos 2 cores e 1 fonte? A etapa já está pronta: grave a prova e siga.
4
+ Procure `Projetos/<pasta>/brand.json` (a pasta do `pasta:` da linha `[loja: …]`, a mesma da ficha (sem `pasta:` na linha, Iron antigo: a pasta da ficha; sem ficha, a regra do nome da skill `loja`, seção 2)). Existe e tem pelo menos 2 cores e 1 fonte? A etapa já está pronta: grave a prova e siga.
5
5
 
6
6
  ## Fazer
7
7
  - **A loja tem site no ar** (o `primaryDomain` da Shopify, ou o site que a ficha diz que é do aluno): rode a skill `clone-inventory` SÓ nesse site do aluno e grave `brand.json` no formato do `templates/brand.json` da skill `loja`. Nunca em site de concorrente nem de referência.
@@ -27,7 +27,7 @@ Em todas as fontes: descarte página com nome de pessoa, curso, mentoria ou "ofe
27
27
  Nome de página ou loja é empresa e pode ir na prova. Nome de pessoa, telefone, e-mail: nunca.
28
28
 
29
29
  ## 4. Gravar
30
- 1. **Ficha** `Projetos/<pasta>/PROJETO.md` no cofre (onde a sessão está e qual é a pasta: skill `loja`, seções 0 e 2; mescla sem apagar: seção 7). Não existe: crie pelo `skills/loja/templates/PROJETO.md` com o `project_id` e `Tipo` = "Ainda não tenho loja". Preencha `Nicho`, `Oferta` (o produto em 1 frase) e a linha `| Concorrentes | <as 3 páginas> (fonte: <fonte>) |` (acrescente a linha se não existir). O que ficou sem resposta vai em **Em aberto**.
30
+ 1. **Ficha** `Projetos/<pasta>/PROJETO.md` no cofre (a pasta do `pasta:` da linha `[loja: …]`; onde a sessão está e qual é a pasta: skill `loja`, seções 0 e 2; mescla sem apagar: seção 7). Não existe: crie pelo `skills/loja/templates/PROJETO.md` com o `project_id` e `Tipo` = "Ainda não tenho loja". Preencha `Nicho`, `Oferta` (o produto em 1 frase) e a linha `| Concorrentes | <as 3 páginas> (fonte: <fonte>) |` (acrescente a linha se não existir). O que ficou sem resposta vai em **Em aberto**.
31
31
  2. `store_update` com `project_id`, `ficha_path` e `summary` (até 600: nicho · produto · público, se souber · país). É ele que marca sozinha a etapa `ficha`.
32
32
  3. `trail_update` `provada` com a prova abaixo.
33
33