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

# Categorías y gravedades de los comentarios

> Qué significa cada categoría y gravedad de un comentario de CodeWarden, y cómo afectan lo que se publica.

Cada comentario en línea lleva una categoría y una gravedad, mostradas como etiquetas en la parte superior del comentario y guardadas en un marcador oculto al final, que CodeWarden vuelve a leer cuando alguien responde.

## Categorías

| Categoría | Qué significa |
| - | - |
| `bug` | El código produce un resultado incorrecto, o falla con una entrada que realmente puede recibir. |
| `security` | Un agujero de seguridad: una brecha de autorización, una inyección, un secreto expuesto, etcétera. |
| `performance` | Código que no escalará, como una consulta N+1. |
| `logic` | Lógica que contradice lo que el código de alrededor claramente pretende, código que hace algo distinto de lo que la descripción del pull request dice específicamente, o una prueba que no puede fallar. |
| `acceptance` | Código que hace algo distinto de lo que dice el [ticket de Jira](https://docs.codewarden.co/es/integrations/jira.md) enlazado. Solo aparece cuando se leyó un ticket. |
| `fix` | Código que seguiría lanzando el error registrado en el [issue de Sentry](https://docs.codewarden.co/es/integrations/sentry.md) enlazado. Solo aparece cuando se leyó un issue. |

### Sobre "una prueba que no puede fallar"

Nunca se reportan pruebas faltantes. Sí se reporta, como `logic`, una prueba en el diff que seguiría pasando aunque se rompiera el comportamiento que nombra: por ejemplo una aserción sobre una colección que la prueba nunca llena, o una aserción cuyos dos lados son la misma expresión. El comentario dice qué entrada hace que pase mientras el código está roto.

## Gravedades

Una gravedad es `high`, `medium` o `low` (alta, media o baja): el juicio del propio modelo sobre qué tan grave es el defecto. Todo hallazgo sigue siendo un defecto; `low` nunca es una observación de estilo.

**La gravedad no decide qué se publica.** Se publican todas las gravedades. Los hallazgos se ordenan por gravedad y luego por la confianza del modelo, y el tope de comentarios de [`profile`](https://docs.codewarden.co/es/configure/codewarden-yml#profile) conserva la parte superior de esa lista. Un hallazgo `low` se publica solo cuando nada peor necesita el espacio.

Esto es deliberado. En un pull request, la misma consulta N+1 en la misma línea del mismo commit salió `medium` en tres ejecuciones y `low` en otras tres. Una etiqueta tan inestable no puede ser lo que decida si un defecto real te llega.

## Confianza

El modelo también da a cada hallazgo una confianza entre 0 y 1. Los hallazgos por debajo de **0,7** no se publican. La confianza de cada comentario, publicado o descartado, se muestra en la página de la revisión en la consola.

## Lo que nunca es un comentario

Estilo, nombres, formato, orden de imports, una prueba faltante, documentación faltante, una anotación de tipo faltante, sugerencias que empiezan con "considera" y cualquier cosa sobre código que no se le mostró al modelo. Se rechazan por diseño y no se pueden activar en `.codewarden.yml`.

## Reaccionar a un comentario

Reacciona con 👍 o 👎 a un comentario para decir si ayudó. La página de [mediciones](https://docs.codewarden.co/es/console/measurements.md) muestra cuántas reacciones 👎 recibieron los comentarios contados. Para discutir con un comentario, responde con `@codewardenapp`: consulta [Hablar con CodeWarden](https://docs.codewarden.co/es/bot/mentions.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.