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 +1 -1
- package/agents/iron-clone.md +13 -4
- package/package.json +1 -1
- package/skills/clone-persuasion/SKILL.md +43 -3
- package/skills/gate/SKILL.md +23 -1
- package/skills/lp-cinematico/SKILL.md +2 -0
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
|
|
package/agents/iron-clone.md
CHANGED
|
@@ -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
|
-
- **
|
|
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.
|
|
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
|
|
46
|
-
|
|
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
|
-
|
|
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
|
package/skills/gate/SKILL.md
CHANGED
|
@@ -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.
|
|
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.**
|