Contexto: o que o assistente precisa saber

Este curso assume que você já usa, ou está prestes a usar, algum assistente de IA para programar — não importa qual especificamente, porque o que este curso ensina é sobre como usar bem qualquer um deles, não sobre uma ferramenta em particular.

O ponto de partida é o mesmo do curso de Fundamentos de IA aplicado a código: o modelo não "sabe" sua base de código. Ele trabalha inteiramente com o que está no contexto que você (ou a ferramenta que você usa) fornece a cada pedido. A maior parte das respostas ruins de assistentes de código vem daí — contexto insuficiente ou errado — não de limitação do modelo em si.

O que "contexto" significa em código

Em uma conversa comum, contexto é o histórico da conversa. Em código, contexto é maior e mais específico:

• O arquivo que você está editando, obviamente — mas também os arquivos que ele importa ou referencia, que definem tipos, funções e convenções que o trecho atual depende.
• As convenções do projeto: como o time nomeia coisas, qual padrão de estrutura é usado, o que é idiomático ali e o que não é. Um assistente sem essa informação escreve código correto mas estranho ao olhar do time — funcional, mas fora do padrão.
• A intenção por trás da mudança: não só "adicione uma validação aqui", mas por que essa validação existe, o que ela deveria impedir. Sem isso, o assistente resolve o pedido literal e pode errar o objetivo — o mesmo padrão de erro de "otimizar para o pedido, não para o objetivo" do curso de Fundamentos de IA.

O problema da base grande

Bases de código reais costumam ser grandes demais para caber inteiras no contexto de qualquer assistente. Isso significa que alguém — você, ou a ferramenta — precisa decidir o que entra e o que fica de fora a cada pedido. Essa seleção é, na prática, a decisão mais importante de todo o processo: um assistente com o trecho certo do código, mesmo que pequeno, responde melhor do que um assistente com uma quantidade enorme de código pouco relevante.

O princípio do módulo de contexto em Fundamentos de IA se aplica direto aqui: informação no meio de um contexto muito longo recebe menos peso. Um arquivo relevante escondido no meio de uma pilha de arquivos menos relevantes pode ser efetivamente ignorado, mesmo estando "no contexto" tecnicamente.

Como selecionar contexto bem

Algumas práticas reduzem esse problema, independentemente da ferramenta usada:

• Comece pelo arquivo mais específico à tarefa, não pelo mais geral. Se a tarefa é sobre uma função específica, esse arquivo entra primeiro — arquivos de configuração geral do projeto raramente ajudam tanto quanto parecem.
• Inclua exemplos existentes do mesmo padrão, quando a tarefa for repetir algo que o projeto já faz em outro lugar. Um exemplo real vale mais que uma descrição abstrata do padrão esperado.
• Descreva a intenção, não só a instrução mecânica. "Adicione um cache aqui para reduzir chamadas repetidas ao mesmo endpoint" carrega mais contexto útil do que "adicione um cache aqui".
• Remova o que não é relevante à tarefa atual, mesmo que pareça útil "só por garantia". O mesmo raciocínio do módulo de ferramentas do curso de Agentes de IA — contexto a mais que não ajuda tem custo real, não é neutro.

Um sintoma de contexto insuficiente

Quando a resposta de um assistente "quase" resolve o problema, mas erra uma convenção óbvia do projeto ou reinventa algo que já existia em outro arquivo, o diagnóstico mais provável não é que o modelo é ruim para código — é que ele não tinha acesso à informação que faria a diferença. A correção certa, na maioria das vezes, é ajustar o que entra no contexto, não trocar de assistente.

Exercício

Pegue a última vez que um assistente de código te deu uma resposta "quase certa". Liste o que, no contexto do projeto, provavelmente faltava para a resposta ter saído certa de primeira — um arquivo relacionado, uma convenção não mencionada, a intenção por trás do pedido.

O que fica

• A maioria das respostas ruins de assistentes de código vem de contexto insuficiente, não de limitação do modelo.
• Contexto em código inclui arquivos relacionados, convenções do projeto e a intenção por trás da mudança, não só o trecho sendo editado.
• Em bases grandes, selecionar o que entra no contexto é a decisão mais importante — informação relevante escondida no meio de muito ruído perde peso.
• Uma resposta "quase certa" costuma indicar contexto faltando, não motivo para trocar de assistente.