Descreva o comportamento antes da solução
Escreva o problema do usuário: a pessoa precisa consultar pedidos entre duas datas. Defina o que significa funcionar: datas inicial e final inclusivas, mensagem para intervalo inválido, paginação coerente e preservação dos filtros já existentes. Acrescente o fuso horário e a fonte da data usada na consulta.
Evite começar impondo arquivos e funções quando ainda não conhece o desenho do projeto. Peça ao agente que localize a implementação atual, identifique convenções e proponha uma alteração compatível. Você continua responsável pelas decisões de produto que a base de código não pode esclarecer.
Prepare contexto e limites de trabalho
Use uma branch ou cópia de trabalho identificada e confira as alterações que já existem. Informe como instalar dependências e executar os testes relevantes. A documentação do Codex prevê instruções de projeto em AGENTS.md; esse arquivo pode registrar comandos, convenções e critérios que valem para tarefas futuras.
Sandbox e aprovações controlam aspectos diferentes da execução. Consulte a configuração do ambiente e mantenha acesso proporcional à tarefa. Incluir um filtro não exige, por si só, publicar a aplicação, alterar dados de produção ou ampliar acesso a serviços externos.
Peça um plano que possa ser revisado
Um pedido inicial pode ser: Localize a listagem de pedidos e seus testes. Explique como datas e paginação funcionam hoje. Proponha a menor alteração que atenda aos critérios abaixo, indique os arquivos envolvidos e destaque decisões que dependem de esclarecimento. Ainda não faça o deploy.
Leia o plano procurando omissões. O filtro será aplicado antes da paginação? A interface enviará datas no formato esperado pelo servidor? A solução exige mudança de contrato? Resolva essas questões antes de aceitar uma implementação extensa. Para uma alteração pequena e clara, a inspeção e o plano podem ser breves.
Implemente em uma unidade revisável
Autorize a implementação do escopo acordado. Peça que o agente preserve o padrão do projeto, evite refatorações sem relação com o requisito e informe qualquer impedimento encontrado. Uma mudança menor facilita compreender o que causou uma regressão.
Se surgir um problema preexistente, registre-o separadamente. Corrigi-lo pode ser necessário para concluir a tarefa, mas isso deve ficar explícito. Misturar alterações não relacionadas reduz a capacidade de conferir o resultado e de reverter apenas o que precisa ser revertido.
Confira testes e alterações
Solicite a execução dos testes adequados e leia o resultado. Teste não executado precisa aparecer como não executado, com o motivo. Além do caminho feliz, verifique datas iguais, intervalo invertido, ausência de resultado e pedidos próximos à mudança de dia.
Revise o diff e compare cada alteração com o requisito. A presença de testes verdes não substitui a leitura do comportamento, principalmente quando os testes foram escritos junto com a solução. Uma revisão adicional pode ajudar, mas a decisão de aceitar a mudança continua no processo da equipe.
Feche com evidências e limites
O resumo final deve explicar o problema resolvido, o comportamento resultante e como ele foi verificado. Inclua limitações reais, como um cenário dependente de credenciais que não pôde ser testado. Diferencie código pronto para revisão de código publicado.
Guarde o requisito, a versão inicial, o diff e a verificação. Esse conjunto permite avaliar a condução da tarefa e repetir o aprendizado em outra base. O objetivo é conseguir justificar a alteração, não apenas mostrar que o agente produziu código.
Fontes e referências
Consulte a documentação original para disponibilidade e condições atuais. Fontes consultadas em 21 de outubro de 2026.