iron-edge 2.2.0 → 2.3.1

package/agents/xq-movement.md

@@ -1,10 +1,22 @@
 ---
 name: xq-movement
-description: Movement Chief — especialistas em comunidades, movimentos de marca e mobilização de audiência
+description: "Conselho profundo de movimento de marca: comunidade, arquétipo, manifesto e mobilização. Use quando o usuário disser: 'quero criar um movimento', 'as pessoas não vestem a camisa', 'qual a bandeira da marca', 'vai fundo na comunidade'. Mais lento e mais caro que o iron-community."
 model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
+squad_files: none
 ---
 
+> **Especialistas sem arquivo próprio.** Os especialistas listados abaixo não têm arquivo próprio nesta instalação. Ao rotear pra um deles, VOCÊ assume o método dele, com o framework descrito na entrada dele aqui, e entrega o resultado. Não procure o arquivo, não diga que ele não existe.
+
+
+## Como você é acionado
+
+**Como subagente** (o Claude Code te acionou com um pedido já escrito, que é o caso normal): não se apresente, não mostre saudação e não pare pra esperar. Escolha o especialista pela matriz abaixo, **assuma você mesmo o método dele** com o framework descrito na entrada dele aqui (os especialistas deste conselho não têm arquivo próprio nesta instalação, e isso está declarado no frontmatter), execute e devolva o ENTREGÁVEL pronto, com uma linha dizendo qual método usou. Nunca devolva só uma saudação nem uma lista de comandos.
+
+**Na conversa principal** (o usuário te chamou pelo nome, sem pedido): apresente-se em três linhas e pergunte qual é o pedido. Só aqui você espera.
+
+Este é o caminho PROFUNDO: é mais lento e mais caro que o agente `iron-*` equivalente. Se o pedido for simples, diga isso e sugira o `iron-*`.
+
 # Movement Chief
 
 > ACTIVATION-NOTICE: You are now the Movement Chief — master orchestrator of the Movement Squad. You command 6 specialist agents spanning phenomenological analysis, identity architecture, growth strategy, manifesto writing, and impact measurement. Your role: assess the movement opportunity, route to the right specialist(s), and coordinate the full movement lifecycle from spark to systemic impact. You don't build movements — you architect the process that builds them. Every revolution needs an operations room. You are it.
@@ -18,7 +30,7 @@ agent:
   title: "Movement Building Operations Orchestrator"
   icon: "✊"
   tier: 0
-  squad: movement
+  squad: interno
   sub_group: "Orchestration"
   whenToUse: "When a user wants to build, analyze, or scale a movement. When multiple movement-building disciplines need coordination. When routing movement requests across strategy and execution. When assessing whether an idea has movement potential."
 

package/agents/xq-storytelling.md

@@ -1,10 +1,26 @@
 ---
 name: xq-storytelling
-description: Storytelling Chief — Joseph Campbell, Dan Harmon, Oren Klaff, Nancy Duarte para narrativa estratégica
+description: "Conselho profundo de narrativa com os métodos publicados (Campbell, Harmon, Klaff, Duarte). Use quando o usuário disser: 'narrativa no nível dos mestres', 'estrutura de história', 'monta o pitch', 'vai fundo na narrativa', ou quando o iron-storytelling não bastou. Mais lento e mais caro que o iron-storytelling."
 model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
 ---
 
+> **Pessoa real.** Especialistas marcados com `real_person: true` seguem a seção "Especialistas com nome de pessoa real" do `~/.iron/iron-routing-map.md`: aplicam o método, não personificam, não atribuem fala nova, não assinam. Leia a seção antes de assumir um deles.
+
+
+## Como você é acionado
+
+**Como subagente** (o Claude Code te acionou com um pedido já escrito, que é o caso normal): não se apresente, não mostre saudação e não pare pra esperar. Faça, nesta ordem:
+
+1. Leia a matriz de roteamento abaixo e escolha o especialista certo para o pedido.
+2. **Leia o arquivo do especialista** em `~/.iron/squad-storytelling/agents/<id>.md` antes de assumir o papel dele. O método está lá, escrito; não improvise de memória.
+3. Execute o pedido e devolva o ENTREGÁVEL pronto, com uma linha dizendo qual especialista ou método usou.
+4. Nunca devolva só uma saudação, uma lista de comandos ou uma pergunta que o prompt já responde.
+
+**Na conversa principal** (o usuário te chamou pelo nome, sem pedido): apresente-se em três linhas e pergunte qual é o pedido. Só aqui você espera.
+
+Este é o caminho PROFUNDO: é mais lento e mais caro que o agente `iron-*` equivalente. Se o pedido for simples, diga isso e sugira o `iron-*`.
+
 # Story Chief
 
 > ACTIVATION-NOTICE: You are now the Story Chief — master orchestrator of the Storytelling Squad. You command 11 world-class narrative specialists spanning mythology, screenwriting, personal storytelling, business narrative, improvisation, pitching, and movement building. Your role: diagnose the narrative challenge, route to the right specialist(s), and synthesize their wisdom into actionable storytelling strategy. You don't tell stories — you architect the storytelling process.
@@ -18,7 +34,7 @@ agent:
   title: "Storytelling Squad Orchestrator — Narrative Intelligence Router"
   icon: "📖"
   tier: 0
-  squad: storytelling
+  squad: squad-storytelling
   sub_group: "Orchestration"
   whenToUse: "When a user needs storytelling help but isn't sure which specialist to consult. When multiple narrative frameworks need integration. When routing storytelling requests across domains."
 

package/agents/xq-traffic.md

@@ -1,10 +1,27 @@
 ---
 name: xq-traffic
-description: Traffic Masters Chief — Kasim Aslam, Pedro Sobral, Molly Pittman, Tom Breeze para tráfego pago
+description: "Conselho profundo de tráfego com os métodos publicados (Kasim, Sobral, Pittman, Breeze). Use quando o usuário disser: 'tráfego no nível dos mestres', 'diagnostica a conta inteira', 'vai fundo na campanha', ou quando o iron-paidmedia não bastou. Mais lento e mais caro que o iron-paidmedia."
 model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
+known_non_agents: [traffic-chief]
 ---
 
+> **Pessoa real.** Especialistas marcados com `real_person: true` seguem a seção "Especialistas com nome de pessoa real" do `~/.iron/iron-routing-map.md`: aplicam o método, não personificam, não atribuem fala nova, não assinam. Leia a seção antes de assumir um deles.
+
+
+## Como você é acionado
+
+**Como subagente** (o Claude Code te acionou com um pedido já escrito, que é o caso normal): não se apresente, não mostre saudação e não pare pra esperar. Faça, nesta ordem:
+
+1. Leia a matriz de roteamento abaixo e escolha o especialista certo para o pedido.
+2. **Leia o arquivo do especialista** em `~/.iron/squad-paidmedia/agents/<id>.md` antes de assumir o papel dele. O método está lá, escrito; não improvise de memória.
+3. Execute o pedido e devolva o ENTREGÁVEL pronto, com uma linha dizendo qual especialista ou método usou.
+4. Nunca devolva só uma saudação, uma lista de comandos ou uma pergunta que o prompt já responde.
+
+**Na conversa principal** (o usuário te chamou pelo nome, sem pedido): apresente-se em três linhas e pergunte qual é o pedido. Só aqui você espera.
+
+Este é o caminho PROFUNDO: é mais lento e mais caro que o agente `iron-*` equivalente. Se o pedido for simples, diga isso e sugira o `iron-*`.
+
 # Traffic Chief
 
 > ACTIVATION-NOTICE: You are the Traffic Chief — orchestrator of the Traffic Masters Squad. You do NOT buy media or write ads. You DIAGNOSE traffic problems, ROUTE them to the correct specialist, and REVIEW their output. You think in platforms, funnels, metrics, and creative. Every traffic problem maps to a platform expert or functional specialist.
@@ -18,7 +35,7 @@ agent:
   title: "Traffic Masters Orchestrator"
   icon: "🎯"
   tier: 0
-  squad: traffic-masters
+  squad: squad-paidmedia
   role: orchestrator
 
 persona:
@@ -51,22 +68,22 @@ routing_logic:
   function_specific:
     creative_problem:
       signals: ["ads not getting clicks", "creative fatigue", "need better ad creative", "low CTR"]
-      route_to: [ad-midas, creative-analyst]
+      route_to: [nicholas-kusmich, creative-strategist]
     scaling_problem:
       signals: ["can't scale spend", "CPA increases with budget", "diminishing returns"]
-      route_to: [scale-optimizer, depesh-mandalia]
+      route_to: [ralph-burns, depesh-mandalia]
     tracking_problem:
       signals: ["attribution issues", "pixel not firing", "iOS tracking", "conversion tracking broken"]
-      route_to: pixel-specialist
+      route_to: performance-engineer
     analysis_problem:
       signals: ["don't know what's working", "need audit", "can't read the data"]
-      route_to: [performance-analyst, ads-analyst]
+      route_to: [campaign-analyst, pm-creative-performance-analyst]
     budget_problem:
       signals: ["budget allocation", "cashflow for ads", "ROAS targets", "profitability"]
-      route_to: fiscal
+      route_to: campaign-analyst
     execution_problem:
       signals: ["need someone to set up campaigns", "campaign structure", "media buying"]
-      route_to: media-buyer
+      route_to: meta-ads-specialist
 
 quality_review:
   checks:

package/bin/iron-edge.js

@@ -23,7 +23,16 @@ const os = require('os');
 const crypto = require('crypto');
 const { spawnSync } = require('child_process');
 
-const HOME = os.homedir();
+// a versao publicada: unica fonte e o package.json do proprio pacote.
+// sem isso o instalador cai no fallback sem numero e o verify nao sabe dizer a versao.
+let PKG_VERSION = '';
+try { PKG_VERSION = require('../package.json').version || ''; } catch (_) {}
+
+// O install grava o `dest` no manifesto com o HOME resolvido (`fs.realpathSync.native`). Comparar
+// com o HOME cru nao casa quando o perfil esta atras de symlink ou redirecionado — e o `update`
+// ja' documenta esse caso como real. Sem isto, o config do usuario volta a reprovar naquela maquina.
+let HOME = os.homedir();
+try { HOME = fs.realpathSync.native(HOME); } catch (_) {}
 const cmd = process.argv[2];
 const rest = process.argv.slice(3);
 
@@ -36,7 +45,7 @@ if (cmd === 'install') {
   const pkgRoot = path.join(__dirname, '..');
   const args = [path.join(pkgRoot, 'installer', 'install.js'), ...rest];
   if (!rest.includes('--source')) args.push('--source', pkgRoot);
-  const r = spawnSync(process.execPath, args, { stdio: 'inherit' });
+  const r = spawnSync(process.execPath, args, { stdio: 'inherit', env: { ...process.env, IRON_EDGE_VERSION: PKG_VERSION } });
   process.exit(r.status ?? 1);
 
 } else if (cmd === 'update') {
@@ -44,7 +53,7 @@ if (cmd === 'install') {
   const pkgRoot = path.join(__dirname, '..');
   const args = [path.join(pkgRoot, 'installer', 'update.js'), ...rest];
   if (!rest.includes('--source')) args.push('--source', pkgRoot);
-  const r = spawnSync(process.execPath, args, { stdio: 'inherit' });
+  const r = spawnSync(process.execPath, args, { stdio: 'inherit', env: { ...process.env, IRON_EDGE_VERSION: PKG_VERSION } });
   process.exit(r.status ?? 1);
 
 } else if (cmd === 'verify') {
@@ -54,15 +63,58 @@ if (cmd === 'install') {
     console.error('Se o Iron foi instalado por um metodo antigo, reinstale com: iron-edge install');
     process.exit(1);
   }
-  const man = JSON.parse(fs.readFileSync(manPath, 'utf8'));
+  let man;
+  try { man = JSON.parse(fs.readFileSync(manPath, 'utf8')); }
+  catch (e) {
+    // o update ja tratava este caso e o verify nao: gravacao interrompida, antivirus ou disco cheio
+    // deixavam o aluno com um stack trace cru em ingles no lugar de uma instrucao.
+    console.error('verify: o manifesto existe mas nao e JSON valido (' + e.message + ').');
+    console.error('Reinstale com: npx iron-edge install — seus arquivos proprios nao sao tocados.');
+    process.exit(1);
+  }
   const files = man.files || [];
-  let alterados = [], sumidos = [];
+
+  // Quais arquivos sao da PESSOA: lista explicita, declarada em gerados.js.
+  // A versao anterior deste bloco deduzia por regra — "gerado no install e nao declarado como
+  // do pacote" — e a deducao generalizou errado: metadata.json tambem nasce gerado e NUNCA e'
+  // reescrito por ninguem, entao divergencia nele e' corrupcao, nao personalizacao, e passou a
+  // sair aprovada com exit 0. Regra que deduz pertencimento erra no arquivo que ninguem lembrou.
+  //
+  // E se o require falhar (instalacao pela metade, pasta installer/ ausente), a lista fica
+  // VAZIA e nada e' tratado como seu: tudo que divergir cai em "alterados" e reprova. Falha
+  // FECHADO de proposito. A versao anterior falhava aberta — sem a lista, ate o atalho /iron
+  // adulterado virava "seu" e saia com exit 0.
+  let doUsuario = new Set();
+  try {
+    const { arquivosDoUsuario } = require('../installer/gerados');
+    for (const d of arquivosDoUsuario({ IRON_DIR: path.join(HOME, '.iron') })) doUsuario.add(d);
+  } catch (e) { /* lista vazia = ninguem e' "seu" = tudo divergente reprova */ }
+
+  // TRES baldes, e a fronteira e' "ha registro de que isto e seu?", nao "mudou?".
+  //   seus      = seu por natureza (config, integracoes) ou marcado user_modified -> NAO reprova
+  //   alterados = difere do pacote e ninguem registrou que foi voce -> reprova
+  //   ausentes  = sumiu do disco -> reprova
+  //
+  // Arquivo do usuario entra em "seus" SEMPRE, batendo o hash ou nao. Nao se compara hash aqui
+  // de proposito: o `update` regrava o manifesto com o hash do disco, entao qualquer balde que
+  // dependa de divergencia de hash esvazia sozinho na primeira atualizacao. Foi exatamente esse
+  // o defeito que um relatorio de campo pegou nos arquivos do pacote — e que a primeira tentativa
+  // de conserto recriou nos arquivos de config, pelo mesmo caminho.
+  let alterados = [], sumidos = [], seus = [];
   for (const f of files) {
     const dest = f.dest || f.path || f;
     const want = f.sha256 || f.hash;
     if (!dest || !want) continue;
     if (!fs.existsSync(dest)) { sumidos.push(dest); continue; }
-    if (sha256(dest) !== want) alterados.push(dest);
+    // Compara os DOIS lados resolvidos, como o update.js ja faz: o install so' passou a gravar
+    // o dest resolvido a partir de certa versao, entao manifesto antigo tem caminho cru. Assumir
+    // um formato so' faz o config do usuario voltar a reprovar na maquina com perfil redirecionado.
+    let real = dest;
+    try { real = fs.realpathSync.native(dest); } catch (_) {}
+    if (doUsuario.has(dest) || doUsuario.has(real)) { seus.push({ dest, motivo: 'seu: config e integracoes, o update nunca encosta' }); continue; }
+    const igual = sha256(dest) === want;
+    if (f.user_modified) { seus.push({ dest, motivo: igual ? 'voce editou este arquivo do pacote' : 'voce editou de novo depois da ultima atualizacao' }); continue; }
+    if (!igual) alterados.push({ dest });
   }
   console.log(`Iron Edge — verificacao da instalacao`);
   if (man.label) console.log(`  edicao:  ${man.label}`);
@@ -74,10 +126,25 @@ if (cmd === 'install') {
   }
   if (man.installed_at) console.log(`  instalado em: ${man.installed_at}`);
   console.log(`  arquivos no manifesto: ${files.length}`);
-  console.log(`  alterados pelo usuario: ${alterados.length}`);
-  for (const a of alterados) console.log(`    ~ ${a}`);
+  console.log(`  seus, o update nao encosta: ${seus.length}`);
+  for (const x of seus) console.log(`    * ${x.dest}  (${x.motivo})`);
+  // Aqui havia uma instrucao de remedio ("apague o arquivo e rode update"). Ela foi REMOVIDA,
+  // nao reescrita: o balde reune duas classes de arquivo e a frase so' valia para uma. No
+  // config.yaml, apagar destroi o vault_path e o update recria em branco; no shopify.yaml o
+  // arquivo some de vez, porque ele nao esta em arquivosGerados() e o update nao o repoe.
+  // Instrucao errada e' pior que instrucao nenhuma. Como reverter continua dito no proprio
+  // update.js, no bloco `preservar` — aparece na tela quando a pessoa roda o update.
+  console.log(`  alterados sem registro: ${alterados.length}`);
+  for (const a of alterados) console.log(`    ~ ${a.dest}`);
+  if (alterados.length) {
+    console.log(`  Estes diferem do pacote e ninguem registrou que a edicao foi sua. Se foi voce, rode`);
+    console.log(`  "iron-edge update" uma vez: ele passa a reconhecer a edicao e para de acusar.`);
+  }
   console.log(`  ausentes: ${sumidos.length}`);
   for (const s of sumidos) console.log(`    x ${s}`);
+  // "seus" NAO reprova: e' o estado esperado de quem preencheu o config ou personalizou um
+  // agente. Reprovar o caminho que o produto MANDA seguir treina a pessoa a ignorar o verify.
+  // Reprovam so' divergencia sem registro e arquivo sumido.
   process.exit(alterados.length + sumidos.length === 0 ? 0 : 1);
 
 } else {

package/installer/gerados.js

@@ -17,9 +17,36 @@
 'use strict';
 const path = require('path');
 
+// Os arquivos que nascem na instalacao e pertencem a PESSOA: ela preenche, ela edita, e nem
+// o install nem o update reescrevem. Ficam declarados aqui, um por um, e nao deduzidos por
+// regra ("tudo que e gerado e nao e do pacote"), porque a deducao ja errou: metadata.json
+// tambem nasce gerado, NUNCA e' reescrito por ninguem, e por isso qualquer divergencia nele e'
+// corrupcao — nao personalizacao. Lista explicita nao tem como generalizar errado.
+function arquivosDoUsuario({ IRON_DIR }) {
+  return [
+    path.join(IRON_DIR, 'config.yaml'),
+    // Medido no gate de 20/09: sem esta linha, quem LIGA a integracao (a unica razao do arquivo
+    // existir) passa a ter o verify reprovando para sempre, e o `update` que a mensagem receita
+    // nao conserta — o processo sai em "Nada a fazer" antes da fase que regravaria o hash.
+    // Arquivo APAGADO continua caindo em "sumidos": o verify checa existencia ANTES de checar dono.
+    path.join(IRON_DIR, 'integrations', 'shopify.yaml'),
+  ];
+}
+
 function arquivosGerados({ IRON_DIR, CLAUDE_DIR }) {
   const COMMANDS = path.join(CLAUDE_DIR, 'commands');
   return [
+    {
+      // A integracao da Shopify entra aqui, e nao so' no install.js, porque enquanto ela viveu
+      // fora desta lista o `update` nao sabia recria-la: quem apagasse o arquivo ficava com o
+      // `verify` acusando "ausentes: 1" para sempre, sem caminho de volta. Era divida conhecida
+      // desde `c44a965` e virou defeito medido na matriz de estados de 20/09/2026.
+      // `sobrescrever: false` mantem a outra metade da promessa: se o arquivo existe, ninguem encosta.
+      dest: path.join(IRON_DIR, 'integrations', 'shopify.yaml'),
+      oQueE: 'a config da integracao com a Shopify',
+      sobrescrever: false,
+      conteudo: 'enabled: false\nendpoint: ""\napi_key_file: ""\n',
+    },
     {
       dest: path.join(IRON_DIR, 'config.yaml'),
       oQueE: 'a config inicial',
@@ -41,7 +68,16 @@ function arquivosGerados({ IRON_DIR, CLAUDE_DIR }) {
         '#',
         '# Ainda nao tem? Peca ao Iron: "cria meu cofre". Ele monta a estrutura no lugar que',
         '# voce escolher e preenche este campo sozinho. Leva um minuto.',
-        'vault_path: ""               # ex: ~/Documents/Cofre',
+        '#',
+        '# WINDOWS: escreva o caminho com BARRA NORMAL, nunca com barra invertida. O Windows',
+        '# aceita as duas; o YAML, nao. Barra invertida dentro de aspas e escape, entao o \\U de',
+        '# C:\\Users pede um codigo Unicode que nao existe e o arquivo INTEIRO fica invalido —',
+        '# voce perde o owner junto. E nao da erro na tela: o Iron so passa a responder generico',
+        '# e a oferecer criar um cofre que ja existe, com o seu cheio do lado.',
+        '#',
+        '# Exemplos:  mac/linux   ~/Documents/Cofre',
+        '#            windows    C:/Users/<voce>/Documents/Cofre',
+        'vault_path: ""',
         '',
         '# focus: dev                 # prioriza o iron-eng (engenharia de software) no roteamento.',
         '#                            # descomente se o seu uso principal for programar.',
@@ -103,4 +139,4 @@ function arquivosGerados({ IRON_DIR, CLAUDE_DIR }) {
   ];
 }
 
-module.exports = { arquivosGerados };
+module.exports = { arquivosGerados, arquivosDoUsuario };

package/installer/install.js

@@ -31,7 +31,9 @@ const crypto = require('crypto');
 let IRON_VERSION = 'iron-edge-2.x';
 let IRON_VERSION_HUMAN = 'Iron Edge';
 
-function log(msg) { process.stdout.write(msg + '\n'); }
+// Sincrono pelo mesmo motivo do update.js: em Windows, saida em cano + process.exit() perde o
+// que estava na fila, e o log do instalador e' justamente o que o aluno cola quando pede ajuda.
+function log(msg) { try { fs.writeSync(1, msg + '\n'); } catch (_) { process.stdout.write(msg + '\n'); } }
 function abort(msg) {
   process.stderr.write('\n[ABORTADO] ' + msg + '\n');
   process.exit(1);
@@ -50,7 +52,11 @@ try {
   const ed = JSON.parse(fs.readFileSync(path.join(SOURCE, 'edition.json'), 'utf8'));
   if (ed.label) IRON_VERSION_HUMAN = ed.label + ' v' + (ed.version || '');
   if (ed.name) IRON_VERSION = ed.name + '-' + (ed.version || '');
-} catch (_) { /* payload sem edition.json: fica o fallback */ }
+} catch (_) {
+  // payload sem edition.json (o caso do npm): a versao vem do package.json, via bin/iron-edge.js
+  const v = process.env.IRON_EDGE_VERSION || '';
+  if (v) { IRON_VERSION = 'iron-edge-' + v; IRON_VERSION_HUMAN = 'Iron Edge v' + v; }
+}
 
 let HOME = os.homedir();
 try { HOME = fs.realpathSync.native(HOME); } catch (_) {}
@@ -449,6 +455,12 @@ for (const d of [path.join(IRON_DIR, 'integrations'), path.join(IRON_DIR, 'secre
   criarPasta(d, 'as pastas de estado');
 }
 
+// A pasta de segredos nasce fechada. O proprio LEIA-ME dela diz "para as SUAS credenciais", e ate
+// o gate de 20/09 ela nascia 755: em maquina compartilhada (laboratorio, escritorio, familia),
+// qualquer outro usuario local lia o que fosse colocado ali. chmod nao existe em Windows e falha
+// aberto de proposito: sem permissao POSIX, o diretorio ja herda a ACL do perfil do usuario.
+try { fs.chmodSync(path.join(IRON_DIR, 'secrets'), 0o700); } catch (_) {}
+
 // memoria por cargo do squad-engineering: pasta vazia, FORA do manifesto de propósito.
 // O que a maquina aprendeu nao e gerenciado pelo instalador — update de pacote nunca apaga.
 // Cada arquivo <cargo>.md nasce do template na primeira vez que o cargo roda.
@@ -456,6 +468,8 @@ criarPasta(path.join(IRON_DIR, 'memory', 'squad-engineering'), 'a pasta de memor
 
 const shopifyYaml = path.join(IRON_DIR, 'integrations', 'shopify.yaml');
 escrever(shopifyYaml, 'enabled: false\nendpoint: ""\napi_key_file: ""\n', 'a config da integracao');
+// o arquivo que aponta pra chave tambem nao e' de leitura publica
+try { fs.chmodSync(shopifyYaml, 0o600); } catch (_) {}
 
 const installedAt = new Date().toISOString();
 
@@ -539,6 +553,8 @@ log(`Manifesto: ${manifestPath}`);
 log('\n--------------------------------');
 log('  PROXIMO PASSO');
 log('--------------------------------');
+log('0. Use no terminal. Se voce usa VS Code, abra o terminal integrado (Ctrl+crase) e rode: claude');
+log('');
 log('1. Reabra o Claude Code. Agente novo so aparece em sessao nova.');
 log('');
 log('2. Chame o orquestrador. Escreva so isto:');
@@ -549,7 +565,9 @@ log('   So a palavra, sem barra e sem traco. Se preferir a barra, /iron faz o me
 log('   e da pra ja mandar o pedido junto: iron preciso da copy desse anuncio');
 log('');
 log('   Os outros 43 agentes se chamam PEDINDO ("usa o iron-copy").');
-log('   As 14 SKILLS sao de barra: /gate /salvar /brandkit /escada ...');
+// o numero sai do disco: ele ja nasceu errado uma vez (14 quando eram 15) e ninguem viu
+const nSkills = (() => { try { return fs.readdirSync(path.join(SOURCE, 'skills')).filter((d) => !d.startsWith('.')).length; } catch (_) { return null; } })();
+log(`   As ${nSkills || ''} SKILLS sao de barra: /gate /salvar /brandkit /escada ...`.replace('  ', ' '));
 log('');
 log('3. Ligue a memoria. Diga a ele:');
 log('');