Skip to main content
Puedes cambiar lo que Code Review señala en tu repositorio confirmando instrucciones en él. Así es como reduces el volumen de nits, detienes los comentarios sobre archivos generados o agregas una regla que le importa a tu equipo. Colócalas en uno de estos dos archivos:
  • CLAUDE.md: instrucciones del proyecto que Claude Code lee en cada tarea, incluidas las revisiones. Code Review las lee como contexto del proyecto y señala los cambios que las infringen.
  • REVIEW.md: instrucciones exclusivas para las revisiones. Úsalo para indicar qué quiere tu equipo que se señale, con qué severidad y qué omitir.
Agrega REVIEW.md en la raíz de tu repositorio y fusiónalo. Luego protege tu rama predeterminada.
Para cambiar qué tan exhaustivas son las revisiones o cuándo se ejecutan, pídele a un Owner que cambie el nivel de revisión o el ajuste Review runs.

​
Usa CLAUDE.md para reglas de todo el proyecto

Code Review lee los archivos CLAUDE.md de tu repositorio como contexto del proyecto. Un cambio que infringe una de sus reglas se convierte en un hallazgo con el nivel de severidad que corresponda al problema. Una revisión lee el CLAUDE.md de la raíz de tu repositorio y los archivos CLAUDE.md de los directorios padre de cada archivo modificado. El CLAUDE.md de un subdirectorio se lee cuando el pull request modifica un archivo bajo esa ruta.

​
Usa REVIEW.md para reglas exclusivas de revisión

REVIEW.md es un archivo en la raíz de tu repositorio que adapta Code Review a tu repositorio. También puedes agregar un REVIEW.md en un subdirectorio para añadir comprobaciones a los cambios bajo esa ruta, además del archivo raíz. Los agentes que encuentran problemas y los agentes que los verifican reciben su contenido como las instrucciones de revisión de tu repositorio, junto con las pautas de revisión predeterminadas de Code Review. El paso que redacta la revisión final lo consulta antes de definir la severidad y escribir el resumen. Este diseño de ejemplo tiene un archivo raíz y un archivo en un subdirectorio:
Antes de depender de un archivo en un subdirectorio, protege tu rama predeterminada y consulta qué lee una revisión según la configuración de tus ramas.
El servicio Code Review y el comando local /code-review son dos herramientas distintas y leen archivos diferentes. El servicio lee tanto CLAUDE.md como REVIEW.md. El comando /code-review, que ejecutas dentro de una sesión de Claude Code en tu propia máquina, lee tus archivos CLAUDE.md pero no REVIEW.md. Coloca en CLAUDE.md las pautas que quieras aplicar en ambos lugares y reserva REVIEW.md para reglas específicas de la revisión de pull requests.

​
Ejemplo de REVIEW.md

Este REVIEW.md recalibra la severidad para un servicio de backend, limita los nits, omite los archivos generados y agrega comprobaciones específicas del repositorio.

​
Elige qué escribir en REVIEW.md

REVIEW.md es markdown de formato libre que cambia lo que una revisión encuentra y reporta. No cambia el formato de la revisión. Busca el problema que estás viendo y luego agrega una instrucción como la que se muestra. El ejemplo usa las cuatro primeras.
  • Se marcan como Important las cosas equivocadas: redefine qué significa 🔴 Important para tu repositorio. La calibración predeterminada apunta a código de producción, y un repositorio de documentación, un repositorio de configuración o un prototipo podrían necesitar una definición mucho más estrecha. Indica qué clases de hallazgos son Important y cuáles son, como mucho, Nit. También puedes escalar, por ejemplo, tratando cualquier infracción de CLAUDE.md como Important.
  • Demasiados nits: limita cuántos comentarios 🟡 Nit publica una sola revisión. Un límite como “reporta como máximo cinco nits” mantiene las revisiones accionables.
  • Comentarios sobre archivos generados o sobre lo que CI ya comprueba: enumera las rutas y categorías de hallazgos en las que Claude debe omitir hallazgos. Los candidatos habituales son el código generado, los lockfiles y las dependencias incluidas en el repositorio (vendored), junto con cualquier cosa que tu CI ya aplique, como el linting o la revisión ortográfica. Para rutas que merecen algo de revisión pero no un escrutinio completo, establece un umbral más alto: “en scripts/, reporta solo si es casi seguro y grave”.
  • No se comprueba una regla del equipo: agrega las reglas que quieras que se señalen en cada pull request, como “las nuevas rutas de API deben tener una prueba de integración”.
  • Hallazgos que resultan ser incorrectos: exige evidencia antes de que se publique una clase de hallazgo. Por ejemplo, “las afirmaciones sobre el comportamiento necesitan una cita file:line en el código fuente, no una inferencia a partir de los nombres” reduce los falsos positivos que, de lo contrario, le costarían al autor una ida y vuelta.
Algunas de estas instrucciones necesitan el archivo raíz en una rama predeterminada protegida. Limita REVIEW.md a instrucciones que cambien el comportamiento de la revisión y deja el contexto general del proyecto en CLAUDE.md.

​
Desde qué rama se lee REVIEW.md

Code Review lee REVIEW.md desde la rama base del pull request o desde la rama predeterminada, nunca desde los propios cambios del pull request. Para cambiar el comportamiento de la revisión, fusiona primero el cambio en REVIEW.md. Mantén REVIEW.md en tu rama predeterminada y protege esa rama. Cuando una revisión lee la copia de una rama predeterminada protegida, la primera fila de la tabla siguiente, respeta estas instrucciones del archivo raíz:
  • Reducir la severidad de un hallazgo
  • Excluir rutas, archivos o clases de problemas
  • Limitar los comentarios de tipo nit

​
Qué cuenta como protección de rama

Code Review considera protección los siguientes ajustes:
  • Rama predeterminada: una regla clásica de protección de rama o un ruleset
  • Cualquier otra rama: solo un ruleset
Un ruleset cuenta cuando restringe las actualizaciones o exige pull requests con al menos una aprobación. Si exige pull requests, también debe descartar esa aprobación ante un nuevo push o exigir que la aprobación llegue después del último push.

​
Qué lee una revisión según la configuración de ramas

Busca la situación de tu repositorio en la primera columna de la tabla siguiente. Si la ejecución de comprobación menciona REVIEW.md, consulta The check run mentions REVIEW.md.