iron-edge 2.17.0 → 2.18.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
@@ -254,7 +254,7 @@ O que esperar:
254
254
 
255
255
  **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".
256
256
 
257
- **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.
257
+ **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.
258
258
 
259
259
  **Atualização sozinha** (desde a 2.13.0): antes de abrir, o `ironoffice` compara a versão instalada (`~/.iron/install-manifest.json`) com a do pacote e, se estiver atrás, roda o mesmo `npx iron-edge update` (sem mexer no atalho do shell): troca só o arquivo do pacote que você não editou, avisa antes (`Atualizando o Iron 2.12.0 -> 2.13.0 (alguns segundos, nao feche)...`) e imprime 1 linha no fim (`Iron atualizado 2.12.0 -> 2.13.0: N arquivo(s) trocado(s), M ficaram como estavam (voce mexeu neles)`). Sem internet ou com erro, abre com a versão que está e avisa. `npx iron-edge office --sem-update` pula.
260
260
 
@@ -79,11 +79,12 @@ você — use os caminhos absolutos via Bash:
79
79
  - **Trilha P (e P+A, P+C):** referência é só estrutura e ideia, nunca texto,
80
80
  imagem, depoimento ou marca dela. Entradas obrigatórias: URL/texto da referência ·
81
81
  produto, preço e público · provas que o dono tem. Faltou uma = pergunte, não
82
- suponha. Todo dado sem fonte (número, depoimento, resultado, preço não informado)
82
+ suponha (no Iron Office, preço e provas que faltam viram campos do formulário do fim). Todo dado sem fonte (número, depoimento, resultado, preço não informado)
83
83
  vira `[PREENCHER: o que conseguir]`. A voz é a do DONO da página (o aluno): o
84
84
  formato que vende manda na estrutura, a voz do dono manda nas palavras. Sem voz
85
85
  na ficha da loja, devolva à sessão principal as perguntas de voz da
86
- `clone-persuasion` (seção "Voz do dono") antes de escrever o montador.
86
+ `clone-persuasion` (seção "Voz do dono") antes de escrever o montador: no Iron Office isso já vem no pedido (a sessão principal perguntou
87
+ antes de te chamar), então não devolva de novo; use e grave em `## 0. Escolhas`.
87
88
  - **Nunca publique sozinho.** Entregue a pasta e o link local. `vercel deploy` é
88
89
  ação separada e consciente do usuário.
89
90
 
@@ -114,13 +115,21 @@ de tratar como final.
114
115
  - Diga ao usuário a pasta, o link local, e o que os checks acusaram.
115
116
  - Abra o resultado no navegador se ele quiser (`open`).
116
117
  - **Rode a skill `gate`** antes de qualquer coisa ir pro cliente. Nada com
117
- BLOQUEADOR em aberto vai pra frente.
118
- - **Trilha P:** o gate roda com a lista A (fato contra a fonte, promessa,
118
+ BLOQUEADOR em aberto vai pra frente. (Fora do Iron Office, no terminal do dono.)
119
+ - **Dentro do Iron Office NÃO rode o gate.** Devolva à sessão principal (`page_save` → guardar o `id`); ela oferece o gate ao aluno pela `ask` (Sim · Depois). Trilha P: a oferta vem depois da v2.
120
+ Quem decide se roda é o aluno, pelo botão; no Sim, a sessão principal roda a
121
+ skill `gate` (seção "No Iron Office").
122
+ - **Trilha P (fora do Office):** o gate roda com a lista A (fato contra a fonte, promessa,
119
123
  português) sobre o montador.
120
124
  - **Dentro do Iron Office** (sessão `ironoffice`): você não tem as ferramentas do
121
125
  Office. Devolva à sessão principal o caminho do `persuasao.md` e do montador, e
122
126
  peça a ela o `deliver` (o `persuasao.md` inteiro, agente `iron-clone`, título
123
127
  "Página de vendas: <produto>") e o `page_save` da página montada como rascunho.
128
+ Os dados que faltam NÃO vão como "veja na entrega": devolva também (1) 3 linhas
129
+ (o que fez + o risco maior), (2) a lista de CAMPOS pro formulário do chat (`ask` com
130
+ `fields`: id, rótulo, exemplo, kind text/number/money/yesno; até 12) com o que o dono
131
+ sabe, e numa linha cada o que depende de terceiro ("pra conseguir com <quem>"),
132
+ (3) o link da entrega. Seção "Fim da trilha no Iron Office" da `clone-persuasion`.
124
133
 
125
134
  ## Fronteiras com o ecossistema
126
135
  - `clone-distill` termina onde o `lp-cinematico` começa (entrega os placeholders).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iron-edge",
3
- "version": "2.17.0",
3
+ "version": "2.18.0",
4
4
  "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 22 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",
@@ -16,6 +16,9 @@ e escreve a oferta do cliente com esse motivo. A referência entra como estrutur
16
16
  ideia. Texto, imagem, depoimento e marca dela nunca entram na peça do cliente.
17
17
 
18
18
  ## Entradas obrigatórias (falta uma = perguntar, nunca supor)
19
+ No Iron Office quem pergunta é a sessão principal, antes de te chamar: o que veio no
20
+ pedido vale; preço e provas que faltam NÃO travam, viram campos do formulário do fim
21
+ (seção "Fim da trilha no Iron Office").
19
22
  1. **Referência:** URL ou texto colado da página de vendas.
20
23
  2. **Oferta do cliente:** produto, preço, público. Preço só o que o cliente informou
21
24
  ou o que está escrito numa fonte dele (ficha, checkout medido). Sem preço
@@ -42,8 +45,9 @@ cada uma manda num pedaço:
42
45
  1. A ficha da loja (`Projetos/<pasta>/PROJETO.md`, seção `## Voz` ou o campo
43
46
  "Tom de voz"). Página para cliente seu: o `## Voz` do Brandkit dele, se existir.
44
47
  2. **Ouvir o dono antes de escrever** quando a ficha não tem voz, ou só tem o rótulo
45
- ("Próximo"). No Iron Office, UMA pergunta por mensagem pela `ask`; no terminal, as 3
46
- juntas numeradas:
48
+ ("Próximo"). No Iron Office isso já veio no pedido (a sessão principal perguntou
49
+ antes de te chamar): não pergunte de novo, use e grave. No terminal, as 3 juntas
50
+ numeradas:
47
51
  - "Me manda um texto seu que vendeu (post, mensagem de WhatsApp, legenda)." (skip permitido)
48
52
  - "Como você fala com o seu cliente?" (Formal · Próximo · Divertido · Direto e agressivo)
49
53
  - "Tem alguma palavra ou jeito de falar que você NÃO quer na sua página?" (skip permitido)
@@ -57,7 +61,9 @@ cada uma manda num pedaço:
57
61
  deixar no topo do `persuasao.md`: "Voz não confirmada: me diga se soa como você".
58
62
 
59
63
  ## Escolha antes de escrever: reaproveitar frases da referência?
60
- UMA pergunta, antes da etapa 1 (no Iron Office pela `ask`; no terminal, numerada):
64
+ No Iron Office a resposta já vem no pedido (a sessão principal perguntou antes de te
65
+ chamar): grave em `## 0. Escolhas` e não pergunte. No terminal, UMA pergunta, antes da
66
+ etapa 1, numerada:
61
67
  "Quer que eu reaproveite frases da página de referência?"
62
68
  - **Não, escreva do zero (recomendado)**: padrão. A anti-cópia barra (saída 1 = reescrever).
63
69
  - **Sim, pode reaproveitar trechos**: a anti-cópia roda com `--aviso` (lista os
@@ -166,6 +172,40 @@ tem acesso a elas). Ao terminar: `deliver` com o `persuasao.md` inteiro (agente
166
172
  `page_save` (plugin antigo), entregue a pasta e diga em 1 linha: "Pra página aparecer
167
173
  em Entregas e Páginas, feche e abra o ironoffice". Fora do Office: só a pasta.
168
174
 
175
+ **As perguntas de antes já vêm feitas.** No Office, a sessão principal pergunta pela
176
+ `ask` ANTES de chamar o iron-clone ("reaproveitar frases?" e, sem voz na ficha, as 3
177
+ de voz) e passa as respostas no pedido. Grave-as em `## 0. Escolhas` e NÃO pergunte
178
+ de novo. Escolha que não veio no pedido = Não (escrever do zero).
179
+
180
+ ## Fim da trilha no Iron Office (plugin 0.13.0+): as perguntas ficam no chat
181
+ O que falta não vai pra um relatório: vira formulário no chat.
182
+
183
+ **Dentro do Iron Office NÃO rode o gate.** Devolva à sessão principal (`page_save` → guardar o `id`); ela oferece o gate ao aluno pela `ask` (Sim · Depois). Trilha P: a oferta vem depois da v2.
184
+ (Fora do Office, no terminal do dono, o gate do iron-clone STEP 5 continua igual.)
185
+
186
+ 1. Separe os `[PREENCHER]` em dois grupos:
187
+ - **O dono sabe** (preço, garantia, frete, prazo, isca grátis, quem paga a troca,
188
+ número de membros, quantidade): cada um vira um CAMPO do formulário
189
+ `{ id, label (até 80), placeholder (até 60), kind: text | number | money | yesno }`.
190
+ - **Depende de terceiro** (print do fornecedor, autorização de depoimento, laudo):
191
+ 1 linha cada, "pra conseguir com <quem>: <o quê>".
192
+ 2. Devolva à sessão principal, nesta ordem, e ela manda no chat:
193
+ (1) 3 linhas: o que você fez e o risco maior da página;
194
+ (2) o formulário (`ask` com `fields`, até 12 campos; mais de 12, o 2º só depois do
195
+ 1º voltar), com a lista do que depende de terceiro na pergunta ou numa linha logo antes;
196
+ (3) 1 linha com o link da entrega ("ver relatório completo" é o último link, nunca o
197
+ caminho das perguntas).
198
+ Nunca "faltam N dados, veja na entrega".
199
+ Se a `ask` recusar `fields` (site ou plugin antigo): a sessão principal diz em 1 linha
200
+ "Pra responder num formulário, feche e abra o ironoffice" e pergunta um dado por vez
201
+ (`ask` com free e skip). Nunca vira lista no relatório.
202
+ 3. Quando o ÚLTIMO formulário voltar (uma mensagem com "rótulo: valor" por linha;
203
+ "(pulado)" = o dono pulou), reescreva SÓ o montador (seção 6) com as respostas, sem refazer o
204
+ estudo: valor respondido entra no lugar do `[PREENCHER]`, pulado continua
205
+ `[PREENCHER]` e fica em `## Em aberto`. Rode de novo as checagens 1 e 2 e entregue a
206
+ v2 pelo `deliver` (título "Página de vendas: <produto> (v2)"), na MESMA pasta. Não
207
+ chame `page_save` de novo: o rascunho em Páginas aponta pra pasta, que agora tem a v2.
208
+
169
209
  ## Windows
170
210
  Os scripts rodam com `node` e Python 3. No Windows use `py -3` no lugar de `python3`,
171
211
  com os mesmos argumentos: o `python3` do Windows costuma ser um atalho da Microsoft
@@ -18,6 +18,7 @@ A premissa é o princípio dos quatro olhos: quem escreveu não consegue auditar
18
18
  | Terminou algo local/experimental | Oferecer em uma linha: "Pronto. Rodo o gate?" |
19
19
  | "gate ciclo \<pasta\>" ou "gate lote \<pasta ou lista\>" | Modo lote, seção 7 |
20
20
  | "libera sem gate" | Válvula de escape, seção 8 |
21
+ | Sessão do Iron Office (`ironoffice`), o aluno clicou "Sim, roda o gate" numa página | Gate de PÁGINA, seção 11 |
21
22
 
22
23
  ## 1. Faixas
23
24
 
@@ -320,7 +321,28 @@ O flag é removido ao fechar o parecer (passo 6 da seção 3) ou no bypass (seç
320
321
 
321
322
  **Mitigação sem hook:** amarrar o gate a um momento que já existe no seu fluxo, em vez de a uma lembrança. Antes de apresentar como pronto, ou antes de abrir PR, são os candidatos naturais, porque já são paradas conscientes. Se valer o enforcement duro e portável, o caminho é um hook de `pre-commit` do próprio git, que não depende do shell da máquina.
322
323
 
323
- ## 11. Fase 2 (não fazer sem o dono pedir)
324
+ ## 11. No Iron Office (sessão `ironoffice`)
325
+
326
+ Vale quando a sessão foi aberta pelo `ironoffice` e o aluno pediu o gate de uma página: clicou **"Sim, roda o gate"** no cartão de pergunta de uma página pronta (página de venda do lp-cinematico, página do iron-clone, página criada na Shopify) **ou escreveu** "roda o gate nessa página" (mesmo fluxo, sem perguntar de novo). Fora do Office, as seções 0 a 10 valem como sempre.
327
+
328
+ **Quem decide é o aluno, pelo botão.** Dentro do Office, nenhum agente roda o gate por conta própria no fim da página: a sessão principal pergunta pela `ask` ("Quer que eu rode o gate nessa página?" · Sim, roda o gate · Depois) e só roda no Sim. Na trilha de persuasão, a pergunta só vem depois da v2 (a v1 tem lacunas que o formulário ainda vai preencher).
329
+
330
+ 1. **Faixa VAI SAIR**, sempre: a página vai pro cliente do aluno.
331
+ 2. **Painel de PÁGINA, no máximo 4 lentes**, em paralelo, com o prefixo comum da seção 5:
332
+ - ★ **FATO CONTRA A FICHA**: todo preço, prazo, garantia, frete, nome de produto e número da página conferido contra a ficha da loja e a fonte (produto na Shopify, formulário que o aluno respondeu). Dado inventado ou que diverge da ficha é BLOQUEADOR.
333
+ - **PROMESSA E CTA**: a página promete o que o produto entrega? CTA único e coerente, link do botão aponta pro lugar certo, nenhuma promessa que a loja não cumpre.
334
+ - **PORTUGUÊS E VOZ**: ortografia (ou o idioma da loja), anti-vícios de IA, a voz da loja (seção `## Voz` da ficha, quando existe).
335
+ - **CONTRASTE E LEGIBILIDADE**: texto sobre o fundo real, leitura no celular (largura ~390 px), botão com ≥ 44 px.
336
+ 3. **Preflight** como na seção 4. Página com mais de 1 arquivo HTML: audita o montado ou o publicado (o que o cliente vai ver), não a pasta inteira.
337
+ 4. **Parecer** em `<pasta-da-página>/_auditoria/AAAA-MM-DD-gate-<slug>.md` e a linha do ledger, como na seção 6. Página que só existe na Shopify (sem pasta): parecer em `_auditoria/` da pasta da loja.
338
+ 5. **O parecer termina com `## Cartão`**, um bloco JSON no formato do iron-auditor:
339
+ `{ "kind": "auditoria", "owner": true, "score": <0 a 10>, "summary": "<até 160 caracteres: o veredito em português de gente>", "items": [{ "title": "...", "why": "...", "effort": "baixo|médio|alto", "action": "Iron, corrige isso em <página>: <o quê>" }] }` com até 3 itens, os piores primeiro. Sem achado: `items` vazio.
340
+ 6. **A sessão principal entrega**: `deliver` com `agent` "gate", `type` "gate", o parecer em `content`, o JSON do Cartão em `card` e a página: `url` se ela está no ar (página da Shopify: o endereço público dela, lido pelo `shop_query`), senão `page_id` (o `id` que o `page_save` devolveu). A nota aparece na linha da página na aba Páginas. Sem `url` e sem o `page_id` (o id se perdeu): entregue mesmo assim e diga numa linha do `reply` que a nota não entrou na aba Páginas; não chame `page_save` de novo só pra pegar o id (rascunho sem URL duplicaria a linha).
341
+ 7. **O `reply` final**: 3 linhas (a nota, o maior achado, o próximo passo) e a url do parecer POR ÚLTIMO. Nunca em prosa longa, nunca "digite gate".
342
+
343
+ **Aluno-zero:** no parecer, caminho de arquivo é sempre RELATIVO à pasta da página (o parecer vai pro site); o parecer e o cartão não levam caminho pessoal, nome de cliente de outra loja nem nada do ledger de outra pessoa. **Tempo alvo: 4 minutos.** Correção pedida pelo aluno ("Iron, corrige isso em…") reentra como rodada 2 só das lentes que reprovaram (seção 3, passo 7).
344
+
345
+ ## 12. Fase 2 (não fazer sem o dono pedir)
324
346
 
325
347
  - **Kit de primeira rodada:** arquivo de colagem com esta skill embutida + uma peça de exemplo propositalmente defeituosa + o resultado esperado ("deve sair REPROVADO com 2 bloqueadores"), para quem instala VER o gate funcionar em vez de ler que ele funciona.
326
348
  - **Plugin com os hooks já montados**, só como caminho avançado para quem usa git — nunca como o caminho padrão de instalação.
@@ -776,4 +776,6 @@ You receive this entire document as one prompt. Do not ask clarifying questions.
776
776
 
777
777
  If a `{{PLACEHOLDER}}` is empty, output a clearly visible `[TODO]` marker. Do not invent filler.
778
778
 
779
+ **No Iron Office (sessão `ironoffice`):** depois do `page_save`, a sessão principal oferece o gate ao aluno por botão (`ask`: Sim, roda o gate · Depois). Não rode o gate sozinho: guarde o `id` que o `page_save` devolveu, ele vira o `page_id` do `deliver` do gate.
780
+
779
781
  **Build it.**