BLACK FRIDAY 50% em todos os cursos com o cupom BLACK50, até 30/11 →GRÁTIS Curso gratuito de ChatGPT: lançamento 17/11, garanta sua vagaCurso gratuito de ChatGPT no ar, receba o acesso por e-mail →

Codex e desenvolvimento

Codex do requisito à revisão de código

Uma tarefa com Codex fica mais fácil de avaliar quando começa com um comportamento esperado e termina com evidências. Este roteiro usa a inclusão de um filtro de período em uma lista de pedidos como exemplo fictício. Ele pode ser adaptado a um repositório de estudo antes de entrar no fluxo da equipe.

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.