Home›Blog›Casa de ferreiro, espeto de pau? Como a Cortex IQ opera com skills e agentes de IA
Agentes de IASkillsOperaçãoArquitetura cyborg

Casa de ferreiro, espeto de pau? Como a Cortex IQ opera com skills e agentes de IA

Rudinei Gehm30 de Outubro de 20268 min de leitura

A Cortex IQ vende agentes de IA e usa agentes de IA para se gerir. Isso não é um detalhe de marketing, é uma regra de trabalho: nada que a gente entrega ao cliente vai a campo antes de rodar na nossa própria operação. O ditado diz que em casa de ferreiro o espeto é de pau. Aqui, o espeto é o mesmo que a gente forja para o cliente.

Este texto mostra como isso funciona por dentro, com os números conferidos nas pastas do nosso repositório em 30 de outubro de 2026, e com a lista do que ainda está incompleto. Quem trabalha com IA em empresa sabe que as duas partes importam.

Por que consultoria de IA não pode operar em planilha

Uma empresa que recomenda agente de IA, governança de dados e arquitetura de software, e toca a própria rotina com planilha e memória de WhatsApp, tem um problema de credibilidade. Pior: tem um problema de conhecimento. Dá para descrever em slide como um agente erra, mas só quem opera dezenas deles sabe onde a nota do juiz cai, o que custa em tokens e quando a cota estoura.

Por isso a Cortex IQ adotou o que chamamos de arquitetura cyborg também para dentro: pessoas definem direção e respondem pelo resultado, a IA executa, escala e sinaliza. A diferença é que aqui existe um repositório que prova a divisão.

As quatro peças e como elas se conectam

O repositório tem quatro áreas no mesmo lugar, de propósito: o agente precisa ler o cofre antes de trabalhar e deixar rastro nele depois.

  1. Skills. São 126 arquivos de regra de ofício, organizados em 18 raízes (o orquestrador e 17 papéis, como CEO, CFO, CTO, CMO e CLO) e até três níveis de profundidade. A skill é a única fonte das regras. Agentes e site apontam para ela e nunca a copiam. Se a regra muda, muda em um lugar só.
  2. Agentes. São 61, em seis grupos: engenharia, marketing, C-Level, conselho, operações e dados. Cada agente é uma skill com contexto próprio: persona, contrato de entrada e saída, rubrica de qualidade e a skill-fonte que ele lê antes de começar. Um arquivo por agente, validado por lint.
  3. agent-core. É o runtime. O Claude gera o artefato, um linter de português sem LLM barra clichê e resíduo de chatbot, e um segundo modelo, o Gemini, julga o texto por uma rubrica. Quem escreve não se avalia. Reprovado, o texto volta ao gerador com o feedback do juiz, até três tentativas. Existem 27 rubricas, todas herdando quatro critérios base: completude, ausência de alucinação, alinhamento técnico e clareza. A nota mínima é 8,5, e qualquer critério abaixo de 6 reprova mesmo com média alta.
  4. Segundo Cérebro. É um vault Obsidian com quatro cofres: a própria Cortex IQ e as divisões de produto (Assetly), cada uma isolada das outras. O agente lê o contexto da empresa antes de gerar. Depois da aprovação, o orquestrador grava log, rascunho e índice, sempre acrescentando. Nada é sobrescrito, e decisão revista vira entrada nova.

O caminho de uma tarefa

Marketing e engenharia seguem cadeias diferentes, e nenhum agente chama outro: quem monta a sequência é o orquestrador ou uma pessoa.

Na cadeia de marketing, o analista do canal (site, LinkedIn, Instagram, e-mail, imprensa) produz a peça. O gerente de marketing aciona o brand-guardian como controle de qualidade. O CMO aprova, aprova com ajuste ou reprova, e não reescreve. Quem publica é uma pessoa.

Na cadeia de engenharia, a história de usuário sai com tarefas de front, back e testes, e passa por um portão antes da análise técnica. O pacote técnico (arquitetura, modelo de dados, fluxos, contrato de API e segurança) passa por outro portão antes de qualquer código. Só então back e front são construídos em paralelo contra o mesmo contrato, seguidos de revisão de PR e de uma análise de segurança que roda antes e depois do código.

Quem decide

O humano decide. A recomendação de um agente C-Level é gravada no cofre como "aguardando decisão humana", e nunca como decisão tomada. Revisores são somente leitura e nunca corrigem o que revisam. O aprovador não reescreve. Agentes agendados vigiam, mas não executam ação que mude o ambiente.

Para decisões estratégicas existe ainda uma sala do conselho: seis lentes (lógica, estratégia, primeiros princípios, ética, visão sistêmica e filosofia) leem a mesma pergunta em paralelo, e um núcleo sintetiza. O resultado também fica aguardando decisão humana e só vai ao cofre se a pessoa marcar.

Há seis regras que valem para tudo, e a mais usada é a que mais incomoda: nunca inventar. Fato sem confirmação leva a marca "pendente de validação". Número, cliente e data só entram com fonte.

O escritório virtual

Para cadastrar, organizar e acionar os agentes, existe o Cortex Office: uma interface em React com um escritório isométrico em 3D, salas por departamento, os agentes nas mesas e os indicadores do dia na parede. Dá para contratar um agente novo por assistente (com lint antes de salvar), encadear agentes em fluxos de trabalho que pausam quando o juiz reprova, abrir a sala do conselho e conversar com cada agente. No modo "investigar" o agente só lê. No modo "resolver", cada edição, comando ou acesso à web pede aprovação.

O Office roda só na máquina local, nunca é exposto em rede, e não apaga nada: um agente excluído vai para uma pasta de arquivados e a exclusão pede confirmação digitada.

O que ainda não funciona

Um relato sobre operação que só lista acertos não ajuda ninguém. Na revisão que fizemos em 30 de outubro, estes pontos estavam abertos:

  • A pasta de automações do n8n existe, mas está vazia. A primeira automação real ainda não foi definida.
  • Os textos de apoio do repositório divergem entre si na contagem de skills e de agentes. A correção é gerar a contagem por script em vez de manter à mão.
  • Os prompts de imagem dos agentes ainda usam a identidade visual antiga da marca. A migração está planejada.
  • A ponte entre a memória episódica e o cofre curado está incompleta, e a checagem de isolamento entre divisões precisa vir antes de ligá-la.
  • Um fluxo de trabalho em andamento é interrompido se o serviço local reinicia, e roda uma execução por vez.

Funciona, e as pendências são conhecidas e estão escritas no cofre. É esse o critério que a gente cobra de cliente.

O que isso muda para quem contrata

O mesmo desenho vira entrega. Um agente de IA em produção precisa de regra de ofício escrita, contrato claro de entrada e saída, avaliação independente, memória rastreável e um humano com a decisão final. Sem isso, o agente funciona na demonstração e erra na terça-feira. O mesmo esqueleto de rastro e decisão responde, na prática, ao que a governança de IA pede: quem fez, com base em quê, quem aprovou.

Se a empresa quer começar sem reorganizar tudo, o caminho que recomendamos é escolher um ofício, não a empresa inteira. Escrever a skill desse ofício, montar um agente com rubrica, ligar ao cofre e medir por 90 dias, como mostramos em como medir o ROI de um agente de IA. Esse primeiro recorte cabe em uma PoC no Cyborg Forge, e a liderança técnica para decidir o que vem depois pode vir do CTO As a Service.

Perguntas frequentes

Qual a diferença entre skill e agente? Skill é o texto com as regras de um ofício, como as de um CFO ou de um revisor de marca. Agente é uma skill com contexto próprio: persona, contrato de entrada e saída, rubrica de qualidade e acesso ao cofre de memória. A regra mora na skill, e o agente a lê antes de começar.

Quem aprova o que os agentes produzem? Uma pessoa. Em marketing, a peça passa pelo revisor de marca e pelo CMO, e a publicação é humana. Em estratégia, a recomendação do agente fica registrada como aguardando decisão humana e nunca como decisão tomada.

Por que usar um modelo para gerar e outro para julgar? Quem escreve não se avalia bem. Um juiz independente, com rubrica e contexto do cofre, aponta o que o gerador não enxerga, como fato inventado ou claim sem fonte. Na nossa configuração, o Claude gera e o Gemini julga, com nota mínima 8,5 e até três tentativas.

Os agentes acessam dados de clientes? Só o que está no cofre do cliente, em pasta própria por projeto. O cofre não guarda senha, token, chave nem contrato assinado: guarda resumo e o caminho no Drive. As divisões de produto são isoladas entre si.

Dá para montar algo parecido na minha empresa? Dá, e o melhor começo é um ofício só, como atendimento, vendas ou marketing. Escreve-se a skill, monta-se o agente com rubrica, liga-se a um cofre e mede-se por 90 dias. Rodar agentes para clientes exige conta ou chave de API do próprio cliente.

Mande uma mensagem no WhatsApp contando qual é. Na conversa a gente mostra se IA resolve, quanto custa validar e em quanto tempo dá para ver resultado.

Conversar pelo WhatsApp