Context engineering como disciplina de arquitetura
Context engineering não é uma técnica de otimização de prompt - é uma decisão de arquitetura com impacto direto em custo, confiabilidade e velocidade de um agente em produção. Dois casos reais, documentados por empresas diferentes, mostram por que isso já não é discussão técnica de nicho.
O custo real de tratar contexto como detalhe
A Manus documentou que, com Claude Sonnet, um token em cache custa US$ 0,30 por milhão contra US$ 3 sem cache - dez vezes mais caro. Como a proporção média entre entrada e saída em produção é de aproximadamente 100 tokens de entrada para cada 1 de saída, decisões aparentemente pequenas de contexto (como incluir um timestamp preciso no início do prompt) multiplicam o custo de operação inteiro, porque invalidam o cache de tudo que vem depois. Isso não é otimização marginal - é a diferença entre um agente economicamente viável em escala e um que não é.
O que acontece quando contexto não é tratado como arquitetura
O experimento de harness engineering da OpenAI mostra o lado oposto: um repositório inteiro (~1 milhão de linhas, 1.500+ PRs, produzido por três engenheiros conduzindo agentes) só funcionou porque o contexto - decisões de arquitetura, convenções, domínio de negócio - foi deliberadamente projetado para estar dentro do próprio repositório, não em conversas de Slack que o agente nunca veria. Quando esse contexto ficava de fora, ele era tão invisível para o agente quanto seria para um funcionário novo no primeiro dia.
O que os dados de mercado confirmam
A pesquisa State of AI Agents, da LangChain, mostra que a maior preocupação relatada por empresas com agentes em produção é qualidade de execução - com peso duas vezes maior que qualquer outro fator. Isso é consistente com o argumento central: quando o contexto é mal desenhado, a resposta do modelo pode ser tecnicamente competente e ainda assim errada para a situação, porque o modelo nunca teve acesso à informação certa, no momento certo, com o formato certo.
Por que isso é decisão de arquitetura, não de prompt engineering
Prompt engineering pergunta "como formular a instrução". Context engineering pergunta "o que o agente vê, quando vê, quanto isso custa manter, e o que acontece quando essa informação muda". São perguntas de arquitetura de sistema - do mesmo tipo que se faz sobre banco de dados ou cache de aplicação —, não perguntas de redação. Empresas que tratam contexto como parte da arquitetura, com donos, métricas de custo e revisão periódica, tendem a ser as mesmas que escalam agentes de um caso de uso isolado para produção real sem explodir custo ou qualidade.
O que isso exige da liderança técnica
Tratar context engineering como disciplina de arquitetura significa alocar tempo de arquiteto para desenhar o que entra em contexto fixo versus dinâmico, medir custo de cache como métrica de produto (não só de infraestrutura), e garantir que decisões de negócio importantes não fiquem presas em canais de comunicação que o agente nunca vai ler.
Fontes
- OpenAI - Harness engineering: leveraging Codex in an agent-first world - https://openai.com/index/harness-engineering/
- Manus - Context Engineering for AI Agents: Lessons from Building Manus - https://manus.im/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus
- LangChain - State of AI Agents - https://www.langchain.com/stateofaiagents