iron-edge 2.0.0 → 2.0.1

package/README.md

@@ -1,6 +1,6 @@
 # Iron Edge — Ecossistema de Agentes para Claude Code
 
-**44 agentes de topo, 18 squads, 14 skills e sistema de memória integrado.**
+**44 agentes de topo, 18 squads, 14 skills e memória entre sessões.**
 
 Uma equipe completa de IA para marketing, vendas, conteúdo, Shopify, vídeo e crescimento — tudo dentro do Claude Code.
 
@@ -16,7 +16,11 @@ Isso instala automaticamente:
 - 44 agentes em `~/.claude/agents/`
 - Skills premium em `~/.claude/skills/`
 - Base de conhecimento em `~/.iron/`
-- Sistema de configuração e memória
+- A configuração em `~/.iron/config.yaml`
+
+**Sobre a memória, sem enrolação:** o Iron guarda o que importa entre uma conversa e outra — quem você é, seus projetos, o que ficou pendente. Mas ela **não vem pronta**: é uma pasta sua, no seu disco, que ele monta quando você pedir. Depois de instalar, diga **"cria meu cofre"** e ele faz em um minuto, no lugar que você escolher. Enquanto você não fizer isso, cada conversa começa do zero.
+
+São arquivos `.md` comuns — abrem no Obsidian, no VS Code ou em qualquer editor. Nada é enviado para lugar nenhum.
 
 ---
 
@@ -49,9 +53,9 @@ menção explícita, a forma que resolve é **`@agent-iron-ceo`** (com o prefixo
 `@iron-ceo` sozinho não é documentado). O Claude Code também escolhe o agente sozinho quando o
 pedido é claro; nomear é só para ter certeza de qual.
 
-> Isto foi corrigido em 24/08/2026. Até essa data o README mandava digitar `/iron-ceo`, o que
-> nunca funcionou: o pacote não cria `~/.claude/commands/`. Se você seguiu a versão antiga e achou
-> que a instalação tinha falhado, ela não tinha.
+> Se você viu em algum lugar a instrução de digitar `/iron-ceo`, ela está desatualizada — isso
+> nunca funcionou, porque o pacote não cria `~/.claude/commands/`. Sua instalação não tem defeito.
+> Para conferir que está tudo no lugar: `npx iron-edge verify`.
 
 **Squads — o terceiro nível, e você não chama direto.** São 18 equipes que vivem em `~/.iron/`.
 Cada uma tem um agente de topo, e é por ele que se entra:
@@ -195,7 +199,6 @@ Seus dados ficam locais em `~/.iron/`. Sobre o que sai da sua máquina, com prec
 - **Para a internet aberta**, através das ferramentas do próprio Claude Code (`WebSearch` / `WebFetch`), vão as buscas de **41 dos 44 agentes** — é como o `iron-research` pesquisa mercado e o `iron-spy` lê a biblioteca de anúncios. Isso passa pelo Claude Code, com a visibilidade e a aprovação que ele te dá; não é canal deste pacote. Confira: `grep -rln "WebSearch\|WebFetch" ~/.claude/agents/`.
 - **A skill `clone-site`** baixa a URL que você mandar clonar. É o trabalho dela.
 
-*(Até 24/08/2026 este parágrafo dizia "nenhum outro agente do pacote fala com a rede". Era falso — 41 deles pesquisam na web — e a frase foi escrita, ironicamente, numa correção de exagero. Os números acima são medidos, e a regra R19 do lint confere os do README contra o disco.)*
 
 Sendo exato sobre a força dessa garantia, porque ela não é um sandbox: cada bloco que chama o Iron Office começa com uma guarda (`[ -z "$IRON_KEY" ] && exit 0`) e a regra R20 do lint impede que qualquer bloco novo entre sem ela. Mas esses arquivos são **instruções lidas por um modelo**, não um binário fechado: um agente que execute só a linha do `curl`, isolada da guarda, não é barrado por nada aqui. Se o que você quer é garantia dura, a que existe é não criar o arquivo de chave — sem ele, não há para onde enviar, e todo bloco para na guarda.
 

package/agents/iron-ceo.md

@@ -26,8 +26,15 @@ Enquanto ele estiver assim, tudo que eu responder vai sair genérico.
 
 Quer preencher agora? Leva 2 minutos: seu nome, o que você faz,
 e os negócios ou projetos em que o Iron vai trabalhar com você.
+
+E tem uma segunda coisa, que vale mais: sem um COFRE, eu esqueço tudo
+quando esta conversa fechar. O cofre é uma pasta de arquivos .md na sua
+máquina onde eu guardo seus projetos e o que ficou pendente. Diga
+"cria meu cofre" e eu monto no lugar que você escolher.
 ```
 
+**Se `vault_path` estiver vazio ou ausente**, ofereça o cofre uma vez, do jeito acima, e siga trabalhando se ele recusar. Não insista a cada mensagem: uma oferta por sessão. Quando ele aceitar, use a skill `salvar` (seção 0) para montar.
+
 **2. Se houver `vault_path` no config**, leia a partir dele:
 - `INDICE.md` — o mapa do cofre
 - `00 Sobre mim.md` — quem é o usuário e como ele trabalha

package/installer/install.js

@@ -276,6 +276,12 @@ Se esta maquina JA TEM uma instalacao do Iron Edge, isso e esperado: esta versao
 nao instala por cima, para nada seu ser perdido.
 
 Como resolver sozinho, sem depender de ninguem:
+Primeiro descubra qual dos dois casos e o seu:
+
+    ls ~/.iron/install-manifest.json
+
+CASO A - o arquivo EXISTE (instalacao feita por este instalador).
+Da pra separar o que e seu por lista:
   1. COPIE o manifesto para fora ANTES de apagar qualquer coisa (a lista do que
      remover mora dentro da pasta que vai sumir):
          cp ~/.iron/install-manifest.json ./iron-manifest.json
@@ -287,6 +293,29 @@ Como resolver sozinho, sem depender de ninguem:
      lista. Depois, POR ULTIMO, apague a pasta ~/.iron inteira.
   5. Rode a instalacao de novo.
 
+CASO B - o arquivo NAO EXISTE (instalacao anterior ao manifesto, veio de zip).
+Sem a lista nao da pra separar por nome — entao NAO SEPARE: mova tudo pro lado.
+Nada e apagado, e da pra voltar atras a qualquer momento.
+  1. Mova as pastas antigas, com data no nome:
+         mv ~/.claude/agents  ~/.claude/agents-antes-2.0
+         mv ~/.claude/skills  ~/.claude/skills-antes-2.0
+         mv ~/.iron           ~/.iron-antes-2.0
+  2. Rode a instalacao de novo. Agora ela nao vai achar conflito.
+  3. Depois de instalar, traga de volta SO o que era seu, olhando as pastas
+     "-antes-2.0": agente que voce escreveu, skill sua, e o conteudo do seu
+     cofre. O que veio do pacote antigo NAO precisa voltar: a versao nova
+     ja traz tudo, mais novo.
+  4. Quando tiver certeza de que nao falta nada, apague as pastas "-antes-2.0".
+     Enquanto elas existirem, sua instalacao antiga esta inteira e intacta.
+
+  Windows: no Claude Code, o prefixo "!" cai no Git Bash, entao os comandos
+  acima funcionam como estao. Fora dele, no PowerShell, troque "mv" por "move".
+
+  ATENCAO: seu COFRE (a pasta de memoria com seus projetos) normalmente NAO fica
+  em nenhuma dessas pastas — ele fica onde voce escolheu, e o caminho esta no
+  campo vault_path do ~/.iron/config.yaml. Anote esse caminho antes de mover
+  qualquer coisa, e confira depois que ele continua la.
+
 Se os conflitos acima NAO batem com uma instalacao que voce reconhece, pode ser
 sobra de uma instalacao que falhou no meio. Nesse caso os arquivos listados sao
 lixo e podem ser removidos.`);
@@ -417,6 +446,28 @@ log(`  ${manifest.length} arquivos copiados.`);
 
 for (const d of [path.join(IRON_DIR, 'integrations'), path.join(IRON_DIR, 'secrets')]) {
   criarPasta(d, 'as pastas de estado');
+
+// As duas pastas nascem vazias e com nome que gera duvida ("secrets" assusta quem vai por
+// dado de negocio). Um LEIAME em cada uma explica pra que servem — pasta vazia sem
+// explicacao foi achado de um leitor sem contexto nenhum.
+escrever(path.join(IRON_DIR, 'secrets', 'LEIA-ME.md'), [
+  '# secrets/',
+  '',
+  'Pasta para as SUAS credenciais, se um dia voce conectar alguma integracao.',
+  '**Ela nasce vazia e o Iron nao escreve nada aqui sozinho.**',
+  '',
+  'Nada nesta pasta e enviado para lugar nenhum: e arquivo no seu disco, como',
+  'qualquer outro. Se voce nunca conectar integracao, ela fica vazia para sempre —',
+  'e pode apagar sem quebrar nada.',
+  ''
+].join('\n'), 'o LEIA-ME de secrets');
+escrever(path.join(IRON_DIR, 'integrations', 'LEIA-ME.md'), [
+  '# integrations/',
+  '',
+  'Configuracao das integracoes opcionais (por enquanto, so o Shopify via Iron Office).',
+  'O `shopify.yaml` nasce com `enabled: false`: nada e ligado sem voce ligar.',
+  ''
+].join('\n'), 'o LEIA-ME de integrations');
 }
 
 // memoria por cargo do squad-engineering: pasta vazia, FORA do manifesto de propósito.
@@ -429,11 +480,26 @@ escrever(shopifyYaml, 'enabled: false\nendpoint: ""\napi_key_file: ""\n', 'a con
 
 const configYaml = path.join(IRON_DIR, 'config.yaml');
 escrever(configYaml, [
-  '# Iron Edge config (gerado na instalacao, em branco)',
-  'owner: ""',
-  'businesses: []',
-  '# focus: dev        # prioriza o iron-eng (engenharia de software) no roteamento.',
-  '#                   # a skill recorte preenche este campo; deixe comentado ate escolher.',
+  '# Iron Edge - configuracao. Tudo aqui e opcional, mas os dois primeiros blocos mudam',
+  '# muito a qualidade da resposta. Edite a mao, ou peca ao Iron: "configura o Iron pra mim".',
+  '',
+  '# QUEM E VOCE. Sem isto, tudo que o Iron responder sai generico.',
+  'owner: ""                    # seu nome',
+  'businesses: []               # ex: ["loja de roupa", "consultoria de trafego"]',
+  '',
+  '# O COFRE - a memoria do Iron entre uma conversa e outra.',
+  '#',
+  '# SEM cofre, cada conversa comeca do zero: o Iron nao lembra dos seus projetos, do que',
+  '# ficou pendente, nem do que voce decidiu ontem. COM cofre, ele le tudo isso antes de',
+  '# trabalhar. E uma pasta de arquivos .md comuns, na SUA maquina - abre no Obsidian, no',
+  '# VS Code ou em qualquer editor. Nada e enviado pra lugar nenhum.',
+  '#',
+  '# 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',
+  '',
+  '# focus: dev                 # prioriza o iron-eng (engenharia de software) no roteamento.',
+  '#                            # descomente se o seu uso principal for programar.',
   ''
 ].join('\n'), 'a config inicial');
 
@@ -511,8 +577,21 @@ log(`Manifesto: ${manifestPath}`);
 log('\n--------------------------------');
 log('  PROXIMO PASSO');
 log('--------------------------------');
-log('1. Reabra o Claude Code (pra ele carregar os novos agentes).');
-log('2. Comece pelo iron-ceo: peca algo como');
-log('     "ative o iron-ceo" ou "chame o iron-ceo".');
-log('3. Se o iron-ceo responder com a saudacao, esta funcionando.');
+log('1. Reabra o Claude Code. Agente novo so aparece em sessao nova.');
+log('');
+log('2. Chame o orquestrador PEDINDO, em portugues:');
+log('');
+log('       usa o iron-ceo');
+log('');
+log('   (Agente nao e comando de barra. As 14 SKILLS sim: /gate /salvar /brandkit ...)');
+log('');
+log('3. Ligue a memoria. Diga a ele:');
+log('');
+log('       cria meu cofre');
+log('');
+log('   O cofre e uma pasta de arquivos .md na SUA maquina, onde o Iron guarda quem');
+log('   voce e, seus projetos e o que ficou pendente. SEM ele, cada conversa comeca');
+log('   do zero. Com ele, o Iron abre a sessao ja sabendo em que pe as coisas estao.');
+log('   Nada e enviado pra lugar nenhum: e arquivo seu, no seu disco.');
+log('   Se preferir fazer depois, e so pedir a qualquer momento.');
 log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iron-edge",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 14 skills, com quality gate, memoria e instalador que nunca sobrescreve.",
   "keywords": [
     "claude",

package/skills/salvar/SKILL.md

@@ -1,12 +1,19 @@
 ---
 name: salvar
-description: Rotina de encerramento de sessão do Iron Edge. Quando o usuário escrever "salvar" ou "encerrar" (sozinho, como mensagem), executar imediatamente sem perguntar nada — registrar no diário do cofre o que foi feito, atualizar a folha do projeto se o estado mudou, atualizar a memória persistente e confirmar em uma linha. Também dispara em variações claras como "salva a sessão", "registra e encerra", "fecha por hoje".
+description: Memoria do Iron Edge, com DOIS gatilhos. (1) CRIAR O COFRE: em "cria meu cofre", "criar cofre", "configura minha memoria", "quero memoria entre sessoes" ou equivalente, execute SO a secao 0 (monta a estrutura no lugar que o usuario escolher, grava vault_path em ~/.iron/config.yaml) e pare ali. (2) ENCERRAR: em "salvar", "encerrar", "salva a sessao", "registra e encerra", "fecha por hoje", execute a rotina completa sem perguntar nada — diario do cofre, folha do projeto se o estado mudou, memoria persistente, e confirma em uma linha.
 ---
 
 # salvar — registro de sessão
 
 O trabalho que não foi registrado não aconteceu: a próxima sessão nasce sem memória do que esta fez. Esta rotina é o que transforma sessões soltas num sistema.
 
+## Dois jeitos de entrar aqui
+
+- **"cria meu cofre"** (ou "configura minha memoria") → faca **so a secao 0** abaixo: monte a
+  estrutura no lugar que o usuario escolher, grave o `vault_path` no `~/.iron/config.yaml`,
+  confirme em uma linha e **pare**. Nao registre sessao nenhuma: nao ha o que registrar ainda.
+- **"salvar"** ou **"encerrar"** → a rotina completa, da secao 0 em diante.
+
 ## 0. Onde fica o cofre
 
 O cofre é a pasta de memória do usuário — arquivos Markdown simples, que ele pode abrir no Obsidian ou em qualquer editor. O caminho está em `~/.iron/config.yaml`, campo `vault_path`.