> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dirigir una Revisión (Enfoque)

> Dirige la atención de Kody hacia un área específica del pull request con una directiva de revisión puntual, mediante comentario en el PR o CLI

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.

<Note>
  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](/es/how_to_use/code_review/configs/custom_prompts) o [Kody Rules](/es/how_to_use/code_review/configs/kody_rules).
</Note>

## 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:

<Warning>
  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.
</Warning>

Usa una directiva para decir *"mira aquí con más atención"* — no *"mira solo aquí."*

## Cómo Activarla

<Tabs>
  <Tab title="Comentario en PR / MR">
    Escribe tu texto de enfoque justo después del comando de revisión en un comentario del pull request:

    ```text theme={null}
    @kody review enfócate en la lógica de auth y sesión
    ```

    También puedes usar `start-review` y combinarlo con `--force`:

    ```text theme={null}
    @kody start-review enfócate en la nueva migración de base de datos
    @kody review --force enfócate en el manejo de errores del parser del webhook
    ```

    <Note>
      `--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.
    </Note>

    <Note>
      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.
    </Note>

    Funciona en GitHub, GitLab, Azure DevOps, Bitbucket y Forgejo.
  </Tab>

  <Tab title="CLI">
    Pasa la opción `--focus` al ejecutar una revisión:

    ```bash theme={null}
    kodus review --focus "la lógica de auth y sesión"
    ```

    Consulta la [referencia de comandos de la CLI](/es/how_to_use/cli/commands) para ver toda la superficie de comandos.
  </Tab>
</Tabs>

## Heavy mode

<Warning>
  **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](https://discord.gg/TFZBRk9fT6) o en [support@kodus.io](mailto:support@kodus.io).
  Hasta entonces la flag se acepta pero no tiene efecto — consulta
  [Disponibilidad](#disponibilidad) más abajo.
</Warning>

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.

```text theme={null}
@kody review --heavy
@kody review --heavy focus on the payment reconciliation logic
kodus review --heavy
```

`--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".

<Warning>
  **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.
</Warning>

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:

|                 | Estado                                                                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Cloud**       | Disponible bajo petición — movemos tu organización al release track `alpha`.                                                                           |
| **Self-hosted** | Aún no disponible. Las funciones alpha permanecen desactivadas con independencia de `BETA_FEATURES`; llegará al self-hosted cuando se promueva a beta. |

<Note>
  **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.
</Note>

Para solicitar acceso, escríbenos en [Discord](https://discord.gg/TFZBRk9fT6) o a
[support@kodus.io](mailto:support@kodus.io) con el nombre de tu organización.

<Tip>
  Ú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.
</Tip>

## 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.

<AccordionGroup>
  <Accordion title="Buenos ejemplos">
    - `@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"`
  </Accordion>

  <Accordion title="Ejemplos débiles">
    * `@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](/es/how_to_use/code_review/configs/general) para acotar archivos.
  </Accordion>
</AccordionGroup>

## 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.