Guias21 de julho de 20269 min de leitura

Regras de Code Review do Codex no AGENTS.md (jul/2026)

A OpenAI lançou regras customizadas de repositório para o Codex Code Review. Coloque no AGENTS.md o que o time sempre explica — o Codex cita nas PRs.

Em julho de 2026 a OpenAI lançou regras customizadas de Code Review para o Codex. A mudança útil não é outro linter de estilo — é uma forma de registrar o julgamento que costuma viver na cabeça de poucos revisores: contratos de API que não podem quebrar, campos que devem permanecer para clientes antigos, dados que nunca devem ir para logs.

O que mudou

O mesmo AGENTS.md, novo papel — o arquivo que já guia tarefas de código agora também guia reviews no GitHub.
## Code Review Rules — adicione uma seção dedicada; o Codex aplica as regras que cobrem os arquivos alterados e as cita nos findings.
Raiz + aninhados — regras do repositório na raiz; regras de serviço perto do código que regem.
Gatilho — comente @codex review na PR, ou ative reviews automáticos nas configurações do Codex.

Uma regra mínima que se paga

Comece com uma verificação que os revisores repetem. O próprio repositório Codex da OpenAI protege nomes de eventos experimentais dos quais o Cloud ainda depende. A sua versão pode ser:

Declare a invariante (o que deve permanecer verdadeiro).
Nomeie o caminho seguro (manter o nome, ou adicionar um evento compatível).
Seja curto — regras amplas geram ruído; regras com escopo recuperam findings sem spammar diffs limpos.

Como testar esta semana

Ative Codex cloud + Code Review no repositório.
Adicione duas ou três regras em ## Code Review Rules no AGENTS.md mais próximo.
Abra uma PR que dispare a regra, um contraexemplo seguro e uma mudança não relacionada.
Peça @codex review — refine textos ruidosos e mantenha as regras que disparam limpas.

Como isso se encaixa com Skills

Regras ficam ao lado de Skills e MCP. Skills codificam o como; AGENTS.md codifica o que não pode quebrar. Dicas de cota grátis em Try Codex; playbooks instaláveis na página de Skills atualizada. Artigo oficial: Custom Code Review rules for Codex.

Se o review virou gargalo enquanto agentes geram mais PRs, comece com uma explicação repetida — escreva uma vez no AGENTS.md e deixe o Codex citá-la em cada pull request.