Todos os artigos

    Nota de arquitectura

    29 de março de 2026por Gustavo Teixeira Cuco4 min de leitura

    Engenharia de Contexto

    Contexto de arquitectura

    Método reutilizável

    Informação e contexto

    Aplicado em

    Agents & SkillsTHE iCON
    Engenharia de Contexto
    Ver no LinkedIn

    Aquilo a que costumava chamar "documentação" é, na verdade, o produto real do meu trabalho com IA.

    Durante meses construí ficheiros de contexto, estruturei repositórios com ficheiros CLAUDE.md, criei sistemas de memória persistente por projecto. Chamava-lhe "manter as coisas organizadas". O que estava realmente a fazer era engenharia de contexto — só não tinha um nome para isso.

    Tobi Lütke, CEO da Shopify, deu-lhe um nome em junho de 2025: "Gosto muito mais do termo 'engenharia de contexto' do que de engenharia de prompt. Descreve melhor a competência essencial: a arte de fornecer todo o contexto para que a tarefa seja plausivelmente resolvível pelo LLM." Andrej Karpathy afinou a definição: "a engenharia de contexto é a arte e a ciência delicadas de preencher a janela de contexto com exactamente a informação certa para o próximo passo."

    Não se trata do prompt perfeito. Trata-se do que está na janela de contexto quando o modelo precisa de agir.

    O que mudou — e porquê agora

    A engenharia de prompt fazia sentido em 2022–2023. Era a competência de formular a pergunta certa. Funcionava para tarefas isoladas. Mas quando as equipas passaram de demonstrações para sistemas em produção — agentes, fluxos de trabalho multi-etapa, memória persistente — o prompt deixou de ser o gargalo.

    A maioria das falhas em agentes de produção não são falhas do modelo. São falhas de contexto. Pouco contexto e o modelo alucina. Contexto a mais, ou mal estruturado, e perde o fio à meada. O ponto ideal não é trivial — e não se resolve com uma melhor formulação.

    Se a engenharia de prompt era encontrar a frase mágica, a engenharia de contexto é escrever o guião completo.

    Como é, na prática, uma arquitectura de contexto real

    A mudança torna-se concreta quando se observa como estão realmente estruturados os sistemas de IA bem governados. Uma configuração pronta para produção não depende de um único ficheiro de instruções. Distribui o contexto por camadas: um prompt de sistema que define comportamento e barreiras de segurança; documentação modular que cobre contexto de negócio, arquitectura, regras de design e estado de execução; uma matriz de gatilhos que associa cada tipo de mudança ao documento exacto que tem de ser actualizado; e um registo de decisões que preserva o raciocínio por trás de escolhas não óbvias.

    Cada camada responde a uma pergunta diferente que o modelo possa ter. Juntas, eliminam a necessidade de reexplicar o sistema em cada tarefa.

    Isso não é documentação. É infraestrutura.

    A pergunta que realmente importa

    Em ambientes empresariais, isto não é apenas um problema de design. É também um problema de governação: quem é dono do contexto, quem o actualiza e quem é responsável quando ele se desactualiza?

    Se estás a construir com IA em produção, a pergunta já não é "que modelo devemos usar?". É "o que entra no contexto, por que ordem, e quem é responsável por o manter actualizado?".

    A engenharia de contexto é a resposta a essa pergunta. E, como toda a boa engenharia, começa com clareza sobre o problema — não com palavras mágicas.

    Como é que estás a gerir o contexto persistente nos teus sistemas? Deixa um comentário.

    Fontes