Navegue neste artigo
‘Adicione exportação de relatórios’ parece uma tarefa simples. Mas quais dados, para quem e em qual formato? Antes de pedir código a um agente, transforme essas perguntas em decisões verificáveis.
Escreva uma especificação pequena
Spec Driven Development, ou SDD, usa uma especificação para orientar a implementação e a validação. Ela não precisa antecipar todo o futuro do produto. Precisa explicar o resultado, os limites e como reconhecer uma entrega correta.
No exemplo da exportação, defina o papel do usuário, o escopo dos dados, o formato e o comportamento em caso de falha. Escreva também o que não será entregue nesta etapa.
Objetivo: exportar pedidos da empresa autenticada
Papel: administrador com permissão de exportação
Formato: CSV com campos aprovados
Fora do escopo: dados de outras empresas e agendamento
Aceite: arquivo correto, acesso negado sem permissão,
erro tratado sem expor dados internosEntregue contexto que ajude a decidir
O agente precisa encontrar o contrato da API, a regra de autorização, exemplos de testes e instruções para executar o projeto. Não precisa receber todo o histórico de conversas nem uma cópia indiscriminada do repositório.
Context Engineering organiza essas informações. RAG pode recuperar referências quando necessário, mas a recuperação deve respeitar o acesso do usuário. Ter encontrado um documento não torna seu conteúdo uma instrução confiável para o agente.
- Especificação da tarefa e critérios de aceite.
- Módulos envolvidos e limites que devem ser preservados.
- Comandos reais de build e teste.
- Decisões existentes e dúvidas que exigem uma pessoa.
Separe o ciclo de trabalho do ambiente de execução
Loop Engineering organiza o ciclo de planejar, executar, observar e corrigir. O harness fornece o ambiente: ferramentas, permissões, contexto, limites e registros. São aspectos complementares; nenhum deles exige uma arquitetura com vários agentes.
Para uma exportação, o agente pode editar o módulo autorizado e executar testes em um ambiente isolado. Não precisa de credenciais de produção. Se uma etapa ultrapassar o escopo, o ciclo deve parar e pedir uma decisão, não inventar uma autorização.
Uma instrução no prompt descreve uma regra. Permissões no sistema é que limitam o que a ferramenta consegue fazer.
Valide comportamento, não volume de código
Peça evidências para cada critério: teste da exportação, negação de acesso e tratamento da falha. Revise o diff e execute as verificações fora da narrativa do agente. ‘Concluído’ é uma afirmação; o teste e o estado do sistema são as evidências.
Quando o produto usa IA durante sua operação, complemente testes de software com evals: casos representativos para comparar respostas, ferramentas e efeitos entre versões. A revisão humana entra nos pontos em que a decisão envolve risco ou julgamento de negócio.
Experimente em uma tarefa do seu projeto
Escolha uma alteração que caiba em uma entrega pequena. Escreva objetivo, limites e três critérios de aceite. Separe as referências, permita somente as ferramentas necessárias e execute o ciclo de implementação e revisão.
Guarde a especificação, a mudança e a evidência dos testes. Se outra pessoa não conseguir entender por que o resultado está correto, falta contexto na entrega. Se o processo exigir mais trabalho que a tarefa, reduza a cerimônia sem remover os controles essenciais.
Fontes e leituras relacionadas
Material educativo. Valide os exemplos em um ambiente de teste e adapte as decisões ao contexto, aos riscos e às responsabilidades do seu projeto.
Compartilhar