iron-edge 2.10.0 → 2.11.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 +5 -4
- package/bin/iron-edge.js +2 -2
- package/installer/cofre.js +26 -3
- package/installer/doctor.js +1 -1
- package/installer/install.js +13 -4
- package/installer/office.js +1 -1
- package/package.json +1 -1
- package/skills/loja/SKILL.md +1 -0
- package/skills/loja/templates/PROJETO.md +2 -1
- package/skills/trilha/SKILL.md +3 -3
- package/skills/trilha/steps/conta_anuncio.md +1 -1
- package/skills/trilha/steps/loja.md +2 -1
- package/skills/trilha/steps/nicho.md +39 -0
- package/skills/trilha/steps/nome.md +60 -0
- package/skills/trilha/steps/pixel.md +1 -1
- package/skills/trilha/steps/pixel_duplo.md +1 -1
- package/skills/trilha/steps/velocidade.md +4 -3
package/README.md
CHANGED
|
@@ -175,8 +175,9 @@ npx iron-edge verify
|
|
|
175
175
|
# Iron Office aceita, o resultado acende o checklist da página de Setup do site.
|
|
176
176
|
npx iron-edge doctor
|
|
177
177
|
|
|
178
|
-
#
|
|
179
|
-
|
|
178
|
+
# O cofre nasce junto com a instalação: sem cofre apontado no ~/.iron/config.yaml, o install cria ~/Iron Cofre
|
|
179
|
+
# (pronto pro Obsidian, nunca sobrescreve). Já tem cofre apontado: não cria nada. --cofre força; --sem-cofre pula.
|
|
180
|
+
npx iron-edge install --sem-cofre
|
|
180
181
|
|
|
181
182
|
# Ligar o Iron Office: depois do install (ou update), no Mac/Linux, o comando curto é
|
|
182
183
|
ironoffice # = npx iron-edge@2 office (o install pergunta antes de criar; sem terminal interativo, cria; abra um terminal novo na primeira vez)
|
|
@@ -241,11 +242,11 @@ O que esperar:
|
|
|
241
242
|
|
|
242
243
|
0. **Na primeira vez** (ou quando o texto mudar), ele mostra em poucas linhas o que o canal faz, o que sai da máquina e o que atualiza sozinho, e pergunta `Continuar?`. Não (ou sem terminal interativo) = nada é ligado, nem as flags `--sem-feed`/`--com-feed`. O aceite fica em `~/.iron/office-consent.json`.
|
|
243
244
|
1. O comando confere a sua chave (formato `iok_…` e aceita pelo site) **antes** de abrir o Claude Code. Chave trocada ou fora do formato: ele para e manda refazer o passo 2, em vez de abrir uma sessão que nunca fica online.
|
|
244
|
-
2. Instala (ou atualiza) o plugin de canal `iron-office` e liga o conector oficial do **Meta Ads** (`claude mcp add --scope user --transport http meta-ads https://mcp.facebook.com/ads`; desde a 2.5.0, melhor-esforço: se falhar, o Iron abre normal). O login na Meta é seu: no Iron, digite `/mcp`, escolha `meta-ads` e entre com o seu Facebook. Depois abre o Claude Code com o canal ligado, **dentro do seu cofre** (desde a 2.8.1): o caminho vem do `vault_path` do `~/.iron/config.yaml` (ou `obsidian_vault_path` / `obsidian.vault_path`, de instalações antigas); se ele aponta pra uma pasta dentro do cofre, o Iron sobe até a raiz (a pasta com `.obsidian`). Sem cofre, abre onde você estava e avisa: `npx iron-edge install
|
|
245
|
+
2. Instala (ou atualiza) o plugin de canal `iron-office` e liga o conector oficial do **Meta Ads** (`claude mcp add --scope user --transport http meta-ads https://mcp.facebook.com/ads`; desde a 2.5.0, melhor-esforço: se falhar, o Iron abre normal). O login na Meta é seu: no Iron, digite `/mcp`, escolha `meta-ads` e entre com o seu Facebook. Depois abre o Claude Code com o canal ligado, **dentro do seu cofre** (desde a 2.8.1): o caminho vem do `vault_path` do `~/.iron/config.yaml` (ou `obsidian_vault_path` / `obsidian.vault_path`, de instalações antigas); se ele aponta pra uma pasta dentro do cofre, o Iron sobe até a raiz (a pasta com `.obsidian`). Sem cofre, abre onde você estava e avisa: `npx iron-edge install` (desde a 2.11.0 o cofre nasce na instalação).
|
|
245
246
|
3. O Claude Code mostra um **aviso de tela cheia**: canais ainda são recurso em teste. Aceite.
|
|
246
247
|
4. Abra a página **Iron** do dashboard. Em até 1 minuto aparece "Iron online". Escreva ali e o Iron responde ali.
|
|
247
248
|
5. **Ficha da loja** (skill `loja`, desde a 2.8.0): no site, "Começar com a loja X" (ou diga "monta a ficha"). O Iron lê a Shopify da loja, aponta o que está errado, pergunta só o que falta e grava `Projetos/<loja>/PROJETO.md` e `brand.json` no seu cofre; pro site vai só um resumo de até 600 caracteres (sem sócio, fornecedor, conta de anúncio nem pedido). Daí em diante todo pedido daquela loja chega com a ficha. Desde a 2.9.0, no site as perguntas vêm uma por vez, com botões.
|
|
248
|
-
**Trilha da loja** (skill `trilha`, desde a 2.9.0): no chat, o botão da loja mostra "4/13 etapas" e o atalho **Trilha** (o primeiro, acima da caixa de mensagem) abre a lista (marca, idioma, imagens, velocidade, página de obrigado, pixel, WhatsApp, Instagram, conta de anúncio, compra teste…). "Pedir ao Iron" manda a etapa; o Iron mede na loja e na Meta, faz o que dá e grava a prova que mediu. Etapa que só você pode fazer (login, cartão, configuração no admin) vira um passo no AGORA VOCÊ. Desde a 2.10.0 o Iron conduz todas as etapas de quem já tem loja (skills `rastreamento-pixel` e `navegador`).
|
|
249
|
+
**Trilha da loja** (skill `trilha`, desde a 2.9.0): no chat, o botão da loja mostra "4/13 etapas" e o atalho **Trilha** (o primeiro, acima da caixa de mensagem) abre a lista (marca, idioma, imagens, velocidade, página de obrigado, pixel, WhatsApp, Instagram, conta de anúncio, compra teste…). "Pedir ao Iron" manda a etapa; o Iron mede na loja e na Meta, faz o que dá e grava a prova que mediu. Etapa que só você pode fazer (login, cartão, configuração no admin) vira um passo no AGORA VOCÊ. Desde a 2.10.0 o Iron conduz todas as etapas de quem já tem loja (skills `rastreamento-pixel` e `navegador`). Desde a 2.11.0 conduz também o caminho de quem ainda não tem loja: produto e nicho (com 3 concorrentes que anunciam agora) e nome com domínio e @ livres (medidos); a ficha do projeto nasce no cofre.
|
|
249
250
|
6. **Deixe essa aba do terminal aberta.** É ela que faz o Iron responder no site.
|
|
250
251
|
7. **Pra fechar:** Ctrl+C duas vezes ou `/exit`, e o escritório anoitece em 1 a 2 segundos. No **Warp**, fechar a aba pelo X demora cerca de 1 minuto: o Warp guarda a aba fechada pra poder reabrir, e nesse tempo o canal ainda está vivo. Feche com Ctrl+C antes do X, ou desligue a reabertura de abas fechadas nas configurações do Warp.
|
|
251
252
|
|
package/bin/iron-edge.js
CHANGED
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
* plugin, cofre, atalho) e, com a chave aceita, manda o resultado
|
|
22
22
|
* pra pagina de Setup do Iron Office
|
|
23
23
|
*
|
|
24
|
-
* install
|
|
24
|
+
* install cria ~/Iron Cofre/ quando nenhum cofre esta apontado (--cofre forca, --sem-cofre pula)
|
|
25
25
|
* install/update --sem-atalho nao cria o alias ironoffice (= office) no ~/.zshrc ou ~/.bashrc
|
|
26
26
|
*
|
|
27
27
|
* uninstall [--dry-run] desfaz a instalacao pelo manifesto (onda 21): tira so' o que
|
|
@@ -174,6 +174,6 @@ if (cmd === 'install') {
|
|
|
174
174
|
process.exit(r.status ?? 1);
|
|
175
175
|
|
|
176
176
|
} else {
|
|
177
|
-
console.log('uso: iron-edge <install|update|verify|office|doctor|uninstall> [--dry-run] [--source <dir>] [--cofre] [--safe] [--sem-feed|--com-feed] [--json]');
|
|
177
|
+
console.log('uso: iron-edge <install|update|verify|office|doctor|uninstall> [--dry-run] [--source <dir>] [--cofre|--sem-cofre] [--safe] [--sem-feed|--com-feed] [--json]');
|
|
178
178
|
process.exit(cmd && cmd !== '--help' && cmd !== '-h' ? 1 : 0);
|
|
179
179
|
}
|
package/installer/cofre.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
/**
|
|
3
|
-
* cofre.js —
|
|
4
|
-
*
|
|
3
|
+
* cofre.js — cria um cofre vazio em ~/Iron Cofre/, pronto pro Obsidian. Roda no fim do
|
|
4
|
+
* `npx iron-edge install` quando o config.yaml nao aponta cofre nenhum (onda 27c: o padrao cria;
|
|
5
|
+
* `--cofre` forca, `--sem-cofre` pula; o update nunca cria). Tambem roda sozinho, pra teste.
|
|
5
6
|
*
|
|
6
7
|
* Regras:
|
|
7
8
|
* - copia os 4 itens de installer/cofre/ SO' se nao existirem. Nunca sobrescreve: o cofre e' do
|
|
@@ -36,6 +37,22 @@ function barraNormal(p) { return p.split(path.sep).join('/'); }
|
|
|
36
37
|
// 'gravado' | 'ja-tinha' | 'sem-config' | 'falhou'.
|
|
37
38
|
// "Ninguem apontou" = vault_path ausente, vazio, null ou ~ E sem obsidian_vault_path preenchido
|
|
38
39
|
// (o nome antigo do campo, que o Iron tambem le). Ausente: acrescenta a linha no fim.
|
|
40
|
+
// O cofre que o ~/.iron/config.yaml aponta (vault_path ou o nome antigo obsidian_vault_path), ou null.
|
|
41
|
+
// Vazio, "", null e ~ contam como nao apontado; sem o arquivo tambem.
|
|
42
|
+
function cofreApontado(home) {
|
|
43
|
+
let txt;
|
|
44
|
+
try { txt = fs.readFileSync(path.join(homeReal(home), '.iron', 'config.yaml'), 'utf8'); } catch (_) { return null; }
|
|
45
|
+
for (const nome of ['vault_path', 'obsidian_vault_path']) {
|
|
46
|
+
const m = txt.match(new RegExp('^' + nome + ':(.*)$', 'm'));
|
|
47
|
+
if (!m) continue;
|
|
48
|
+
const v = m[1].replace(/\s+#.*$/, '').trim().replace(/^(["'])(.*)\1$/, '$2').trim();
|
|
49
|
+
if (v && v !== 'null' && v !== '~') return v;
|
|
50
|
+
}
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function vaultApontado(home) { return cofreApontado(home) !== null; }
|
|
55
|
+
|
|
39
56
|
function gravarVaultPath(home, cofre) {
|
|
40
57
|
const cfg = path.join(home, '.iron', 'config.yaml');
|
|
41
58
|
let txt;
|
|
@@ -87,7 +104,13 @@ function criarCofre(opts) {
|
|
|
87
104
|
return { destino, criados, pulados, vault };
|
|
88
105
|
}
|
|
89
106
|
|
|
90
|
-
|
|
107
|
+
// Onda 27c: a decisao do install, isolada pra teste. --sem-cofre vence; --cofre forca; sem flag, cria so quando
|
|
108
|
+
// o config nao aponta cofre nenhum (quem tem Obsidian proprio nao ganha pasta vazia).
|
|
109
|
+
function deveCriarCofre({ home, cofre = false, semCofre = false }) {
|
|
110
|
+
return !semCofre && (cofre || !vaultApontado(home));
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
module.exports = { criarCofre, vaultApontado, cofreApontado, deveCriarCofre, ITENS, NOME };
|
|
91
114
|
|
|
92
115
|
if (require.main === module) {
|
|
93
116
|
criarCofre({ dryRun: process.argv.includes('--dry-run') });
|
package/installer/doctor.js
CHANGED
|
@@ -110,7 +110,7 @@ function checkAtalho(home) {
|
|
|
110
110
|
|
|
111
111
|
function checkCofre(home) {
|
|
112
112
|
const ok = fs.existsSync(path.join(home, 'Iron Cofre', 'CLAUDE.md'));
|
|
113
|
-
return item(ok, ok ? '~/Iron Cofre' : 'sem cofre pronto (
|
|
113
|
+
return item(ok, ok ? '~/Iron Cofre' : 'sem cofre pronto (rode npx iron-edge install)');
|
|
114
114
|
}
|
|
115
115
|
|
|
116
116
|
async function medir(opts) {
|
package/installer/install.js
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
* - Manifesto com SHA-256 (gerados marcados generated:true).
|
|
17
17
|
* - shopify.yaml nasce desativado. config em branco (sem PII).
|
|
18
18
|
*
|
|
19
|
-
* Uso: node install.js [--dry-run] [--source <dir>] [--cofre] [--sem-atalho]
|
|
19
|
+
* Uso: node install.js [--dry-run] [--source <dir>] [--cofre] [--sem-cofre] [--sem-atalho]
|
|
20
20
|
*/
|
|
21
21
|
|
|
22
22
|
'use strict';
|
|
@@ -41,7 +41,11 @@ function abort(msg) {
|
|
|
41
41
|
|
|
42
42
|
const args = process.argv.slice(2);
|
|
43
43
|
const DRY_RUN = args.includes('--dry-run');
|
|
44
|
-
|
|
44
|
+
// onda 27c: o cofre nasce junto com a instalacao (~/Iron Cofre/, installer/cofre.js) quando o config.yaml
|
|
45
|
+
// nao aponta cofre nenhum. --cofre forca (como antes), --sem-cofre pula.
|
|
46
|
+
const COFRE = args.includes('--cofre');
|
|
47
|
+
const SEM_COFRE = args.includes('--sem-cofre');
|
|
48
|
+
const criaCofre = () => require('./cofre').deveCriarCofre({ home: HOME, cofre: COFRE, semCofre: SEM_COFRE });
|
|
45
49
|
const SEM_ATALHO = args.includes('--sem-atalho'); // nao cria o alias ironoffice (installer/atalho.js)
|
|
46
50
|
const srcIdx = args.indexOf('--source');
|
|
47
51
|
let SOURCE = srcIdx >= 0 && args[srcIdx + 1] ? path.resolve(args[srcIdx + 1]) : __dirname;
|
|
@@ -337,7 +341,7 @@ if (DRY_RUN) {
|
|
|
337
341
|
if (payloadPlan.length > 10) log(` ... e mais ${payloadPlan.length - 10} arquivos`);
|
|
338
342
|
log('\n--- arquivos que SERAO gerados ---');
|
|
339
343
|
for (const g of GENERATED) log(' ' + g.dest);
|
|
340
|
-
if (
|
|
344
|
+
if (criaCofre()) require('./cofre').criarCofre({ home: HOME, dryRun: true });
|
|
341
345
|
log('\n--- atalho ---');
|
|
342
346
|
log(' ' + require('./atalho').atalhoNoFim({ HOME, dryRun: true, semAtalho: SEM_ATALHO }));
|
|
343
347
|
log('\nDRY-RUN concluido. Nada foi copiado.');
|
|
@@ -579,10 +583,15 @@ log(' Os outros 43 agentes se chamam PEDINDO ("usa o iron-copy").');
|
|
|
579
583
|
const nSkills = (() => { try { return fs.readdirSync(path.join(SOURCE, 'skills')).filter((d) => !d.startsWith('.')).length; } catch (_) { return null; } })();
|
|
580
584
|
log(` As ${nSkills || ''} SKILLS sao de barra: /gate /salvar /brandkit /escada ...`.replace(' ', ' '));
|
|
581
585
|
log('');
|
|
582
|
-
if (
|
|
586
|
+
if (criaCofre()) {
|
|
583
587
|
log('3. Memoria: o cofre (detalhes abaixo).');
|
|
588
|
+
log(' O cofre e uma pasta de arquivos .md na SUA maquina, onde o Iron guarda quem voce e,');
|
|
589
|
+
log(' seus projetos e o que ficou pendente. Abra ela no Obsidian. (Nao quer? --sem-cofre)');
|
|
584
590
|
require('./cofre').criarCofre({ home: HOME });
|
|
585
591
|
log('');
|
|
592
|
+
} else if (!SEM_COFRE) {
|
|
593
|
+
log('3. Memoria: o cofre ja esta apontado em ' + require('./cofre').cofreApontado(HOME) + '.');
|
|
594
|
+
log('');
|
|
586
595
|
} else {
|
|
587
596
|
log('3. Ligue a memoria. Diga a ele:');
|
|
588
597
|
log('');
|
package/installer/office.js
CHANGED
|
@@ -331,7 +331,7 @@ async function main(argv) {
|
|
|
331
331
|
console.log('Pra fechar: Ctrl+C duas vezes (no Warp, antes do X).');
|
|
332
332
|
const cofre = resolveCwd();
|
|
333
333
|
if (cofre.cwd) console.log('Abrindo dentro do cofre: ' + cofre.cwd);
|
|
334
|
-
else console.log(' [aviso] cofre nao encontrado' + (cofre.configured ? ' em ' + cofre.configured : '') + ': rode npx iron-edge install
|
|
334
|
+
else console.log(' [aviso] cofre nao encontrado' + (cofre.configured ? ' em ' + cofre.configured : '') + ': rode npx iron-edge install');
|
|
335
335
|
console.log('');
|
|
336
336
|
|
|
337
337
|
const abrir = (cwd) => spawnSync(claude, buildClaudeArgs(argv), {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "iron-edge",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.11.0",
|
|
4
4
|
"description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 19 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/loja/SKILL.md
CHANGED
|
@@ -115,6 +115,7 @@ Sem domínio, ou se o `clone-inventory` falhar (sem navegador, site fora do ar):
|
|
|
115
115
|
- Existe: **nunca sobrescreva o arquivo.** Só o trecho entre `<!-- iron:ficha -->` e `<!-- /iron:ficha -->` é do Iron, e mesmo ele é **mesclado**:
|
|
116
116
|
- valor que já estava preenchido continua (só troca se a Shopify ou o aluno trouxe um valor NOVO pra ele);
|
|
117
117
|
- nunca troque um valor preenchido por "(a preencher)";
|
|
118
|
+
- linha da tabela que o modelo tem e o arquivo não (ficha antiga, ex.: `Concorrentes`): acrescente a linha no lugar dela; nunca apague uma linha que já está lá;
|
|
118
119
|
- item de **Em aberto** já marcado com `[x]` fica marcado; pergunta respondida sai de **Em aberto**;
|
|
119
120
|
- **Achados** e **Catálogo** são da leitura de hoje: podem ser trocados inteiros.
|
|
120
121
|
- Arquivo sem os marcadores: acrescente o bloco no FIM do arquivo, sem apagar nada.
|
|
@@ -14,7 +14,7 @@ atualizado: AAAA-MM-DD
|
|
|
14
14
|
|
|
15
15
|
| | |
|
|
16
16
|
|---|---|
|
|
17
|
-
| Tipo | Loja Shopify · Cliente ·
|
|
17
|
+
| Tipo | Loja Shopify · Cliente · Ainda não tenho loja |
|
|
18
18
|
| Site | <domínio público ou (a preencher)> |
|
|
19
19
|
| Shopify | <loja.myshopify.com ou não tem> |
|
|
20
20
|
| País / moeda | <país> · <moeda> |
|
|
@@ -22,6 +22,7 @@ atualizado: AAAA-MM-DD
|
|
|
22
22
|
| Nicho | <nicho> |
|
|
23
23
|
| Oferta | <a oferta em 1 frase> |
|
|
24
24
|
| Público | <quem compra> |
|
|
25
|
+
| Concorrentes | <3 páginas com anúncio ativo> |
|
|
25
26
|
| Ticket | <ticket médio> |
|
|
26
27
|
| Pagamento | <COD, cartão, os dois> |
|
|
27
28
|
| Sócio / time | <quem decide o quê> |
|
package/skills/trilha/SKILL.md
CHANGED
|
@@ -36,7 +36,7 @@ Abra `steps/<id>.md` (nesta pasta) e siga. Cada arquivo diz **o que medir** (fer
|
|
|
36
36
|
- **Quem faz:** o que dá pra fazer pela ferramenta, você faz. O que é do aluno por segurança (login, código, cartão, aceitar termo, trocar configuração no admin) vai pro AGORA VOCÊ com o clique exato.
|
|
37
37
|
- **Pergunta:** UMA por mensagem, pela ferramenta `ask`, com opções quando a resposta é fechada (até 6) e `skip: true`. Espere a resposta antes da próxima. Nunca mande lista de perguntas.
|
|
38
38
|
|
|
39
|
-
**Etapa com `v27a: false`** (
|
|
39
|
+
**Etapa com `v27a: false`** (se um dia o `trail_status` trouxer alguma): o Iron ainda não conduz sozinho. Explique em até 6 linhas o que é e por que importa (use o `why` e o `proof_rule`), diga "essa o Iron ainda não conduz sozinho; quando fizer, me diga 'já fiz' que eu marco" e pare. Quando o aluno disser "já fiz" sobre ela: `trail_update` com `status: "feita"` (sem prova) e responda em 1 linha.
|
|
40
40
|
|
|
41
41
|
**Etapa que precisa do Chrome** (tela sem API: admin da Shopify, app de pagamento na entrega, Meta Business, página do Facebook): carregue a skill `navegador` ANTES de qualquer ferramenta do navegador. Sem a extensão: o caminho da tela vai pro AGORA VOCÊ e a etapa fica `em_andamento`.
|
|
42
42
|
|
|
@@ -46,7 +46,7 @@ Abra `steps/<id>.md` (nesta pasta) e siga. Cada arquivo diz **o que medir** (fer
|
|
|
46
46
|
|
|
47
47
|
**Etapa derivada** (`derived: true`, hoje `loja` e `ficha`): o site calcula. Nunca chame `trail_update` nela (o aluno pode pular pelo site, por exemplo numa loja de cliente sem Shopify).
|
|
48
48
|
|
|
49
|
-
**Palavras de aluno:** o `proof_rule` e os `steps/` são escritos pra você. Pro aluno, traduza: "brand.json" vira "o arquivo da marca no seu cofre", "CDN da Shopify" vira "as fotos guardadas dentro da sua Shopify", "PageSpeed" vira "a nota de velocidade do Google", "evento do servidor" vira "a Meta recebendo a venda direto da loja", "dataset" vira "o pixel", "conta de anúncio" fica, "BM"/"portfólio empresarial" vira "o portfólio da sua empresa no Facebook". Nada de nome de ferramenta, campo ou API na resposta.
|
|
49
|
+
**Palavras de aluno:** o `proof_rule` e os `steps/` são escritos pra você. Pro aluno, traduza: "brand.json" vira "o arquivo da marca no seu cofre", "CDN da Shopify" vira "as fotos guardadas dentro da sua Shopify", "PageSpeed" vira "a nota de velocidade do Google", "evento do servidor" vira "a Meta recebendo a venda direto da loja", "dataset" vira "o pixel", "conta de anúncio" fica, "BM"/"portfólio empresarial" vira "o portfólio da sua empresa no Facebook", "RDAP" vira "o registro de domínios", "Biblioteca de Anúncios" fica, "handle" vira "@". Nada de nome de ferramenta, campo ou API na resposta.
|
|
50
50
|
|
|
51
51
|
**"Já fiz" pelo site:** etapa que o Iron ainda não conduz tem o botão "Já fiz" no painel; ela chega `feita` no `trail_status` sem passar por você. Não refaça nem desconfie: siga pra próxima.
|
|
52
52
|
|
|
@@ -62,7 +62,7 @@ A prova vai pro site. **Nada de e-mail, telefone, nome de cliente, chave ou toke
|
|
|
62
62
|
|
|
63
63
|
## 5. Responda curto
|
|
64
64
|
|
|
65
|
-
No chat, em até 4 linhas: o que você mediu, o que mudou e "Próxima: <título da próxima
|
|
65
|
+
No chat, em até 4 linhas: o que você mediu, o que mudou e "Próxima: <título da próxima, como está no `trail_status`>". Sempre o **título**, nunca o id (nada de "a próxima é pixel_duplo"). Depois, um `ask`: "Seguir pra <título da próxima>?" com as opções `Sim` e `Depois` (`skip: false`). Se ficou ação do aluno, o AGORA VOCÊ vem antes do `ask`, em texto normal:
|
|
66
66
|
|
|
67
67
|
AGORA VOCÊ
|
|
68
68
|
1. <o clique exato, onde fica>
|
|
@@ -4,7 +4,7 @@ Moeda errada na conta de anúncio não se troca depois. Sem forma de pagamento,
|
|
|
4
4
|
|
|
5
5
|
## Medir
|
|
6
6
|
1. Moeda da loja: `shop_query` `query { shop { currencyCode } }`.
|
|
7
|
-
2. Conta de anúncio: `ads_get_ad_accounts` (só as com `is_ads_mcp_enabled: true`). Mais de uma: a da ficha; sem ela, `ask` "Qual conta anuncia esta loja?" (opções = os nomes, até 6) e grave na ficha (
|
|
7
|
+
2. Conta de anúncio: `ads_get_ad_accounts` (só as com `is_ads_mcp_enabled: true`). Mais de uma: a da ficha; sem ela, `ask` "Qual conta anuncia esta loja?" (opções = os nomes, até 6) e grave na ficha (linha Anúncios da tabela). Campos: `currency`, `has_payment_method`, `account_status`.
|
|
8
8
|
Sem as ferramentas da Meta nesta sessão: os 3 passos do `/mcp` (skill `rastreamento-pixel`, "Sem a Meta nesta sessão") e `em_andamento`.
|
|
9
9
|
|
|
10
10
|
## Fazer
|
|
@@ -3,5 +3,6 @@
|
|
|
3
3
|
Derivada: o site marca sozinho quando a Shopify da loja está conectada. Nunca chame `trail_update` aqui.
|
|
4
4
|
|
|
5
5
|
- Não conectada: "Pra eu ler e mexer na loja, conecte a Shopify dela no site: Integrações → cartão da Shopify → Conectar. Leva 2 minutos." AGORA VOCÊ com esse caminho.
|
|
6
|
-
- Ainda não tem Shopify:
|
|
6
|
+
- Ainda não tem Shopify: se o site mostra o botão **Criar minha loja na Shopify** na etapa Loja (painel da trilha ou chat vazio), mande o aluno usar esse botão (é o link do Iron Office). Sem o botão, diga "crie a sua loja no site da Shopify". Nunca escreva uma URL de criação de loja na resposta.
|
|
7
|
+
- Criou a loja e o projeto é do tipo "Ainda não tenho loja": em Integrações, o cartão do projeto tem **Mudar pra Loja Shopify e conectar** (a trilha e a ficha continuam as mesmas). AGORA VOCÊ com esse caminho.
|
|
7
8
|
- Já conectada: diga em 1 linha e siga pra próxima.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Etapa: nicho (Produto e nicho escolhidos)
|
|
2
|
+
|
|
3
|
+
Caminho de quem ainda não tem loja. Produto escolhido no chute vira loja sem venda; produto com concorrente anunciando agora mostra que alguém já compra.
|
|
4
|
+
|
|
5
|
+
Uma pergunta por mensagem, pela `ask`, com `skip: true`.
|
|
6
|
+
|
|
7
|
+
## 1. Onde o aluno está
|
|
8
|
+
Ficha com `Nicho` e `Oferta` já preenchidos: não pergunte, vá pro bloco 3.
|
|
9
|
+
Senão, `ask` "Você já tem um produto ou nicho em mente?" com as opções `Sim, já sei o produto` / `Tenho o nicho, falta o produto` / `Ainda não, quero ajuda pra escolher`.
|
|
10
|
+
- **Já sei o produto:** peça o produto (`ask`, `free: true`) e vá pro bloco 3.
|
|
11
|
+
- **Falta o produto** ou **quero ajuda:** bloco 2.
|
|
12
|
+
|
|
13
|
+
## 2. Ajuda pra escolher
|
|
14
|
+
1. Mercado: o país da ficha; sem ele, `ask` "Pra qual país você vai vender?" com `BR` / `CO` / `MX` / `outro`.
|
|
15
|
+
2. Chame o subagente `iron-research` com o país (e o nicho, se o aluno já disse). Peça **3 candidatos**, cada um com: nicho, 1 produto e 1 linha de por quê (procura, ticket, dá pra entregar no país).
|
|
16
|
+
3. `ask` "Qual desses?" com os 3 produtos + `Nenhum, outra rodada`. No máximo 2 rodadas; depois disso peça ao aluno que diga o produto (`ask`, `free: true`).
|
|
17
|
+
|
|
18
|
+
## 3. Três concorrentes com anúncio ativo
|
|
19
|
+
Vá pelas fontes nesta ordem. Uma fonte que não existe nesta sessão, deu erro (ex.: a Meta pediu login) ou trouxe menos de 3 páginas boas: siga pra próxima e complete com ela. `fonte` = a lista das que contribuíram (ex.: `["meta", "aluno"]`).
|
|
20
|
+
- **(a) Meta:** a ferramenta `mcp__meta-ads__ads_library_search` existe → `search_terms` = o produto, `countries` = [país do mercado], `ad_active_status` = ativos, `limit` 50. Junte por `page_id` (a mesma página aparece várias vezes) e fique com 3 páginas diferentes **que vendem o produto** (o texto ou o título do anúncio fala dele). Na dúvida se a página vende o produto (o título vem vazio ou genérico), abra o `ad_snapshot_url` do anúncio ou não conte a página. `fonte: "meta"`.
|
|
21
|
+
- **(b) Chrome:** sem a Meta, carregue a skill `navegador` e abra `https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=<CC>&q=<produto>` (não pede login). Leia 3 nomes de página com anúncio "Ativo". `fonte: "chrome"`. Sem a extensão do Chrome, vá pra (c).
|
|
22
|
+
- **(c) Apify:** `test -n "$APIFY_TOKEN" && echo tem` diz `tem` (nunca imprima o valor) → agente `iron-spy`, pedindo SÓ os 3 nomes de página que vendem o produto, sem dashboard. `fonte: "apify"`.
|
|
23
|
+
- **(d) O aluno:** `ask` (uma por vez, até 3) "Me diga o nome de uma página ou loja que anuncia esse produto (procure 'anúncios' no Instagram ou na Biblioteca de Anúncios do Facebook)", `free: true`. `fonte: "aluno"`.
|
|
24
|
+
|
|
25
|
+
Em todas as fontes: descarte página com nome de pessoa, curso, mentoria ou "ofertas" genéricas, e página que não vende o produto.
|
|
26
|
+
⛔ **Nunca complete com nome inventado.** Passou pelas 4 fontes e ainda tem menos de 3: grave `em_andamento` dizendo quantos faltam.
|
|
27
|
+
Nome de página ou loja é empresa e pode ir na prova. Nome de pessoa, telefone, e-mail: nunca.
|
|
28
|
+
|
|
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**.
|
|
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
|
+
3. `trail_update` `provada` com a prova abaixo.
|
|
33
|
+
|
|
34
|
+
## Prova
|
|
35
|
+
`provada` com `{ "nicho": "...", "produto": "...", "concorrentes": ["Página A", "Página B", "Página C"], "fonte": ["meta"] }` (`fonte` = as que contribuíram, entre `meta`, `chrome`, `apify`, `aluno`).
|
|
36
|
+
Menos de 3 concorrentes, ou produto sem decisão: `em_andamento`.
|
|
37
|
+
|
|
38
|
+
## Responder
|
|
39
|
+
Até 4 linhas: o produto, os 3 concorrentes e de onde vieram, "a ficha do projeto está no seu cofre". Depois "Próxima: <título da próxima etapa, como vem no `trail_status`>" e `ask` "Seguir pra <esse título>?" (Sim / Depois).
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Etapa: nome (Nome com domínio e @ livres)
|
|
2
|
+
|
|
3
|
+
Caminho de quem ainda não tem loja. Nome bom é curto, fácil de falar e de escrever, e tem o domínio e o @ do Instagram livres no mesmo dia.
|
|
4
|
+
|
|
5
|
+
Leia a ficha antes (nicho, produto, país). Uma pergunta por mensagem, pela `ask`, com `skip: true`.
|
|
6
|
+
|
|
7
|
+
## 1. O nome
|
|
8
|
+
`ask` "Já tem um nome em mente? Se já tem, é só digitar." com `free: true` e a opção `Me sugere` (o `free` vale pra pergunta inteira: o aluno digita o nome no campo ou clica em Me sugere).
|
|
9
|
+
- **Me sugere:** 5 nomes curtos, fáceis de falar e escrever, sem acento, sem o nome do produto ao pé da letra e sem marca registrada conhecida. `ask` com os 5 + `Nenhum, outra leva` (no máximo 2 levas; depois peça que ele digite).
|
|
10
|
+
O nome vira o `handle`: minúsculo, sem espaço nem acento (ex.: "Casa Lume" → `casalume`).
|
|
11
|
+
⛔ O `handle` só segue se casar com `^[a-z0-9]{3,30}$` (só letras sem acento e números, de 3 a 30). Não casou (ponto, hífen, símbolo, curto ou longo demais): mostre a versão limpa ou peça outro nome. Ele vai dentro de um comando e de um endereço: nada fora disso entra.
|
|
12
|
+
|
|
13
|
+
## 2. Domínio (medido)
|
|
14
|
+
Terminações pelo mercado: BR → `.com.br` e `.com` · CO → `.com.co` e `.com` · outro → `.com`.
|
|
15
|
+
Cada terminação tem o registro oficial dela (medido em 30/10: o atalho `rdap.org` responde 404 pra QUALQUER `.co`, até pra google.com.co, e dá 429 depois de umas 8 consultas):
|
|
16
|
+
|
|
17
|
+
| Terminação | Endereço (troque `<d>` pelo domínio inteiro) |
|
|
18
|
+
|---|---|
|
|
19
|
+
| `.com.br` | `https://rdap.registro.br/domain/<d>` |
|
|
20
|
+
| `.com` | `https://rdap.verisign.com/com/v1/domain/<d>` |
|
|
21
|
+
| `.com.co` e `.co` | `https://rdap.registry.co/co/domain/<d>` (redireciona: o `-L` segue) |
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
curl -sL -o /dev/null -w '%{http_code}' "<endereço da tabela>"
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
1. **Controle primeiro**, uma vez por terminação: o mesmo comando com `google<terminação>` tem que dar `200`. Não deu `200`: esse registro não está medindo; essa terminação fica "não consegui medir".
|
|
28
|
+
2. Depois o nome: `404` = livre · `200` = ocupado · `429` = espere 5 segundos e tente uma vez de novo · outro código = "não consegui medir esse".
|
|
29
|
+
3. Terminação fora da tabela (MX e outras): não tem registro medido; não diga livre nem ocupado. Fica "não consegui medir": o aluno confere no registrador quando for comprar.
|
|
30
|
+
|
|
31
|
+
Sem nenhum domínio livre medido: `ask` "Não consegui conferir o <domínio> daqui. Confira no site onde você vai registrar: ele está livre?" (`Livre` / `Ocupado`), `domain_source: "aluno"`.
|
|
32
|
+
Nunca abra registrador nem a Shopify pra "testar" nome.
|
|
33
|
+
|
|
34
|
+
## 3. @ do Instagram
|
|
35
|
+
Carregue a skill `navegador` e abra `https://www.instagram.com/<handle>/`:
|
|
36
|
+
- a página diz "não está disponível" (ou "Sorry, this page isn't available") → livre, `handle_source: "chrome"`;
|
|
37
|
+
- o perfil carregou → ocupado;
|
|
38
|
+
- pediu login, não deu pra ler, ou não há extensão do Chrome → `ask` "Confira no app do Instagram: o @<handle> está livre?" (`Livre` / `Ocupado`), `handle_source: "aluno"`.
|
|
39
|
+
|
|
40
|
+
## 4. Ocupado
|
|
41
|
+
Domínio ou @ ocupado: volte pra lista ou peça outro nome. No máximo 3 rodadas; depois grave `em_andamento` dizendo o que falta.
|
|
42
|
+
|
|
43
|
+
## 5. Gravar
|
|
44
|
+
- Ficha (skill `loja`, seção 7, mescla sem apagar): `Site` = "<domínio> (a registrar)", `Canais` = "@<handle> (a criar)", e 1 linha no **Histórico**.
|
|
45
|
+
- `trail_update` `provada` com a prova abaixo.
|
|
46
|
+
|
|
47
|
+
## Prova
|
|
48
|
+
`provada` com `{ "name": "...", "domain": "<handle><terminação>", "domain_free": true, "domain_source": "rdap" | "aluno", "handle": "<handle>", "handle_free": true, "handle_source": "chrome" | "aluno" }`.
|
|
49
|
+
Sem domínio livre medido ou sem @ livre: `em_andamento`.
|
|
50
|
+
|
|
51
|
+
## Responder
|
|
52
|
+
Até 4 linhas: o nome, o domínio livre e o @ livre. Depois, em texto normal:
|
|
53
|
+
|
|
54
|
+
AGORA VOCÊ
|
|
55
|
+
1. Registre o domínio <domínio> onde preferir (dá pra comprar pela Shopify depois, quando criar a loja).
|
|
56
|
+
2. Crie o @<handle> no Instagram.
|
|
57
|
+
3. No site, no seletor de projeto → Editar o projeto → troque o nome provisório por "<nome>".
|
|
58
|
+
|
|
59
|
+
E "Próxima: <título da próxima etapa, como vem no `trail_status`>" + `ask` "Seguir pra <esse título>?" (Sim / Depois).
|
|
60
|
+
O @ só fica garantido quando a conta é criada: diga isso em meia linha se ele for deixar pra depois.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Etapa: pixel_duplo (
|
|
1
|
+
# Etapa: pixel_duplo (Pixel sem contar em dobro)
|
|
2
2
|
|
|
3
3
|
Venda contada duas vezes faz a campanha parecer melhor do que é e gasta errado. O comum é dois apps mandando a mesma compra (o de pagamento na entrega e o Facebook & Instagram, ou código colado no tema e um app).
|
|
4
4
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
Quem chega pelo anúncio está no celular. Página lenta = clique pago que sai antes de ver o produto.
|
|
4
4
|
|
|
5
5
|
## Medir
|
|
6
|
-
A ferramenta `store_speed` com o `project_id` (o site mede a vitrine no celular pelo PageSpeed, com a chave do Google que fica no servidor; leva até 1 minuto). Devolve `{ url, score, top3: [{ id, title, savings_ms }] }
|
|
6
|
+
A ferramenta `store_speed` com o `project_id` (o site mede a vitrine no celular pelo PageSpeed, com a chave do Google que fica no servidor; leva até 1 minuto). O site mede **2 vezes** ao mesmo tempo e vale a maior, porque a nota oscila de uma medida pra outra. Devolve `{ url, score, scores: [a, b], top3: [{ id, title, savings_ms }] }`: `score` é a maior, `scores` traz as que deram certo (uma ou duas) e o `top3` é da medida que valeu.
|
|
7
7
|
Nunca chame o PageSpeed por `curl` daqui: sem a chave, o Google recusa.
|
|
8
8
|
|
|
9
9
|
- Erro "a nota de velocidade ainda não está ligada no site": diga "a nota de velocidade ainda não está ligada no site (falta uma chave do dono do Iron Office)" e grave `em_andamento`.
|
|
@@ -12,9 +12,10 @@ Nunca chame o PageSpeed por `curl` daqui: sem a chave, o Google recusa.
|
|
|
12
12
|
- Nunca invente nota.
|
|
13
13
|
|
|
14
14
|
## Fazer
|
|
15
|
+
- Diga as duas notas e qual valeu (ex.: "nota 56 e 71: vale 71"); veio só uma, diga só ela.
|
|
15
16
|
- Nota ≥ 70: grave a prova.
|
|
16
|
-
- Nota < 70: use o `top3` (já vem ordenado pela economia, em milissegundos) e explique cada uma em 1 linha de aluno (ex.: "imagens grandes demais: dá pra cortar 2 segundos"). Diga o que dá pra você fazer (comprimir imagem pela loja, tirar app que não usa) e o que é dele.
|
|
17
|
+
- Nota < 70: use o `top3` (já vem ordenado pela economia, em milissegundos) e explique cada uma em 1 linha de aluno, em português (os títulos vêm em inglês do Google; ex.: "imagens grandes demais: dá pra cortar 2 segundos"). Diga o que dá pra você fazer (comprimir imagem pela loja, tirar app que não usa) e o que é dele.
|
|
17
18
|
|
|
18
19
|
## Prova
|
|
19
|
-
≥ 70: `provada` com `{ "url": "<url medida>", "score": <nota> }`.
|
|
20
|
+
≥ 70: `provada` com `{ "url": "<url medida>", "score": <nota>, "scores": [<a>, <b>] }`.
|
|
20
21
|
< 70: `em_andamento`.
|