Skip to main content
Una directiva de revisión te permite indicarle a Kody dónde concentrar su análisis más profundo en una revisión concreta. En lugar de cambiar la configuración, adjuntas una instrucción breve al lanzar la revisión — por ejemplo, “enfócate en la lógica de auth y sesión” — y Kody dedica su análisis más riguroso al código modificado que coincide.
Una directiva es efímera: se aplica solo a esa ejecución de revisión. No se guarda en tu configuración ni afecta a revisiones futuras. Para cambiar el comportamiento de Kody de forma permanente, usa Custom Prompts o Kody Rules.

​
Cuándo Usarla

  • Un PR toca muchos archivos pero te importa más un área de riesgo (auth, pagos, una migración).
  • Quieres que Kody rastree los callers y callees de un cambio específico y lo cuestione con más rigor.
  • Estás relanzando una revisión y quieres dirigir la atención sin editar ninguna configuración.

​
Prioridad, No Filtro

Esto es lo más importante de entender:
Una directiva establece prioridad, no un filtro. Kody prioriza el área de enfoque, pero sigue reportando cualquier bug, problema de seguridad o de rendimiento concreto que detecte en otras partes del diff. Nunca suprime hallazgos fuera del enfoque ni aprueba el resto del PR sin revisarlo.
Usa una directiva para decir “mira aquí con más atención” — no “mira solo aquí.”

​
Cómo Activarla

Escribe tu texto de enfoque justo después del comando de revisión en un comentario del pull request:
También puedes usar start-review y combinarlo con --force:
--force vuelve a ejecutar la review incluso cuando Kody normalmente la omitiría (“sin commits nuevos desde la última review”). Úsalo — con o sin directiva de enfoque — para obtener un nuevo análisis después de corregir lo que hizo fallar la ejecución anterior, o para aplicar configuraciones actualizadas a un PR ya revisado.
Solo se usa la primera línea después del comando como directiva. Todo lo que esté en líneas posteriores se ignora, así que mantén el enfoque en una sola línea.
Funciona en GitHub, GitLab, Azure DevOps, Bitbucket y Forgejo.

​
Heavy mode

Alpha — acceso bajo petición. El heavy mode no está activado para nadie por defecto. Para probarlo, pídenos que lo habilitemos en tu organización en Discord o en support@kodus.io. Hasta entonces la flag se acepta pero no tiene efecto — consulta Disponibilidad más abajo.
Una directiva de foco le dice a Kody dónde mirar con más atención. --heavy le dice que mire más tiempo: el finder ejecuta pasadas extra de crítico (“¿qué se te ha escapado?”) sobre el mismo diff, sacando más problemas reales a costa de una revisión más lenta y más candidatos que triar.
--heavy puede ir en cualquier posición de la línea — antes o después del texto de foco — y se elimina de la directiva en ambos casos, así que @kody review enfócate en la lógica de retry --heavy se enfoca en “enfócate en la lógica de retry”.
Para combinarlo con --force, pon --force primero. --force solo se reconoce inmediatamente después del comando, así que @kody review --force --heavy ejecuta una revisión heavy forzada, mientras que @kody review --heavy --force ejecuta una revisión heavy que no está forzada.
El guion es obligatorio: un heavy suelto se lee como texto de directiva, así que @kody review heavy flujo de checkout se enfoca en “heavy flujo de checkout” en vez de activar la flag.

​
Disponibilidad

El heavy mode es una función alpha. Solo se ejecuta para las organizaciones que habilitamos explícitamente:
La flag falla en silencio, no con error. Si tu organización no está habilitada, --heavy se acepta y la revisión se ejecuta con normalidad — sin error, sin aviso, sin resultado distinto. Si pediste acceso y no sabes si está activo, escríbenos en lugar de suponerlo.
Para solicitar acceso, escríbenos en Discord o a support@kodus.io con el nombre de tu organización.
Úsalo en los cambios donde que se escape algo sale caro — una migración, un cambio de auth, un flujo de pago — no por defecto. En los PRs del día a día los candidatos extra suelen ser ruido que tendrás que filtrar.

​
Cómo Escribir una Buena Directiva

  • Sé específico sobre el área, no sobre el veredicto. “enfócate en la concurrencia del consumidor de la cola” funciona mejor que “encuentra bugs”.
  • Nombra el código, no el resultado. Apunta a un módulo, flujo o preocupación (“la lógica de retry”, “el SQL en el servicio de reportes”).
  • Sé breve. Las directivas tienen un límite de 500 caracteres; solo se lee la primera línea del comentario.
  • @kody review enfócate en el flujo de autenticación y refresh de token
  • @kody review enfócate en el nuevo manejo del webhook de Stripe
  • kodus review --focus "condiciones de carrera en el worker en segundo plano"
  • @kody review por favor sé exhaustivo — no hay área que priorizar.
  • @kody review comenta solo en el archivo X — una directiva no es un filtro; usa rutas ignoradas para acotar archivos.

​
Notas y Límites

  • Longitud: las directivas se truncan en 500 caracteres.
  • Solo la primera línea: en comentarios de PR, solo la primera línea tras el comando se convierte en la directiva.
  • No confiable por diseño: como cualquiera que pueda comentar el PR puede aportar una directiva, el texto se sanea antes de usarse (se eliminan caracteres de control y los signos de menor/mayor). Esto no cambia tu enfoque — solo evita que el texto manipule el prompt interno de Kody.
  • No persistente: no se escribe nada en la configuración de tu repositorio u organización.