iron-edge 2.0.1 → 2.1.0

package/README.md

@@ -40,7 +40,7 @@ Existem **duas coisas diferentes** aqui, e elas se chamam de jeitos diferentes.
 (As outras: `anotar`, `faxina`, `conectar-mcp`, `roteiro-video`, `lp-cinematico`, `clone-site`,
 `clone-inventory`, `clone-distill`, `clone-organize`, `clone-transplant`.)
 
-**Agentes — esses NÃO são comando de barra.** São 44, e você os chama **pedindo em português**:
+**Agentes — esses você chama pedindo.** São 44:
 
 ```
 "usa o iron-ceo"                    ← comece por aqui, ele direciona
@@ -48,14 +48,27 @@ Existem **duas coisas diferentes** aqui, e elas se chamam de jeitos diferentes.
 "quero o iron-shopify nessa loja"
 ```
 
+**E tem um atalho, que é como se usa no dia a dia.** A instalação cria o `iron`, e você o chama
+escrevendo só a palavra:
+
+```
+iron                                ← ativa e pergunta o que você precisa
+iron preciso da copy desse anúncio  ← já entra com o pedido
+```
+
+**Sem barra e sem traço.** Se você preferir a barra, `/iron` faz exatamente o mesmo — ela é o
+atalho explícito da interface, não uma exigência. As três formas (`iron`, `/iron`,
+`"usa o iron-ceo"`) chegam no mesmo lugar.
+
+Os outros 43 agentes continuam sendo chamados pedindo. O pacote instala **um** atalho, não 44.
+
 Digitar `/iron-ceo` **não funciona** — barra é para skill, e agente não é skill. Se quiser a
 menção explícita, a forma que resolve é **`@agent-iron-ceo`** (com o prefixo `agent-`; o
 `@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.
 
-> 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`.
+> Se você viu em algum lugar a instrução de digitar `/iron-ceo`, ela está desatualizada: o atalho
+> se chama **`/iron`**. Sua instalação não tem defeito. Para conferir: `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:
@@ -164,7 +177,7 @@ O instalador **nunca sobrescreve** o que já está em `~/.claude/` e em `~/.iron
      cp ~/.iron/install-manifest.json ./iron-manifest.json
      ```
      (Guarda na pasta em que você está. `~/Desktop` nem sempre existe — em servidor e container, não existe.)
-  2. Abra essa cópia e olhe o campo `files` — é a lista exata do que o pacote escreveu em `~/.claude/agents/` e `~/.claude/skills/`.
+  2. Abra essa cópia e olhe o campo `files` — é a lista exata do que o pacote escreveu em `~/.claude/agents/`, `~/.claude/skills/` e `~/.claude/commands/`.
   3. Apague **só** esses arquivos. O que você criou não está na lista e fica.
   4. **Por último**, apague a pasta `~/.iron/` inteira.
 

package/agents/iron-ceo.md

@@ -35,7 +35,15 @@ máquina onde eu guardo seus projetos e o que ficou pendente. Diga
 
 **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:
+**2. Se houver `vault_path` no config**, leia a partir dele.
+
+> ⚠️ **Nome antigo do campo.** Instalações anteriores a 24/08/2026 gravavam esse caminho como
+> **`obsidian_vault_path`**. Se `vault_path` estiver ausente mas `obsidian_vault_path` existir,
+> **use o valor dele** — é o mesmo cofre, com o mesmo conteúdo. Avise o usuário em uma linha e
+> ofereça renomear o campo para `vault_path`. Nunca trate o cofre como inexistente só porque o
+> campo tem o nome antigo: isso faria o Iron oferecer criar um cofre novo a quem já tem um cheio.
+
+Do cofre, leia:
 - `INDICE.md` — o mapa do cofre
 - `00 Sobre mim.md` — quem é o usuário e como ele trabalha
 - `memoria/historico.md` — as últimas sessões e os próximos passos

package/installer/install.js

@@ -58,8 +58,9 @@ const IRON_DIR = path.join(HOME, '.iron');
 const CLAUDE_DIR = path.join(HOME, '.claude');
 const AGENTS_DEST = path.join(CLAUDE_DIR, 'agents');
 const SKILLS_DEST = path.join(CLAUDE_DIR, 'skills');
+const COMMANDS_DEST = path.join(CLAUDE_DIR, 'commands');
 
-const ALLOWED_ROOTS = [IRON_DIR, AGENTS_DEST, SKILLS_DEST];
+const ALLOWED_ROOTS = [IRON_DIR, AGENTS_DEST, SKILLS_DEST, COMMANDS_DEST];
 
 const WIN_RESERVED = new Set([
   'CON','PRN','AUX','NUL',
@@ -289,7 +290,7 @@ Da pra separar o que e seu por lista:
      O que NAO estiver la foi voce que criou.
   3. Guarde o que for seu (agente proprio, skill propria, o que voce editou).
      "npx iron-edge verify" mostra o que voce alterou em relacao ao manifesto.
-  4. Apague em ~/.claude/agents e ~/.claude/skills SO os arquivos que estao na
+  4. Apague em ~/.claude/agents, ~/.claude/skills e ~/.claude/commands SO os que estao na
      lista. Depois, POR ULTIMO, apague a pasta ~/.iron inteira.
   5. Rode a instalacao de novo.
 
@@ -518,7 +519,7 @@ const installManifest = {
   platform: process.platform,
   node: process.version,
   home: HOME,
-  scopes: { iron_root: IRON_DIR, claude_agents: AGENTS_DEST, claude_skills: SKILLS_DEST },
+  scopes: { iron_root: IRON_DIR, claude_agents: AGENTS_DEST, claude_skills: SKILLS_DEST, claude_commands: COMMANDS_DEST },
   files: manifest // sera reescrito abaixo ja com os gerados
 };
 
@@ -526,6 +527,35 @@ const installManifest = {
 addGenerated(shopifyYaml);
 addGenerated(configYaml);
 
+// O ATALHO /iron — o pedido mais repetido de quem usa o Iron todo dia.
+//
+// Ele NAO e' copia do agente. A maquina de quem desenvolve tinha um commands/iron.md com o
+// texto INTEIRO do iron-ceo dentro: 158 linhas duplicadas, que hoje batem por sorte e amanha
+// divergem em silencio. Copia e' o defeito de propagacao que este pacote passou um ciclo
+// inteiro caçando. Aqui o comando so' APONTA pro agente — uma fonte de verdade, e o /iron
+// acompanha qualquer mudanca no iron-ceo.md sem ninguem lembrar de sincronizar.
+const ironCmd = path.join(COMMANDS_DEST, 'iron.md');
+escrever(ironCmd, [
+  '---',
+  'description: Iron Edge - chama o orquestrador master. Ele entende o pedido, decide qual equipe resolve e aciona os especialistas certos.',
+  '---',
+  '',
+  'Leia o arquivo `~/.claude/agents/iron-ceo.md` por inteiro e assuma aquele papel agora,',
+  'seguindo a sequencia de ativacao descrita la (ler o config, ler o cofre se houver, ler o',
+  'mapa de roteamento, e so entao saudar).',
+  '',
+  'Nao resuma o arquivo nem trabalhe de memoria: leia o conteudo real, porque ele muda quando',
+  'o pacote e atualizado.',
+  '',
+  'Pedido do usuario: $ARGUMENTS',
+  '',
+  '(Sem pedido depois do comando, apenas ative e pergunte qual e a missao.)',
+  '',
+  'Este atalho atende tanto por `/iron` quanto pela palavra `iron` sozinha.',
+  ''
+].join('\n'), 'o atalho /iron');
+addGenerated(ironCmd);
+
 const metadataPath = path.join(IRON_DIR, 'metadata.json');
 escrever(metadataPath,
   JSON.stringify({ version: IRON_VERSION, label: IRON_VERSION_HUMAN, installed_at: installedAt, platform: process.platform }, null, 2),
@@ -579,11 +609,15 @@ log('  PROXIMO PASSO');
 log('--------------------------------');
 log('1. Reabra o Claude Code. Agente novo so aparece em sessao nova.');
 log('');
-log('2. Chame o orquestrador PEDINDO, em portugues:');
+log('2. Chame o orquestrador. Escreva so isto:');
+log('');
+log('       iron');
 log('');
-log('       usa o iron-ceo');
+log('   So a palavra, sem barra e sem traco. Se preferir a barra, /iron faz o mesmo,');
+log('   e da pra ja mandar o pedido junto: iron preciso da copy desse anuncio');
 log('');
-log('   (Agente nao e comando de barra. As 14 SKILLS sim: /gate /salvar /brandkit ...)');
+log('   Os outros 43 agentes se chamam PEDINDO ("usa o iron-copy").');
+log('   As 14 SKILLS sao de barra: /gate /salvar /brandkit /escada ...');
 log('');
 log('3. Ligue a memoria. Diga a ele:');
 log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iron-edge",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "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

@@ -16,6 +16,11 @@ O trabalho que não foi registrado não aconteceu: a próxima sessão nasce sem
 
 ## 0. Onde fica o cofre
 
+> ⚠️ **Antes de concluir que não há cofre:** instalações anteriores a 24/08/2026 gravavam o
+> caminho no campo **`obsidian_vault_path`**, não em `vault_path`. Se o segundo estiver vazio,
+> procure o primeiro antes de oferecer criar um cofre novo — a pessoa pode já ter um, cheio.
+
+
 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`.
 
 **Se o campo estiver vazio ou a pasta não existir**, ofereça criar agora, em um lugar que o usuário escolher (sugira `~/Documents/Cofre <Nome>/`). A estrutura mínima: