Engenharia de Contexto para IA: O Skill
Prompt engineering ja era. O jogo agora e engenharia de contexto — saber estruturar o que o modelo precisa saber antes de pedir qualquer coisa. E isso que
TL;DR
Prompt engineering ja era. O jogo agora e engenharia de contexto — saber estruturar o que o modelo precisa saber antes de pedir qualquer coisa. E isso que separa codigo generico de codigo que funciona no seu projeto.
Context engineering vs prompt engineering: qual a diferenca real
Prompt engineering e sobre como voce faz a pergunta. Context engineering e sobre tudo que vem antes da pergunta. E uma diferenca sutil mas gigante na pratica.
Pensa assim: prompt engineering e tipo pedir um prato num restaurante. 'Quero um filé bem passado com fritas.' Context engineering e escolher o restaurante certo, a cozinha certa, os ingredientes certos e o chef certo — ai qualquer pedido que voce fizer vai sair bom.
No mundo dev, prompt engineering e escrever 'crie um componente de formulario com validacao'. Context engineering e garantir que o modelo ja sabe que voce usa React 19, Zod pra validacao, Tailwind pra estilo, e que os formularios do projeto seguem um padrao especifico com error boundaries e loading states.
A verdade e que prompt engineering atingiu um teto. Os modelos ficaram tao bons que a qualidade do output depende muito mais do contexto disponivel do que da forma como voce pede. Dev senior sabe disso — dev junior ainda acha que o segredo e escrever prompt mais elaborado.
Context engineering inclui: arquivos de configuracao (CLAUDE.md, .cursorrules), codigo-fonte do projeto que o modelo consegue ler, documentacao relevante carregada via MCP ou RAG, e a conversa acumulada na sessao. Tudo isso junto forma o 'contexto' que o modelo usa pra gerar codigo.
Os 4 pilares do contexto de qualidade
Depois de meses usando agentes de IA diariamente, identifiquei 4 categorias de contexto que impactam diretamente a qualidade do output. Acerta esses 4 e a IA para de alucinar.
- Contexto de stack (o QUE)Linguagem, frameworks, versoes, dependencias. O agente precisa saber exatamente o que esta instalado no projeto. Next.js 15 gera codigo diferente de Next.js 14. TypeScript strict e diferente de TypeScript relaxado. Cada detalhe de versao importa.
- Contexto de convencao (o COMO)Naming, estrutura de pastas, patterns de codigo, estilo de commits. Se seu time usa camelCase, o agente precisa saber. Se funcoes puras ficam em lib/ e componentes em components/, o agente precisa saber. Convencao nao documentada e convencao ignorada.
- Contexto de dominio (o POR QUE)Regras de negocio, glossario do projeto, fluxos de usuario. Se o sistema tem conceito de 'workspace' que nao e o significado padrao, documente. Termos ambiguos causam as piores alucinacoes.
- Contexto negativo (o que NAO)Bibliotecas proibidas, patterns evitados, decisoes arquiteturais ja descartadas. Tao importante quanto o que fazer. Sem isso, o agente volta pros padroes genericos e sugere styled-components quando voce so usa Tailwind.
A maioria dos devs so cuida do primeiro pilar — lista a stack e acha que ta feito. O salto de qualidade vem quando voce preenche os outros tres. Especialmente o contexto negativo, que quase ninguem documenta.
Tecnicas avancadas de context engineering
Depois que voce domina o basico, existem tecnicas que multiplicam a eficacia do contexto. Sao coisas que devs seniors fazem intuitivamente mas que da pra sistematizar.
Context layering (camadas de contexto)
Em vez de jogar tudo num arquivo so, organize o contexto em camadas. Camada global (rules que valem pro projeto inteiro), camada de modulo (regras especificas do modulo que voce ta mexendo), camada de tarefa (contexto da task atual). Ferramentas como Claude Code e Cursor ja suportam isso nativamente com CLAUDE.md por diretorio e .cursor/rules/.
Example-driven context (contexto por exemplo)
Em vez de descrever como um componente deve ser, mostre um componente existente que segue o padrao. 'Crie um componente igual ao UserCard mas pra produtos' e absurdamente mais eficaz que 'crie um componente com card, imagem, titulo, descricao e botao usando Tailwind com rounded-lg e shadow-md'. O exemplo carrega dezenas de decisoes implicitas que voce nem pensaria em documentar.
Context pruning (poda de contexto)
Mais contexto nem sempre e melhor. Modelos tem janela limitada e priorizam informacao recente. Se voce enche o contexto com documentacao irrelevante, o modelo pode ignorar as regras que importam. Revise periodicamente e remova o que nao contribui pro output.
Feedback loop (ciclo de feedback)
Toda vez que o agente gera algo errado, pergunte: 'que contexto estava faltando pra ele acertar?' Depois, adicione esse contexto no arquivo de configuracao. Com o tempo, seus arquivos de contexto viram uma base de conhecimento refinada que praticamente elimina erros recorrentes.
Essa tecnica de feedback loop e o que separa quem usa IA ocasionalmente de quem usa IA como multiplicador. Cada erro do agente e uma oportunidade de melhorar o contexto pra sempre.
Exercicios praticos pra treinar
Teoria e bonita, mas voce precisa praticar. Aqui vao 5 exercicios que eu uso pra treinar engenharia de contexto. Da pra fazer em qualquer ferramenta — Claude Code, Cursor, ChatGPT.
Exercicios de context engineering
- Exercicio 1: Zero context — Peca pro agente criar um formulario SEM nenhum contexto. Salve o resultado. Depois adicione stack, convencoes e um exemplo. Peca de novo. Compare os dois outputs.
- Exercicio 2: Context audit — Pegue seu CLAUDE.md ou .cursorrules atual. Peca pro agente gerar 3 componentes diferentes. Anote cada erro. Pra cada erro, identifique que regra estava faltando.
- Exercicio 3: Context minimal — Qual e o MINIMO de contexto necessario pra o agente gerar um componente correto no seu projeto? Comece com 3 linhas e va adicionando ate o output ficar aceitavel.
- Exercicio 4: Context transfer — Copie as regras do seu projeto A pro projeto B (que usa stack diferente). Veja o que quebra. Isso mostra quais regras sao genericas e quais sao especificas.
- Exercicio 5: Context negativo — Escreva so regras do que NAO fazer. Nenhuma regra positiva. Peca pro agente criar algo. O resultado mostra quais proibicoes sao realmente importantes.
O exercicio 1 e o mais revelador. A diferenca entre o output sem contexto e com contexto e brutal — tipo noite e dia. Quando voce ve essa diferenca na pratica, voce nunca mais ignora o arquivo de contexto.
Dedique 30 minutos por semana pra esses exercicios durante um mes. Ao final, voce vai ter desenvolvido uma intuicao muito forte sobre como dar contexto eficiente pra qualquer modelo de IA.
Como medir a qualidade do seu contexto
Se voce nao mede, voce nao sabe se esta melhorando. Aqui vao metricas praticas que qualquer dev pode acompanhar.
Metricas quantitativas
+ Prós
- • Taxa de acerto na primeira tentativa — % de vezes que o agente gera codigo correto de primeira
- • Iteracoes ate aceite — quantas rodadas de correcao ate o codigo ficar bom
- • Tempo de revisao — quanto tempo voce gasta revisando output do agente
- • Linhas modificadas pos-geracao — quanto do codigo gerado voce precisa mudar
− Contras
- • Dificil medir em projetos pequenos (amostra pequena)
- • Varia muito por tipo de tarefa
- • Nao captura qualidade subjetiva do codigo
Metricas qualitativas
+ Prós
- • O agente usa as dependencias certas sem voce pedir?
- • Segue a estrutura de pastas do projeto?
- • O naming e consistente com o resto do codebase?
- • Consegue explicar decisoes arquiteturais do projeto quando perguntado?
− Contras
- • Subjetivas — dependem do julgamento do dev
- • Mais dificeis de comparar ao longo do tempo
- • Cada pessoa tem criterio diferente de 'bom'
A metrica mais pratica e a 'taxa de acerto na primeira tentativa'. Antes de investir em contexto, provavelmente esta em 30-40% — voce pede algo e precisa corrigir na maioria das vezes. Com bom contexto, sobe pra 70-80%. E o numero mais facil de acompanhar e que tem impacto direto na produtividade.
Mantenha um log simples durante uma semana: pra cada interacao com o agente, anote se o primeiro output foi aceitavel ou precisou correcao. Esse numero te diz exatamente onde voce esta e quanto pode melhorar.
Transforme sua carreira dev
Quer dominar as ferramentas que vao definir o mercado? No CrazyStack voce aprende React, Node.js e as melhores praticas de desenvolvimento na pratica. Engenharia de contexto e o tipo de skill que multiplica tudo que voce ja sabe.