Guia comparativo

Harness, context engineering e RAG: qual a diferença e como se encaixam

Por Bruno Americo · 19 de julho de 2026

Context engineering é uma camada do harness, não um sinônimo dele. É a camada de seleção de informação: o conjunto de estratégias para curar os tokens certos que o modelo vê, como a Anthropic define (setembro de 2025). RAG fica dentro de context engineering, é uma técnica de recuperação. O harness é o todo, contexto mais orquestração.

O que é context engineering, afinal

Context engineering é a disciplina de decidir o que entra na janela de contexto do modelo e o que fica de fora. A Anthropic define como "o conjunto de estratégias para curar e manter o conjunto ideal de tokens (informação) durante a inferência do LLM" (29 de setembro de 2025). O termo pegou no fim de junho de 2025: Tobi Lütke usou, Andrej Karpathy amplificou como "a arte e a ciência delicadas de preencher a janela de contexto com a informação certa", e Simon Willison documentou no post dele de 27 de junho de 2025. Então é real, e é mais do que escrever um bom prompt. É engenheirar a informação sobre a qual o modelo roda.

RAG é uma técnica dentro de context engineering

RAG e context engineering são usados como se fossem a mesma coisa. Não são. RAG (geração aumentada por recuperação) é uma forma de trazer informação relevante pro contexto: busca documentos, injeta os melhores resultados. Karpathy lista isso como só um elemento de context engineering, ao lado de memória, sumarização e saída de ferramentas. A Atlan diz direto: "Context engineering é uma disciplina, e RAG é uma de suas técnicas" (abril de 2026), e context engineering "envolve a recuperação com governança". Então RAG está dentro de context engineering, e context engineering está dentro de algo maior.

A contenção, camada por camada

CamadaO que cobreExemplo
RAGUma técnica de recuperação: traz documentos relevantes pro contextoBusca vetorial, injeta os melhores resultados
Context engineeringA camada de seleção de informação: cura os tokens ideais. Contém RAG e prompt engineeringRecuperação, memória, sumarização, o que manter ou descartar
Prompt engineeringEscrever a instrução que o modelo lê. Um subconjunto da seleção de contextoSystem prompt, exemplos few-shot
Harness (orquestração)O ambiente engenheirado inteiro: contexto mais ferramentas, estado, verificação, permissões, términoClaude Code, capivaOS
ModeloOs pesos que geram tokens. O que o harness envolvegpt-5.2, Claude, Gemini

Context engineering é uma camada, o harness é o todo

A Atlan descreve duas camadas que as pessoas achatam em uma só. Context engineering é a camada de seleção de informação: o que o modelo vê. Harness engineering é a camada de orquestração: estado, ferramentas, verificação, permissões e quando parar. Context engineering não é a menor. É uma disciplina de verdade, e é difícil. Mas um modelo que vê a informação certa ainda pode chamar a ferramenta errada, rodar pra sempre ou entregar saída que ninguém checou. Essas falhas ficam na camada de orquestração. Então, se você domina context engineering, você construiu uma camada do harness. Uma boa. Não o todo.

A seleção de contexto é onde a maioria para

A seleção de contexto é onde a maioria para. A camada de orquestração é o que vem depois: ferramentas, estado, verificação, permissões e término. Um harness de verdade entrega as duas no mesmo pipeline. É isso que o capivaOS é, o harness open-source sobre o Claude Code. Pra visão completa do harness que contém context engineering, RAG e todo o resto, comece por O que é um AI Harness.

Perguntas frequentes

O que é context engineering?

É a disciplina de curar o que entra na janela de contexto do modelo: quais documentos, memória e instruções o modelo vê durante a inferência. A Anthropic define como o conjunto de estratégias para curar e manter o conjunto ideal de tokens durante a inferência do LLM (setembro de 2025). É mais amplo que escrever um prompt, e é uma camada do harness.

Qual a diferença entre context engineering e RAG?

RAG é uma técnica; context engineering é a disciplina que a contém. RAG recupera documentos relevantes e injeta no contexto. Context engineering decide tudo o que preenche a janela de contexto: recuperação, memória, sumarização e o que deixar de fora. A Atlan coloca assim: "Context engineering é uma disciplina, e RAG é uma de suas técnicas" (abril de 2026).

Context engineering é a mesma coisa que o harness?

Não. Context engineering é a camada de seleção de informação: o que o modelo vê. O harness é o ambiente engenheirado inteiro, que também inclui orquestração: ferramentas, estado, verificação, permissões e término (modelo em camadas da Atlan, 2026). Context engineering fica dentro do harness.

Quem cunhou o termo context engineering?

O termo pegou no fim de junho de 2025. Tobi Lütke usou, Andrej Karpathy amplificou (chamando de a arte e a ciência de preencher a janela de contexto com a informação certa), e Simon Willison documentou no post dele de 27 de junho de 2025. É uma disciplina de verdade, com história curta e bem rastreada.

Context engineering é o mesmo que prompt engineering?

Não. Prompt engineering é escrever a instrução que o modelo lê. Context engineering é mais amplo: gerencia tudo na janela de contexto, incluindo o prompt, documentos recuperados, memória e saída de ferramentas. Prompt engineering é uma parte de context engineering, não o contrário.

Se eu fizer RAG bem feito, eu tenho um harness?

Não. RAG bem feito te dá boa recuperação, que é uma técnica dentro de context engineering, que é uma camada do harness. Um harness também precisa de orquestração: ferramentas, estado, verificação, permissões e uma regra de quando parar. Recuperação sozinha não pega uma chamada de ferramenta errada nem um loop que não termina.

RAG está dentro de context engineering. Context engineering está dentro do harness. Domine uma camada e você ainda tem que construir o resto.

capivaOS no GitHub →O que é um AI Harness? →Diagnóstico estratégico →