iron-edge 2.36.0 → 2.37.1
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 +1 -1
- package/package.json +1 -1
- package/skills/brandkit/SKILL.md +14 -4
- package/skills/imagens/SKILL.md +20 -2
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".
|
|
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.
|
|
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.
|
|
3
|
+
"version": "2.37.1",
|
|
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",
|
package/skills/brandkit/SKILL.md
CHANGED
|
@@ -24,12 +24,22 @@ description: Cria identidade visual completa e kit de logo premium para QUALQUER
|
|
|
24
24
|
|
|
25
25
|
## REGRAS DE OURO (valem o tempo todo)
|
|
26
26
|
|
|
27
|
+
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
|
+
**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/`);
|
|
30
|
+
- `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."
|
|
32
|
+
- 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
|
+
- 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
|
+
- `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.
|
|
36
|
+
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).
|
|
27
37
|
1. **Decisão é do cliente, com base visual.** Nunca adivinhe gosto. Mostre opções lado a lado (renderizadas) e recomende uma. Ele escolhe.
|
|
28
38
|
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.
|
|
29
39
|
3. **Uma cor é o acento/"sinal".** Aparece pouco e sempre significa a mesma coisa. Nunca preenche grandes áreas.
|
|
30
40
|
4. **Anti-vícios de linguagem** (em todo texto: copy, PDF, mockups): nunca use travessão (—), nem a antítese "não é X, é Y", nem negação dramática em duas frases. Afirme direto.
|
|
31
41
|
5. **Hierarquia, sem pular etapas:** identidade → logo → assets → aplicação.
|
|
32
|
-
6. **Render 3D de IA ≠ logo
|
|
42
|
+
6. **Render 3D de IA ≠ logo** (quando o aluno ainda não aprovou nenhuma imagem: com imagem aprovada, vale a regra 0). Imagem de IA (skill `imagens`) serve como direção criativa. O logo final é vetor flat. Marca premium tem os dois (o render vira peça hero; o vetor é o logo).
|
|
33
43
|
|
|
34
44
|
---
|
|
35
45
|
|
|
@@ -49,7 +59,7 @@ description: Cria identidade visual completa e kit de logo premium para QUALQUER
|
|
|
49
59
|
|
|
50
60
|
**FASE 2 — Direção.** 3-4 territórios visuais (cor + tipo de símbolo + tipografia + referência). Recomende um. Antes de desenhar, pergunte 3 coisas que mudam tudo: (a) base do estudo, (b) cor (abrir leque vs refinar), (c) nível do símbolo (minimalismo com personalidade vs elaborado).
|
|
51
61
|
|
|
52
|
-
**FASE 3 — Conceitos.** 4-6 símbolos em SVG, renderizados num board PNG. Se pedirem mais criatividade, gere conceitos por IA (skill `imagens`, se o aluno tem chave de imagem em Integrações; sem chave, siga só no vetor) como referência. Cliente escolhe a direção.
|
|
62
|
+
**FASE 3 — Conceitos.** (Com logo aprovado pela regra 0, pule para a Fase 6.) 4-6 símbolos em SVG, renderizados num board PNG. Se pedirem mais criatividade, gere conceitos por IA (skill `imagens`, se o aluno tem chave de imagem em Integrações; sem chave, siga só no vetor) como referência. Cliente escolhe a direção.
|
|
53
63
|
|
|
54
64
|
**FASE 4 — Refino.** Itere o traço do símbolo escolhido (ângulo, peso, proporção), mostrando variações em PNG. Depois a COR: símbolo em 5-6 cores sólidas lado a lado pra cravar. Sempre renderize.
|
|
55
65
|
|
|
@@ -112,11 +122,11 @@ fs.writeFileSync(outPng, r.render().asPng());
|
|
|
112
122
|
> Por quê: o Chrome headless em loop pendura no sandbox, e `@import` de fonte por rede falha. resvg resolve os dois.
|
|
113
123
|
|
|
114
124
|
### Conceitos de símbolo por IA (opcional)
|
|
115
|
-
Se o aluno tem chave de imagem em Integrações, use a skill `imagens` pedindo "brand symbol / app icon, minimalista, premium, muito espaço negativo, [paleta], sem texto".
|
|
125
|
+
Se o aluno tem chave de imagem em Integrações, use a skill `imagens` pedindo "brand symbol / app icon, minimalista, premium, muito espaço negativo, [paleta], sem texto". Mostre as opções pela `ask` com `images` (miniaturas; nunca os links). **Se o aluno aprovar uma delas como o logo, vale a regra 0** (ela é o logo; não se vetoriza à mão). Se ele quiser só a direção pra um logo novo em vetor, aí sim desenhe o SVG flat do zero, dizendo antes que é um desenho novo inspirado na imagem. Sem chave, siga só no vetor.
|
|
116
126
|
|
|
117
127
|
### Tamanhos de ícone
|
|
118
128
|
```bash
|
|
119
|
-
for sz in 1024 512 192; do sips -
|
|
129
|
+
for sz in 1024 512 192; do sips -Z $sz icone.png --out icone-$sz.png; done
|
|
120
130
|
```
|
|
121
131
|
|
|
122
132
|
---
|
package/skills/imagens/SKILL.md
CHANGED
|
@@ -46,7 +46,7 @@ Aviso único por conversa: com a foto real, etiqueta **anúncio** e marca visív
|
|
|
46
46
|
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
47
|
|
|
48
48
|
## 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` (
|
|
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
50
|
|
|
51
51
|
## 9. Subir na Shopify (só se o aluno pedir)
|
|
52
52
|
"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."
|
|
@@ -65,4 +65,22 @@ A mesma chamada (mesmo `prompt`, `destination`, `provider`, `n`, `reference`) **
|
|
|
65
65
|
- 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
66
|
|
|
67
67
|
## Variação ("variação da imagem <id>: …")
|
|
68
|
-
|
|
68
|
+
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
|
+
|
|
70
|
+
## Imagem escolhida ("imagem escolhida: <id>")
|
|
71
|
+
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.
|
|
73
|
+
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.
|
|
74
|
+
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
|
+
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
|
+
|
|
77
|
+
## Vetor, sem fundo, preto e branco
|
|
78
|
+
**Regra sem condição: você não traça, não converte e não redesenha imagem.** Pedido de vetor, SVG, "vetorize", "sem fundo", "em preto", "em branco" ou "em outra cor" de uma imagem gerada = só pelas ferramentas do site: `image_vectorize` e `image_get`. Proibido, sempre: escrever traçador ou script de conversão (Python, Node, PIL ou qualquer outro), usar traçador que já esteja na máquina, instalar um, converter por código, redesenhar. Recusa ou erro da ferramenta: diga a frase do retorno e pare.
|
|
79
|
+
1. **Sem fundo:** `image_get` com `kind: "alpha"` (o site recorta; logo de uma cor sai com a cor chapada da tinta).
|
|
80
|
+
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
|
+
- `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
|
+
- "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.
|
|
85
|
+
- 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
|
+
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.
|