Reglas de Code Review de Codex en AGENTS.md (julio 2026)
OpenAI lanzó reglas personalizadas de repositorio para Codex Code Review. Pon en AGENTS.md lo que el equipo siempre explica — Codex lo cita en los PR.
En julio de 2026 OpenAI lanzó reglas personalizadas de Code Review para Codex. El cambio útil no es otro linter de estilo: es una forma de capturar el criterio que suele vivir en la cabeza de unos pocos revisores: contratos de API que no se pueden romper, campos que deben quedarse por clientes antiguos, datos que nunca deben ir a logs.
Qué cambió
- El mismo AGENTS.md, nuevo rol — el archivo que ya guía tareas de código ahora también guía reviews en GitHub.
- ## Code Review Rules — añade una sección dedicada; Codex aplica las reglas que cubren los archivos cambiados y las cita en los findings.
- Raíz + anidados — reglas del repo en la raíz; reglas de servicio cerca del código que rigen.
- Disparador — comenta
@codex reviewen el PR, o activa reviews automáticos en la configuración de Codex.
Una regla mínima que se paga sola
Empieza con una comprobación que los revisores repiten. El propio repo Codex de OpenAI protege nombres de eventos experimentales de los que Cloud aún depende. Tu versión puede ser:
- Declara la invariante (qué debe seguir siendo cierto).
- Nombra la vía segura (mantener el nombre, o añadir un evento compatible).
- Manténlo corto — reglas amplias generan ruido; con alcance acotado se recuperan findings sin spamear diffs limpios.
Cómo probarlo esta semana
- Activa Codex cloud + Code Review en el repositorio.
- Añade dos o tres reglas bajo
## Code Review Rulesen el AGENTS.md más cercano. - Abre un PR que dispare la regla, un contraejemplo seguro y un cambio no relacionado.
- Pide
@codex review— refina textos ruidosos y quédate con las reglas que disparan limpias.
Cómo encaja con Skills
Las reglas van junto a Skills y MCP. Skills codifican el cómo; AGENTS.md codifica lo que no puede romperse. Tips de cuota gratis en Try Codex; playbooks instalables en la página de Skills actualizada. Artículo oficial: Custom Code Review rules for Codex.
Si el review es el cuello de botella mientras los agentes generan más PRs, empieza con una explicación repetida — escríbela una vez en AGENTS.md y deja que Codex la cite en cada pull request.