Blog da Capiva
Artigos e tutoriais escritos pela Capiva sobre o que fazemos no dia a dia: montar o harness em volta de agentes de IA, configurar o Claude Code, fazer uma empresa ser citada por ChatGPT e outras IAs, e estruturar a adoção de IA numa empresa.
23 artigos, do mais recente ao mais antigo em cada tema.
AI harness, Claude Code e agentes de IA
- Hooks do Claude Code: como configurar, com 3 exemplos prontos (PreToolUse, PostToolUse e Stop)
Como configurar hooks no Claude Code com 3 exemplos testados: PreToolUse protege migrações, PostToolUse roda o ruff e Stop exige testes verdes.
Publicado em
- CLAUDE.md: o que é e como escrever um que o agente segue (exemplo, tamanho ideal e CLAUDE.md vs AGENTS.md)
O que é o CLAUDE.md e como escrever um que o Claude Code segue: exemplo comentado, tamanho ideal, CLAUDE.md vs AGENTS.md, regras por caminho e lint.
Publicado em
- Como criar um servidor MCP em Python e configurar no Claude Code (claude mcp add, .mcp.json e escopos)
Como criar um servidor MCP em Python com o SDK oficial, testar com pytest e configurar MCP no Claude Code com claude mcp add, .mcp.json e escopos.
Publicado em
- Como criar uma Skill no Claude Code: SKILL.md passo a passo, com script e argumentos
Como criar uma Skill no Claude Code: estrutura do SKILL.md, description que dispara, argumentos, script embutido, allowed-tools e validação.
Publicado em
- Como instalar o Claude Code no Windows: PowerShell, CMD, WinGet ou WSL (e os erros mais comuns)
Como instalar o Claude Code no Windows: PowerShell, CMD, WinGet ou WSL, Git for Windows, PATH, login e a solução dos erros de instalação mais comuns.
Publicado em
- Guardrails e evals para agentes de IA: o que são e como saber se o agente acertou antes da produção
Guardrails para LLM bloqueiam a ação errada; evals medem se o agente acerta. Golden set, LLM-as-a-judge, regressão e kill switch com Claude Code Mods.
Publicado em
- O que é Harness Engineering? A disciplina que decide se o agente funciona em produção
Harness engineering é a disciplina de projetar tudo o que envolve o modelo (regras, ferramentas, memória e verificação) para um agente funcionar em produção. Nomeada por Mitchell Hashimoto em 2026.
Publicado em
- Harness, context engineering e RAG: qual a diferença e como se encaixam
Context engineering é uma camada do harness, não um sinônimo, e RAG é uma técnica dentro de context engineering. Entenda a contenção: RAG dentro de context engineering, dentro do harness.
Publicado em
- Exemplos de AI Harness: 5 harnesses reais, do terminal ao engenheiro autônomo
Exemplos reais de AI harness: Claude Code, Cursor, Devin, o deepagents-cli da LangChain e o capivaOS, um harness engenheirado sobre o Claude Code.
Publicado em
- Como construir um AI harness: a receita prática, do simples ao sistematizado
Para construir um AI harness, comece simples e cresça ele a partir de falhas observadas: cada erro do agente vira uma regra permanente, depois sistematizada em guides e sensors.
Publicado em
- Claude Code é um Harness: CLAUDE.md, hooks, MCP e subagents como guides e sensors
O Claude Code é um harness: CLAUDE.md, hooks, MCP, subagents e permissões são os guides e sensors em volta do modelo, e o capivaOS é um harness engenheirado em cima dele.
Publicado em
- AI Harness e Benchmark: por que o mesmo modelo tira notas diferentes
Em benchmarks de agentes, o harness move a nota tanto quanto o modelo. Há dois sentidos: agent harness (o scaffold, que precisa ser divulgado) e eval harness (o runner, que precisa ficar constante).
Publicado em
- Harness operacional: a IA além do código que quase ninguém construiu
O harness operacional é o padrão de harness engineering aplicado à operação inteira de um negócio, não só ao código. Quase ninguém construiu essa camada ainda.
Publicado em
- O que é um AI Harness? Definição, componentes e por que ele importa mais que o modelo
AI harness é a infraestrutura em volta de um LLM (ferramentas, regras, memória e quality gates) que o transforma em agente confiável. Agente = Modelo + Harness.
Publicado em
- AI Harness na Prática: operando uma empresa com agentes
A Capiva construiu um AI Harness operacional, e abriu o código da camada de desenvolvimento como capivaOS. O que é harness engineering e como funciona na prática.
Publicado em
GEO e citação por IA
- llms.txt: o que é e como criar, gerar e validar (exemplo em Next.js)
O que é o llms.txt e como criar o seu: formato da v2 de llmstxt.org, gerador e validador em Python e publicação em Next.js com o header Link.
Publicado em
- Como medir se o ChatGPT cita sua empresa: script em Python com a API de busca da OpenAI
Script em Python que pergunta à API da OpenAI com busca na web, repetidas vezes, e mede se sua marca é mencionada e seu site citado. Com teste sem custo.
Publicado em
- O que é GEO / SEO para IA (e como funciona)
GEO (Generative Engine Optimization), AEO e "SEO para IA" são a disciplina de otimizar conteúdo para ser citado pelas respostas de IA — distinto do SEO clássico, que ranqueia links. O conceito (Princeton, 2023), a diferença entre os termos e o que a IA premia.
Publicado em
- Como aparecer no ChatGPT: o que faz a IA recomendar sua empresa
Você não cadastra sua empresa no ChatGPT — a IA recomenda quem tem presença citável, estruturada e autoritativa. As três alavancas reais (citabilidade, autoridade, acesso técnico) e como testar.
Publicado em
Consultoria e adoção de IA
- Consultoria de IA para Empresas: O Que É, O Que Cobre e Como Escolher a Certa
Consultoria de IA para empresas cobre diagnóstico, prova de conceito, implementação e governança contínua. O que cada frente inclui, como avaliar um fornecedor antes de contratar e o que separa um bom engajamento de um ruim.
Publicado em
- Quanto Custa Consultoria de IA? O Que Determina o Preço (e Como Pedir um Orçamento Real)
Não existe tabela fixa de preço para consultoria de IA. O valor depende do modelo de cobrança (hora, projeto, retainer, escopo), da senioridade da equipe e do escopo real do problema. Os fatores e as perguntas certas antes de aceitar um orçamento.
Publicado em
- O que é um AI Center of Excellence? A estrutura que decide se a IA vira capacidade ou fica em piloto
Um AI Center of Excellence é a estrutura interna que conduz a adoção de IA a resultados de valor e evita adoção fragmentada ou sem governança (Microsoft CAF). A maioria falha por virar gargalo.
Publicado em
- Claude Impact Lab Rio: IA Auditável para Saúde e Segurança Pública
A primeira edição brasileira do Claude Impact Lab reuniu equipes no Rio para criar soluções de IA para saúde e segurança pública.
Publicado em
Guias, ensaios e ferramentas ficam na biblioteca de recursos. Para aplicar isso na sua empresa, veja como trabalhamos.