iron-edge 1.2.0 → 2.0.1

package/iron-routing-map.md

@@ -0,0 +1,276 @@
+---
+title: Iron Routing Map
+purpose: Mapa de roteamento consultado pelo iron-ceo
+version: 1.0
+path: ~/.iron/iron-routing-map.md
+---
+
+# Iron Routing Map
+
+> Arquivo de referencia. O iron-ceo consulta este mapa para decidir
+> qual agente aciona. Este arquivo NAO e um agente — e dado consultavel.
+> O iron-ceo e o leitor; nunca um destino de roteamento.
+
+## 1. Como usar este mapa
+
+Quando voce faz um pedido, o iron-ceo:
+1. Identifica o dominio do pedido
+2. Consulta a Routing Table (secao 2) para achar o agente operacional
+3. Em caso de termo ambiguo, consulta a Ambiguity Matrix (secao 4)
+4. Se o pedido for grande/multi-etapa, consulta os Playbooks (secao 5)
+5. Se houver conflito entre agentes, aplica o Escalation Protocol (secao 6)
+6. Nunca roteia para os Agentes Pessoais (secao 7) num fluxo de trabalho
+
+Profundidade: pedido padrao usa agente iron-*. Pedido que exige
+profundidade de mestres ou decisao de alto risco usa xq-*. Na duvida,
+o iron-ceo oferece: iron-X (rapido) ou xq-X (profundo)? [r/p]
+
+## 2. Routing Table — Agentes Operacionais (30)
+
+### Bloco A — Squads classicos (17)
+
+| Agente | Dominio | Palavras-chave |
+|---|---|---|
+| iron-brand | Identidade de marca | marca, identidade visual, logo, brandbook, posicionamento, naming |
+| iron-copy | Texto de venda | copy, headline, CTA, carta de vendas, e-mail, roteiro de venda |
+| iron-design | Design visual | design, UI, layout, peca grafica, banner, mockup |
+| iron-content | Conteudo de redes | Instagram, YouTube, post, carrossel, legenda, calendario editorial |
+| iron-paidmedia | Trafego pago | anuncio, campanha, Meta Ads, Google Ads, trafego, ROAS |
+| iron-growth | Crescimento e funil | funil, aquisicao, conversao, growth, retencao |
+| iron-commercial | Vendas e ofertas | proposta, oferta, precificacao de venda, negociacao, pipeline |
+| iron-storytelling | Narrativa | storytelling, historia de marca, narrativa, arco, jornada do heroi |
+| iron-research | Pesquisa de mercado | pesquisa, concorrencia, analise de mercado, benchmark, persona |
+| iron-product | Estrategia de produto | roadmap, feature, produto, MVP, priorizacao |
+| iron-finance | Financas | precificacao, metrica financeira, custo, margem, projecao, valuation |
+| iron-council | Decisao estrategica | decisao estrategica, conselho, dilema, escolha de vida/empresa |
+| iron-cyber | Seguranca | seguranca, ciberseguranca, auditoria de seguranca, vulnerabilidade |
+| iron-animations | Motion graphics | animacao, motion, video animado, transicao |
+| iron-premium | Posicionamento premium | premium, cobrar mais, autoridade, alto valor |
+| iron-community | Comunidades | comunidade, grupo pago, membership, engajamento |
+| iron-courses | Estrutura de cursos | curso, aula, modulo, ebook, mentoria estruturada, syllabus, ementa |
+
+### Bloco B — Especialistas Iron (13)
+
+| Agente | Dominio | Palavras-chave |
+|---|---|---|
+| iron-spy | Espionagem de anuncios | espiar anuncio, Meta Ads Library, anuncio de concorrente, criativo vencedor |
+| iron-shopify | Gestao Shopify | Shopify, loja, produto da loja, e-commerce, dropshipping |
+| iron-3d | Sites 3D | site 3D, site premium, landing imersiva, video AI |
+| iron-video | Video programatico | video programatico, Remotion, video automatizado |
+| iron-auditor | Auditoria visual | auditar site, revisao visual, qualidade de pagina |
+| iron-cloning | Clonagem COGNITIVA de PESSOA REAL — exige consentimento e base legal | clonar mente, clonar pessoa, agente que pensa como fulano, replicar o raciocinio de alguem |
+| iron-search | Pesquisa web | buscar na web, pesquisar online, encontrar informacao |
+| iron-forge | Construtor de agentes | criar agente, criar skill, novo agente, construir ferramenta |
+| iron-install | Instalacao | instalar, setup do ecossistema, configurar ambiente |
+| iron-claude | Claude Code em si | hook, MCP, skill, subagente, settings.json, contexto, memoria, "o Claude esta estranho", auditoria da instalacao |
+| iron-clone | Clonar SITE + design system | clonar site, copiar pagina, espelhar site, "aquele site com a minha marca", DNA visual de referencia, extrair paleta/tipografia, transplante de marca, organizar HTML monolitico (NAO confundir com iron-cloning, que clona o MODO DE PENSAR de uma pessoa real). ATENCAO: a skill clone-site nao roda nativamente em Windows — avisar antes |
+| iron-eng | Engenharia de software | app, plataforma, sistema, API, backend, banco, login, painel, dashboard, CRM, integracao, automacao de negocio, script, job, bug, erro, quebrou, deploy, migration |
+| lp-cinematico | Landing pages scroll | landing page, LP cinematografica, scroll-scrub, pagina de captura |
+
+## 3. Routing Table — Camada de Aprofundamento (XQ — 13)
+
+| Agente | Sobe da camada | Quando usar |
+|---|---|---|
+| xq-advisory | iron-council | conselho consultivo de profundidade |
+| xq-brand | iron-brand | branding com mestres (Al Ries, Aaker, Neumeier) |
+| xq-clevel | iron-council | personas C-level (CEO, CMO, CTO) |
+| xq-codecore | squad-claude | maestria em Claude Code |
+| xq-copy | iron-copy | copy com mestres (Halbert, Schwartz, Ogilvy) |
+| xq-copymaster | iron-copy | copy expandida — 33 copywriters |
+| xq-cyber | iron-cyber | seguranca com 15 especialistas |
+| xq-data | iron-growth | analytics e metricas em profundidade |
+| xq-design | iron-design | UX/UI com experts |
+| xq-hormozi | iron-commercial | ofertas estilo Grand Slam Offers |
+| xq-movement | iron-community | movimentos de marca |
+| xq-storytelling | iron-storytelling | narrativa com mestres (Campbell, Harmon) |
+| xq-traffic | iron-paidmedia | trafego com mestres (Kasim, Sobral) |
+
+Ativadores explicitos por camada:
+
+- "vai fundo" / "profundidade total" -> sobe para o xq-* equivalente
+  (camada de Aprofundamento)
+- "chama o board estrategico" -> aciona a camada XQ Strategy:
+  xq-advisory + xq-clevel + xq-hormozi + xq-movement
+- "convoca o council" -> aciona iron-council, a camada de Conselho
+  Profundo. Atencao: o council NAO e camada XQ — e a terceira camada,
+  separada, para decisoes de vida/empresa.
+
+## 4. Ambiguity Matrix
+
+Grupo 1 — Anuncio / trafego
+- "anuncio": criar campanha -> iron-paidmedia | espiar concorrente -> iron-spy
+- "criativo": produzir -> iron-design (estatico) ou iron-video (video) | analisar de concorrente -> iron-spy
+- "campanha": midia paga -> iron-paidmedia | conteudo organico -> iron-content
+
+Grupo 2 — Site / pagina
+- "site": SEM login e SEM dado gravado — 3D imersivo -> iron-3d | scroll-scrub -> lp-cinematico |
+  UI/layout -> iron-design | clonar/copiar/espelhar um site existente -> iron-clone.
+  COM login, formulario que grava, painel ou pagamento -> iron-eng (Grupo 12)
+- "clonar": SITE/pagina web (copiar, espelhar, "com a minha marca", DNA visual) -> iron-clone | MODO DE PENSAR de uma PESSOA REAL (exige consentimento) -> iron-cloning
+- "pagina linda de referencia / quero no nivel daquele site" -> iron-clone (destila o DNA visual) -> lp-cinematico (gera a nova)
+- "landing page": cinematografica -> lp-cinematico | simples de captura -> iron-design
+- "auditar site": qualidade visual -> iron-auditor | site de concorrente -> iron-research
+
+Grupo 3 — Video
+- "video": programatico/Remotion -> iron-video | motion/animacao em peca -> iron-animations
+
+Grupo 4 — Copy / texto
+- "copy": padrao -> iron-copy | profundidade de mestres -> xq-copy ou xq-copymaster
+- "copy pra anuncio": o texto -> iron-copy | a estrategia de midia -> iron-paidmedia
+- "roteiro": video de venda -> iron-copy | narrativo -> iron-storytelling
+
+Grupo 5 — Marca / estrategia
+- "posicionamento": de marca -> iron-brand | premium/cobrar mais -> iron-premium
+- "estrategia": marca -> iron-brand | crescimento -> iron-growth | produto -> iron-product | vida/empresa -> iron-council | conteudo -> iron-content
+- "naming": -> iron-brand
+
+Grupo 6 — Pesquisa
+- "pesquisa": mercado/concorrencia -> iron-research | busca pontual na web -> iron-search
+- "pesquisar concorrente": analise estrategica -> iron-research | espiar anuncios -> iron-spy
+
+Grupo 7 — Conteudo
+- "conteudo": redes sociais -> iron-content | curso/aula -> iron-courses | narrativa de marca -> iron-storytelling
+
+Grupo 8 — Financeiro / comercial
+- "preco/precificacao": oferta de venda -> iron-commercial | analise de margem/custo -> iron-finance
+- "oferta": montar oferta comercial -> iron-commercial | oferta irresistivel (Hormozi) -> xq-hormozi
+
+Grupo 9 — Loja / e-commerce
+- "loja/produto": gestao Shopify -> iron-shopify | estrategia de produto -> iron-product
+- "dropshipping": operacao da loja -> iron-shopify | pesquisa de produto vencedor -> iron-research ou iron-spy
+
+Grupo 10 — Sistema / meta
+- "criar agente/skill": -> iron-forge
+- "clonar": o modo de pensar de uma PESSOA REAL (exige consentimento) -> iron-cloning | campanha vencedora -> iron-paidmedia
+- "comunidade": gerir comunidade -> iron-community | movimento de marca -> xq-movement
+
+Grupo 12 — Software x design x Claude
+- "site": vitrine/LP/estatico, sem login e sem dado gravado -> lp-cinematico ou iron-design |
+  com login, formulario que grava, painel ou pagamento -> iron-eng (que chama o squad-design pra UI)
+- "automacao": hook, skill, MCP, settings do Claude Code -> iron-claude |
+  automacao de negocio (script, job, planilha para banco, webhook) -> iron-eng
+- "app/plataforma/sistema/CRM/dashboard/API": sempre iron-eng (o doc-first decide a faixa)
+- "bug/erro/quebrou": iron-eng, faixa AJUSTE por padrao
+- "Shopify": iron-shopify | app custom ou integracao fora do admin -> iron-eng
+- "seguranca": iron-cyber audita | iron-eng corrige o que a auditoria apontou
+- "banco/schema/migration": iron-eng (cargo eng-data) | db-sage (xq) so quando o dono pedir profundidade
+
+Anti-padrao, nos dois sentidos: "criar uma plataforma" NUNCA vai direto pro iron-design,
+e LP estatica sem dado NUNCA vai pro iron-eng. Criterio: tem dado, estado, auth ou
+integracao? E software. Nao tem? E peca visual.
+
+Grupo 11 — Profundidade (camada XQ)
+- Pedido operacional padrao -> agente iron-*. Pedido que exige profundidade
+  de mestres, analise densa ou alto risco -> agente xq-* equivalente.
+  Na duvida, o iron-ceo oferece: iron-X (rapido) ou xq-X (profundo)? [r/p]
+
+## 5. Cross-Squad Playbooks
+
+> Playbooks sao sugestoes de fluxo, nao trilhos rigidos. O iron-ceo
+> adapta o playbook ao caso real.
+
+Playbook 1 — Lancamento de Marca
+Gatilho: "criar marca nova", "lancar marca do zero"
+1. iron-brand -> identidade, posicionamento, naming
+2. iron-storytelling -> narrativa da marca
+3. iron-design -> identidade visual aplicada
+4. iron-content + iron-animations -> pecas de lancamento
+5. iron-growth + iron-paidmedia -> colocar no ar e divulgar
+
+Playbook 2 — Go-to-Market
+Gatilho: "lancar produto", "colocar oferta no mercado"
+- Opcional inicial: iron-research -> quando produto/mercado ainda nao validados
+1. iron-product -> definir produto/oferta
+2. iron-commercial -> estruturar oferta e preco
+3. iron-copy + iron-storytelling -> mensagem de venda
+4. iron-paidmedia + iron-content -> distribuicao
+
+Playbook 3 — Pivo Estrategico
+Gatilho: "mudar de direcao", "repensar o negocio"
+1. iron-council -> analise da decisao
+2. iron-research -> validar com dados de mercado
+3. iron-finance -> viabilidade financeira
+4. iron-product -> novo rumo de produto
+
+Playbook 4 — Maquina de Conteudo
+Gatilho: "estruturar conteudo recorrente", "maquina de posts"
+1. iron-brand -> pilares e tom
+2. iron-content -> calendario e formatos
+3. iron-copy -> roteiros e legendas
+4. iron-growth -> distribuicao e medicao
+
+Playbook 5 — Preparacao de Pitch / Investidor
+Gatilho: "preparar pitch", "apresentacao pra investidor"
+1. iron-storytelling -> narrativa do pitch
+2. iron-finance -> numeros e projecoes
+3. iron-commercial -> a oferta/ask
+4. iron-brand -> identidade da apresentacao
+
+Playbook 6 — Auditoria de Seguranca
+Gatilho: "auditoria de seguranca", "checar vulnerabilidades"
+1. iron-cyber -> analise de seguranca
+2. iron-research -> contexto de ameacas e compliance
+
+Playbook 7 — Presenca Digital Completa
+Gatilho: "montar presenca digital do zero"
+1. iron-brand + iron-design -> identidade
+2. iron-3d ou lp-cinematico -> site
+3. iron-content + iron-animations -> conteudo
+4. iron-growth + iron-paidmedia -> aquisicao
+
+Playbook 8 — E-commerce / Dropshipping
+Gatilho: "validar produto de dropshipping", "subir loja", "operacao de e-commerce"
+- Entrada A (produto novo): iron-spy -> iron-research -> iron-commercial -> iron-copy -> iron-shopify -> iron-auditor -> iron-paidmedia
+- Entrada B (loja/produto existente): iron-shopify (le estado real da loja) -> iron-spy + iron-research -> segue igual a Entrada A
+- Opcional: lp-cinematico entra so em produto premium/flagship/alto ticket
+
+Playbook 9 — Lancamento de Curso
+Gatilho: "lancar curso", "criar e vender curso/mentoria"
+1. iron-research -> validar dor, promessa e publico
+2. iron-courses -> estrutura do curso, modulos, syllabus
+3. iron-commercial -> oferta e precificacao
+4. iron-storytelling -> narrativa de venda
+5. iron-copy -> pagina de vendas e e-mails
+6. iron-content -> divulgacao organica
+7. iron-paidmedia -> divulgacao paga
+- Opcional: iron-community entra quando ha grupo, mentoria, cohort, membership ou retencao recorrente
+
+Playbook 10 — Software
+Gatilho: "criar app/plataforma/sistema", "site com login", "automatizar processo
+com codigo", "corrigir bug"
+1. iron-eng -> estado inicial da pasta + faixa declarada (ajuste, feature, projeto)
+2. PROJETO: eng-product (brief, PRD) -> eng-architect (arquitetura, ADRs) -> eng-sprint (stories)
+3. Por story: eng-dev implementa -> eng-qa opera o gate -> eng-devops publica
+- squad-design entra na UI (handoff de tokens e telas)
+- iron-copy entra no texto de interface
+- iron-cyber entra antes de publicar quando houver auth ou pagamento
+- Faixa AJUSTE nao gera documento: eng-dev direto, com reverificacao do diff no fim
+
+## 6. Escalation Protocol
+
+Tres tipos de conflito e como o iron-ceo resolve:
+
+1. Conflito de dominio — dois agentes parecem servir o mesmo pedido.
+   Resolucao: o iron-ceo consulta a Ambiguity Matrix. Se ainda ambiguo,
+   pergunta a voce qual caminho prefere.
+
+2. Lacuna de capacidade — nenhum agente cobre o pedido.
+   Resolucao: o iron-ceo aciona iron-search (pesquisa como resolver) ->
+   iron-forge (constroi o novo agente). Avisa voce antes de criar.
+
+3. Disputa de qualidade — entrega de um agente nao atende o esperado.
+   Resolucao: o iron-ceo pode escalar para a camada XQ equivalente,
+   ou acionar iron-auditor (no caso de entregas visuais).
+   Em CODIGO, quem opera o gate e o iron-eng (cargo eng-qa), nao o
+   iron-auditor — o iron-auditor e visual.
+
+## 7. Agentes Pessoais (nao-roteaveis)
+
+Voce pode ter, em  ~/.claude/agents/ , agentes que criou por conta propria
+para um projeto especifico ou para uso pessoal (um treinador esportivo, um
+personagem de marca, o cardapio de um negocio seu). Eles nao vem neste
+pacote e nao entram na Routing Table.
+
+Regra: o iron-ceo NAO aciona agente que nao esteja na Routing Table num
+fluxo normal — so quando voce pedir pelo nome. Isso evita que um agente de
+projeto especifico seja escolhido para uma demanda generica.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "iron-edge",
-  "version": "1.2.0",
-  "description": "Iron Edge — ecossistema de agentes para Claude Code. 36+ agentes especializados incluindo Gary Halbert, David Ogilvy, Eugene Schwartz, Al Ries, David Aaker, Hormozi frameworks, Advisory Board com Charlie Munger e Naval Ravikant.",
+  "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",
     "claude-code",
@@ -14,19 +14,26 @@
   "author": "Iron Edge",
   "license": "MIT",
   "bin": {
-    "iron-edge": "bin/cli.js"
+    "iron-edge": "bin/iron-edge.js"
   },
   "files": [
     "bin/",
     "agents/",
     "skills/",
-    "squads/"
+    "squads/",
+    "installer/",
+    "iron-routing-map.md",
+    "docs/",
+    "!docs/interno",
+    "!docs/historico"
   ],
   "engines": {
     "node": ">=18.0.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/iron-edge/iron-squad.git"
+  "scripts": {
+    "test": "node scripts/lint.js"
+  },
+  "devDependencies": {
+    "js-yaml": "^5.3.0"
   }
 }

package/skills/anotar/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: anotar
+description: Caderno de aprendizados do Iron Edge. Quando o usuário escrever "anota isso", "salva isso como aprendizado", "anota aí", "guarda esse aprendizado" ou variação clara disso, gravar o ÚLTIMO aprendizado da conversa no caderno do cofre, sem perguntar nada. É pra conhecimento reaproveitável — estado de projeto vai no "salvar", não aqui.
+---
+
+# anotar — caderno de aprendizados
+
+O "salvar" registra ESTADO (o que foi feito, como o projeto está). Este registra CONHECIMENTO — o que foi aprendido e volta a servir depois que o projeto acabar.
+
+## O que fazer
+
+1. Identificar o ÚLTIMO aprendizado real da conversa. Havendo mais de um candidato, escolher o mais reaproveitável e dizer qual escolheu.
+2. Append de uma entrada nova no fim de `Aprendizados/Aprendizados.md` do cofre (criar o arquivo com frontmatter `atualizado:` se não existir; o caminho do cofre está em `~/.iron/config.yaml`, campo `vault_path`), neste formato fixo:
+
+```
+## AAAA-MM-DD — Título curto do aprendizado
+**Tags:** #tag1 #tag2
+
+**O que é:** explicação curta, escrita pro usuário se entender daqui a seis meses, sem o contexto desta sessão.
+**Como apareceu:** o problema real que fez aprender. Concreto, com o erro ou a situação que aconteceu de fato.
+**Como aplicar de novo:** onde isso volta a aparecer e o que fazer quando aparecer.
+```
+
+3. Atualizar o campo `atualizado:` do frontmatter pra data de hoje.
+4. Confirmar em uma linha curta, dizendo o título gravado.
+
+## Estado × conhecimento × memória do Claude
+
+- **É conhecimento, não estado.** Se o pedido for na verdade estado de projeto ("o deploy passou", "falta fazer X"), diga isso e sugira o "salvar" no lugar. Não grave nos dois.
+  - `"o job X quebrou hoje no deploy"` → estado, vai no salvar.
+  - `"job quebra quando o schema tem campo aninhado incompatível, e a causa é sempre o mesmo cast implícito"` → conhecimento, vai aqui.
+  - Quando a mesma coisa é as DUAS (o bug de hoje que também é lição geral — o caso mais comum): o fato datado vai no diário pelo salvar, e aqui vai SÓ a parte que continua valendo depois que o projeto acabar. Não é duplicar: é separar o datado do durável.
+- **E existe um terceiro lugar: a memória persistente do Claude.** A divisão é por DESTINATÁRIO, não por assunto:
+  - **caderno** → escrito pro USUÁRIO ler depois. Explicação, contexto, o erro que aconteceu. Texto pra humano.
+  - **memória do Claude** → escrito pro CLAUDE usar sozinho na próxima sessão. Preferência de trabalho, regra, caminho importante.
+  - O mesmo aprendizado pode gerar os dois, com textos diferentes. Se só couber num, pergunte qual antes de escolher sozinho.
+
+## Regras
+
+- Data sempre absoluta (AAAA-MM-DD).
+- Não inventar aprendizado que não aconteceu na conversa. Se não houver um claro, perguntar qual é.
+- O que não estiver escrito não existe: escrever completo o bastante pra dispensar esta sessão.
+
+## O que NUNCA gravar (mesma regra do salvar)
+
+- Credencial, token, senha, chave de API.
+- Material confidencial de empregador ou cliente do usuário. O aprendizado técnico genérico pode; o material da empresa não.
+- Nome de pessoa real de fora, e dado de terceiro em geral.
+
+Se aparecer, não grave e avise que não gravou.

package/skills/brandkit/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: brandkit
+description: Cria identidade visual completa e kit de logo premium para QUALQUER marca, do briefing ao pacote final (SVG+PNG), brand guidelines em PDF e mockups de redes sociais. Use quando o usuário pedir criar logo, identidade visual, marca, branding, logotipo, brandbook, kit de logo, manual de marca, ou refinar/redesenhar um logo. Conduz por fases com decisão visual do cliente. Método validado em projeto real de identidade visual.
+---
+
+# Skill: brandkit — Identidade Visual & Kit de Logo (método premium)
+
+> Playbook para criar a identidade visual de uma marca do zero ao kit final, no padrão
+> que ja entregou identidade aprovada em projeto real. Conduz por FASES, sempre mostrando o
+> resultado em IMAGEM e deixando o cliente decidir antes de avançar.
+
+---
+
+## COMO USAR
+
+1. Trabalhe dentro da pasta do projeto (ex: `~/Desktop/marca-x`).
+2. Colete o briefing (abaixo), uma pergunta de cada vez se faltar.
+3. Execute as fases na ordem. Renderize TUDO em PNG e mostre antes de seguir.
+4. Para escolhas que mudam o rumo, use perguntas objetivas com opções (o cliente decide).
+
+**Pré-requisitos da máquina:** Google Chrome (previews) + Node (conversão SVG→PNG). Higgsfield CLI é opcional (conceitos por IA).
+
+---
+
+## REGRAS DE OURO (valem o tempo todo)
+
+1. **Decisão é do cliente, com base visual.** Nunca adivinhe gosto. Mostre opções lado a lado (renderizadas) e recomende uma. Ele escolhe.
+2. **Logo premium é FLAT.** Forma sólida, uma cor chapada, sem gradiente, sem 3D, sem sombra. Estude como Nike (forma única com movimento), Apple (negative space + grid) e Whoop (geometria + 1 acento) são construídos. Tem que funcionar a **16px** e em **preto e branco**. Se precisa de brilho pra ficar bonito, não está resolvido.
+3. **Uma cor é o acento/"sinal".** Aparece pouco e sempre significa a mesma coisa. Nunca preenche grandes áreas.
+4. **Anti-vícios de linguagem** (em todo texto: copy, PDF, mockups): nunca use travessão (—), nem a antítese "não é X, é Y", nem negação dramática em duas frases. Afirme direto. (Ver memória feedback-sem-travessao.)
+5. **Hierarquia, sem pular etapas:** identidade → logo → assets → aplicação.
+6. **Render 3D de IA ≠ logo.** Imagem de IA (Higgsfield) serve como direção criativa. O logo final é vetor flat. Marca premium tem os dois (o render vira peça hero; o vetor é o logo).
+
+---
+
+## BRIEFING (pergunte primeiro)
+
+- Nome da marca + o que faz (1 frase)
+- Público e posicionamento (premium? acessível? pra quem?)
+- Arquétipo/personalidade + 3-5 adjetivos
+- Anti-vibe (o que NÃO pode parecer)
+- 2-3 referências que admira
+
+---
+
+## AS FASES
+
+**FASE 1 — Benchmark.** 10 a 14 marcas do nicho e adjacentes. Para cada: tipo de logo, conceito, paleta (hex), tipografia. Diga o que está saturado (todo mundo usa) vs território livre. (Se tiver o Iron: delegue ao `iron-research`.)
+
+**FASE 2 — Direção.** 3-4 territórios visuais (cor + tipo de símbolo + tipografia + referência). Recomende um. Antes de desenhar, pergunte 3 coisas que mudam tudo: (a) base do estudo, (b) cor (abrir leque vs refinar), (c) nível do símbolo (minimalismo com personalidade vs elaborado).
+
+**FASE 3 — Conceitos.** 4-6 símbolos em SVG, renderizados num board PNG. Se pedirem mais criatividade, gere conceitos por IA (Higgsfield) como referência. Cliente escolhe a direção.
+
+**FASE 4 — Refino.** Itere o traço do símbolo escolhido (ângulo, peso, proporção), mostrando variações em PNG. Depois a COR: símbolo em 5-6 cores sólidas lado a lado pra cravar. Sempre renderize.
+
+**FASE 5 — Sistema.** Paleta (5-6 cores nomeadas, hex, função, regra do acento) + tipografia (wordmark + mono de dado + serif editorial) + lockups (horizontal, vertical, ícone de app).
+
+**FASE 6 — Pacote final (kit pra designer).** Estrutura:
+```
+KIT-LOGO/
+  01-simbolo/svg + png      (só o símbolo)
+  02-nome/svg + png         (só o wordmark; e versão curta se houver)
+  03-logo-horizontal/svg+png (USO PRINCIPAL)
+  04-logo-vertical/svg+png   (quadrados)
+  05-icone-app/svg+png       (1024/512/192)
+  LEIA-ME.txt  +  GUIA-VISUAL.png
+```
+Cada peça em SVG + PNG transparente alta-res (3x), nas versões **fundo escuro / fundo claro / mono (1 cor)**. Termine com `.zip`.
+
+**FASE 7 — Brand guidelines (PDF).** Apresentação 16:9 dark premium: capa, big idea, personalidade/arquétipo, o logo e conceito, variações + uso correto (área de proteção, tamanho mínimo, "nunca faça"), cores, tipografia, voz da marca (exemplos), anti-vibe, e **redes sociais** (mockup de perfil do Instagram + post 1:1 + story 9:16).
+
+---
+
+## RECEITAS TÉCNICAS (o que evita travar)
+
+### Renderizar preview HTML → PNG (boards, mockups, páginas do PDF)
+```bash
+CHROME="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+"$CHROME" --headless=new --disable-gpu --hide-scrollbars \
+  --force-device-scale-factor=2 --screenshot="out.png" \
+  --window-size=1200,800 "file:///caminho/board.html"
+# fundo transparente: adicione  --default-background-color=00000000
+```
+
+### Gerar o PDF (brand guidelines)
+HTML com `@page{size:1280px 720px;margin:0}` e cada slide numa `.page` com `page-break-after:always`. Depois:
+```bash
+"$CHROME" --headless=new --disable-gpu --no-pdf-header-footer \
+  --print-to-pdf="guia.pdf" --virtual-time-budget=8000 "file:///caminho/guia.html"
+```
+
+### Converter os SVGs finais → PNG com a fonte certa (NÃO use Chrome em loop, ele trava)
+1. Instale a fonte do wordmark no sistema, uma vez:
+```bash
+curl -fsSL -o /tmp/font.ttf "<url-do-ttf-no-google-fonts-github>"
+cp /tmp/font.ttf ~/Library/Fonts/
+```
+2. Use `@resvg/resvg-js` no Node (determinístico, usa a fonte do sistema, transparência):
+```bash
+mkdir -p /tmp/resvg && cd /tmp/resvg && npm init -y && npm i @resvg/resvg-js
+```
+```js
+const { Resvg } = require('@resvg/resvg-js'); const fs = require('fs');
+const r = new Resvg(fs.readFileSync(svgPath), {
+  fitTo: { mode: 'zoom', value: 3 },                 // 3x de resolução
+  font: { fontFiles: ['/Users/<voce>/Library/Fonts/<fonte>.ttf'],
+          loadSystemFonts: true, defaultFontFamily: '<Nome da Fonte>' },
+  background: 'rgba(0,0,0,0)',                        // transparente
+});
+fs.writeFileSync(outPng, r.render().asPng());
+```
+> Por quê: o Chrome headless em loop pendura no sandbox, e `@import` de fonte por rede falha. resvg resolve os dois.
+
+### Conceitos de símbolo por IA (opcional)
+Use a skill `higgsfield-generate` (GPT Image 2) pedindo "brand symbol / app icon, minimalista, premium, muito espaço negativo, [paleta], sem texto". São referências de direção; depois vetorize a escolha em SVG flat.
+
+### Tamanhos de ícone
+```bash
+for sz in 1024 512 192; do sips -z $sz $sz icone.png --out icone-$sz.png; done
+```
+
+---
+
+## ANATOMIA DE UM SÍMBOLO SVG FLAT (modelo)
+
+Mono-line com ponto de acento (uma curva continua com um ponto que quebra o ritmo). Ajuste o path ao conceito:
+```svg
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="4 0 108 72" width="432" height="288">
+  <path d="M14 36 C18 30 24 34 28 46 C33 62 47 64 55 53 C66 38 76 22 96 12"
+        fill="none" stroke="#F1F2EC" stroke-width="8" stroke-linecap="round"/>
+  <circle cx="99" cy="10" r="6.5" fill="#ACENTO"/>
+</svg>
+```
+Variantes = trocar as cores (fundo escuro: stroke claro; fundo claro: stroke escuro; mono: tudo numa cor).
+
+## WORDMARK SVG (modelo, bicolor)
+```svg
+<text x="2" y="70" font-family="'<Fonte>',sans-serif" font-weight="500"
+      font-size="72" letter-spacing="-3">
+  <tspan fill="#BASE">parte1</tspan><tspan fill="#ACENTO">parte2</tspan>
+</text>
+```
+> O símbolo é vetor puro (definitivo). O wordmark fica como texto na fonte; avise que pra produção a designer converte em curvas (outline). Os PNGs já saem com a fonte aplicada.
+
+---
+
+## ENTREGA FINAL
+- Pasta do kit organizada + `.zip` pronto pra designer
+- PDF de brand guidelines aberto pro cliente
+- Tudo revelado no Finder (`open -R`)
+
+Lembre o cliente: separe **nome de marca** (curto, falado) de **endereço/redes** (pode ser descritivo, ex: marca de uma palavra curta, site com o sufixo do segmento), como Oura/ouraring.com.

package/skills/clone-distill/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: clone-distill
+description: Transforma um inventory.json (medido pela clone-inventory) nos placeholders que o lp-cinematico consome — {{COLOR_INK/CREAM/OCHRE/TERRA}} em HSL triplet e {{FONT_DISPLAY/BODY}}. Gera um tokens.md pronto pra colar. Use quando o usuário tiver o inventário de uma referência e quiser gerar uma página nova no lp-cinematico com o DNA visual dela (destilar, não copiar).
+argument-hint: [inventory.json] [--out tokens.md]
+allowed-tools: Bash(node ${CLAUDE_SKILL_DIR}/scripts/distill.mjs *), Read, Write
+---
+
+# clone-distill — do inventário pros tokens do lp-cinematico
+
+Pega o `inventory.json` da `clone-inventory` e preenche a tabela de placeholders
+do `lp-cinematico`. Destila **decisões** (cor, escala, raio, fonte), não conteúdo:
+você fica com a gramática visual da referência, não com a página dela.
+
+## Fluxo
+1. `clone-inventory <url>` mede a referência → `inventory.json`.
+2. `clone-distill inventory.json` → `tokens.md` com os placeholders preenchidos.
+3. Cola os valores na tabela do `lp-cinematico` e gera a página nova.
+
+## Como rodar
+```bash
+node ${CLAUDE_SKILL_DIR}/scripts/distill.mjs "<inventory.json>" --out "<pasta>/tokens.md"
+```
+
+## O mapeamento (inventário → lp-cinematico)
+| lp-cinematico | vem de |
+|---|---|
+| `{{COLOR_INK}}` | a cor mais escura da paleta (aceita navy com matiz) |
+| `{{COLOR_CREAM}}` | a **neutra** mais clara (não pega um amarelo claro por engano) |
+| `{{COLOR_TERRA}}` | a cor de marca principal (primária) |
+| `{{COLOR_OCHRE}}` | a 2ª cor de marca; se não houver, **derivada** da terra por luminosidade |
+| `{{FONT_DISPLAY/BODY}}` | famílias medidas; se comercial, sugere a Google mais próxima |
+
+## Regras (não inventar em silêncio)
+- Cor que falta é **derivada por luminosidade** da que existe — matiz preservado,
+  nunca um matiz novo. E o `tokens.md` marca qual foi derivada.
+- Fonte comercial (Söhne, GT, Circular…) não some: vira aviso com a Google Font
+  sugerida via `@fontsource`, pra você confirmar ou trocar.
+- Se o próprio original reprova contraste AA, o `tokens.md` avisa antes de você
+  herdar o par ink/cream.
+- Se a referência é neutra (sem cor de marca), TERRA/OCHRE ficam vazios pra você
+  pôr a cor do cliente — não chuta.
+
+## Saída
+`tokens.md`: tabela de placeholders + bloco `:root` pronto + sinais de caráter
+(razão de escala, raio, sombra colorida) + as decisões que exigem sua confirmação.