Iron Edge — Ecossistema de Agentes para Claude Code

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.

Instalação

npx iron-edge install

Isso instala automaticamente:

• 44 agentes em ~/.claude/agents/
• Skills premium em ~/.claude/skills/
• Base de conhecimento em ~/.iron/
• 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.

Como usar

Existem duas coisas diferentes aqui, e elas se chamam de jeitos diferentes. Confundir as duas é o erro mais comum de quem acabou de instalar.

Skills — essas viram comando de barra. São 14, e o Claude Code as reconhece por /nome:

/gate      → auditoria de qualidade antes de entregar
/salvar    → registra o estado do projeto
/brandkit  → identidade visual
/escada    → qual modelo usar em cada fase

(As outras: anotar, faxina, conectar-mcp, roteiro-video, lp-cinematico, clone-site, clone-inventory, clone-distill, clone-organize, clone-transplant.)

Agentes — esses você chama pedindo. São 44:

"usa o iron-ceo"                    ← comece por aqui, ele direciona
"chama o iron-copy pra essa headline"
"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: 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:

| Squad | Você chama | |---|---| | copy, brand, design, content, growth, paidmedia, commercial, product, research, finance, courses, council, storytelling, animations, cloning, claude | iron-<mesmo nome> (ex.: "usa o iron-copy") | | cybersecurity | iron-cyber | | engineering | iron-eng |

Dentro do squad você vai ver nomes como @copy-orqx e @headline-specialist. Esses são papéis internos, usados pelo orquestrador do squad — não são comandos que você digita.

Agentes disponíveis

A tabela abaixo lista os 23 agentes de linha de frente. A instalação entrega 44: os outros 21 são os 13 conselhos xq-* (squads de referência, ex.: xq-copy, xq-hormozi, xq-clevel) e 8 agentes de apoio (iron-auditor, iron-claude, iron-clone, iron-forge, iron-install, iron-premium, iron-search, lp-cinematico). Para ver a lista completa na sua máquina: ls ~/.claude/agents/.

| Agente | Especialidade | |--------|--------------| | iron-ceo | Orquestrador master — ponto de entrada único | | iron-eng | Engenharia de software: app, sistema, API, banco, automação, bug | | iron-brand | Identidade visual, logo, paleta, brandbook | | iron-copy | Textos, headlines, CTAs, roteiros de vendas | | iron-content | Pautas, legendas, calendário de conteúdo | | iron-design | Peças e layouts para redes sociais | | iron-growth | Funis, estratégias de crescimento | | iron-courses | Estrutura de cursos e comunidades | | iron-commercial | Propostas, ofertas, argumentos de venda | | iron-research | Pesquisa de mercado e concorrência | | iron-storytelling | Narrativa de marca e posicionamento | | iron-paidmedia | Tráfego pago, campanhas, criativos | | iron-product | Estratégia de produto e roadmap | | iron-animations | Animações e motion graphics | | iron-finance | Precificação, métricas, finanças | | iron-council | Decisões estratégicas complexas | | iron-cloning | Clonagem cognitiva de pessoa real — extrai o modo de pensar de alguém a partir do conteúdo público e monta um agente no estilo dela. Exige consentimento e base legal; leia a declaração ética do squad antes | | iron-cyber | Segurança e proteção digital | | iron-community | Criar e crescer comunidades pagas | | iron-spy | Minera anúncios validados no Facebook Ads Library | | iron-video | Cria vídeos MP4 com Remotion | | iron-3d | Sites premium com profundidade 3D | | iron-shopify | Controle total de lojas Shopify |

Skills premium

O método — entra em toda instalação, e é o que faz o resto valer:

| Skill | O que faz | |-------|-----------| | gate | Quality gate de aprovação duplicada: um painel de auditores independentes audita o que você produziu — arte, site, código, pipeline, PDF, vídeo — antes de virar entrega, commit ou publicação. Nada sai sem parecer com zero bloqueador | | salvar | Fecha a sessão registrando o que foi feito e o que mudou de estado | | anotar | Guarda o aprendizado reaproveitável, separado do registro de projeto | | escada | Qual modelo usar em cada fase, para não gastar caro na fase longa | | faxina | O par do salvar: decide o que sai (arquivo efêmero, print acumulado) | | conectar-mcp | Conecta e diagnostica servidores MCP |

Construção e clonagem:

| Skill | O que faz | |-------|-----------| | lp-cinematico | Landing pages cinematográficas (scroll-scrub estilo Apple) | | brandkit | Identidade visual completa, do briefing ao kit de logo e brandbook | | roteiro-video | Roteiros para Reels, TikTok, Shorts e YouTube | | clone-site + 4 clone-* | Mede o DNA visual de uma referência, clona, organiza e transplanta marca |

Documentação

Instalada junto. Depois de npx iron-edge install, os dois arquivos abaixo estão na sua máquina, em ~/.iron/docs/ — abra com o editor que quiser. (Os caminhos são de arquivo local, não links: esta página não tem repositório público para onde apontar.)

| Documento | Para quê | |---|---| | ~/.iron/docs/2026-08-21-como-pedir-software-ao-iron.md | Comece por aqui se for pedir software. Como o iron-eng classifica o tamanho do pedido (ajuste, feature, projeto), o que ele escreve em cada faixa e o que ele nunca faz sem você | | ~/.iron/docs/2026-08-21-skill-gate-fonte-unica.md | De onde vem a régua do gate, e como mantê-la uma só |

Outros comandos

# Conferir a instalação: o que foi instalado, o que você alterou, o que sumiu
npx iron-edge verify

Atualizar é um comando. Remover é operação conduzida.

• Atualizar:

  npx iron-edge@latest update

  Ele lê o manifesto e confere arquivo por arquivo, por hash. Só troca o que estiver byte a byte idêntico ao pacote — ou seja, o que ninguém encostou. Numa instalação típica isso é mais de 2.100 dos 2.126 arquivos.

  O que ele nunca toca: o seu config.yaml, o seu cofre, agentes e skills que você criou, e qualquer arquivo do pacote que você tenha editado — esses ficam marcados no manifesto e continuam preservados nas atualizações seguintes. Ele lista um por um antes de agir. Se quiser ver o plano sem escrever nada: npx iron-edge update --dry-run.

  Se algo falhar no meio, nada fica pela metade: ele escreve tudo ao lado primeiro e só depois coloca no lugar. Falhou antes disso, sua instalação continua exatamente como estava.

  Instalação anterior a 24/08/2026, feita por zip, não tem manifesto — sem ele não dá para separar o que é seu por lista. Nesse caso rode npx iron-edge install e siga o CASO B da mensagem que aparece.

• Remover — nesta ordem, porque a lista do que remover mora dentro da pasta que some:

  1. Primeiro tire uma cópia do manifesto para fora:

     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/, ~/.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.

  Invertendo a ordem você perde a lista: o manifesto está dentro de ~/.iron/, e sem ele não dá para separar o que veio do pacote do que é seu.

  Cada entrada de files traz rel (o caminho dentro do pacote), dest (onde foi parar na sua máquina) e sha256. O que interessa para apagar é o dest.

  Depois de remover os arquivos sobram as pastas vazias das skills — o manifesto registra arquivos, não pastas. Apagar as que ficarem vazias é seguro; foi este procedimento que as esvaziou.

  ⚠️ npx iron-edge verify não lista os arquivos numa instalação intacta: ele só imprime caminho quando algo foi alterado ou sumiu. Para a lista completa, o manifesto é a fonte.

Requisitos

• Node.js 18 ou superior
• Claude Code instalado (claude.ai/code)

Como funciona

O Iron Edge instala uma equipe de agentes especializados diretamente no Claude Code. Cada agente tem:

• Prompt de sistema otimizado para sua especialidade
• Base de conhecimento com frameworks, técnicas e dados atualizados
• Integração com outros agentes — o iron-ceo coordena tudo automaticamente

Seus dados ficam locais em ~/.iron/. Sobre o que sai da sua máquina, com precisão:

• Para o Iron Office (iron-office.vercel.app, servidor deste projeto) vão dados de apenas 2 agentes: iron-auditor e iron-shopify. E só se você criar a chave em ~/.claude/iron-office-api-key. Confira você mesmo: grep -rln "iron-office" ~/.claude/agents/.
• 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.

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.

Suporte

Achou um defeito, ou o pacote não fez o que promete? Rode npx iron-edge verify e guarde a saída — ela diz a versão instalada, o que você alterou e o que está faltando. É o insumo que qualquer diagnóstico vai pedir primeiro.