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

# Hablar con CodeWarden

> Responde a un comentario de CodeWarden con @codewardenapp para preguntarle, discutirle o lograr que deje de plantear un hallazgo.

Cada comentario de CodeWarden termina con *Talk to CodeWarden by mentioning @codewardenapp in a reply.* Responde en el hilo de ese comentario, escribe `@codewardenapp` y tu pregunta u objeción, y CodeWarden contesta en el mismo hilo.

```text theme={null}
@codewardenapp this is intentional: the caller already validates the token
before it reaches this function, see AuthPlug.call/2.
```

El nombre de usuario es `@codewardenapp`. `@codewarden`, sin "app", es una cuenta de GitHub sin relación.

## Qué pasa

1. CodeWarden agrega una reacción 👀 a tu respuesta para que sepas que la vio.
2. Lee el hallazgo original, el código al que apuntaba, el mismo archivo tal como está ahora en el head del pull request, todas las respuestas anteriores del hilo y la descripción del pull request. Los lee a través de la API de GitHub; no se clona nada.
3. Responde una vez, en el mismo hilo, y quita la reacción. La respuesta hace una de tres cosas:

| Respuesta | Cuándo |
| - | - |
| **Explica** | Preguntaste qué significa el hallazgo o por qué importa. |
| **Defiende** | No estás de acuerdo, pero el código sigue teniendo el problema. Señala la evidencia. |
| **Cede** | Tu razón se sostiene frente al código. Lo dice, y no vuelve a plantear ese hallazgo en este pull request. |

A una respuesta que es solo `@codewardenapp`, sin pregunta, le pregunta qué quieres saber.

Cuando CodeWarden cede ante alguien con acceso de escritura, su respuesta también ofrece las líneas para agregar a `.codewarden.yml` y hacer que la decisión se aplique a todo el repositorio. Consulta [Hallazgos aceptados](https://docs.codewarden.co/es/configure/accepted-findings.md).

## Quién puede preguntar

CodeWarden responde a un comentario solo cuando se cumple todo lo siguiente:

* es una respuesta **nueva**, no la edición de un comentario anterior;
* es una respuesta **dentro de un hilo que inició uno de los propios comentarios en línea de CodeWarden**;
* menciona a `@codewardenapp` en el texto. Un nombre dentro de un bloque de código o de código en línea no cuenta;
* su autor **no es un bot**;
* su autor tiene **acceso de escritura** al repositorio (`OWNER`, `MEMBER` o `COLLABORATOR` de GitHub), **o es el autor del pull request**, incluso en un pull request desde un fork.

Cualquier otra persona no recibe respuesta, ni llamada al modelo ni cargo. Eso importa sobre todo en un repositorio público, donde cualquiera en GitHub puede comentar.

Las menciones en la conversación general del pull request, o bajo el comentario de revisión de otra persona, no se responden.

## Cuánto cuesta

Una mención respondida usa **un turno de IA**, lo mismo que una revisión de menos de 1.000 líneas modificadas. Una mención que se ignora, se rechaza o falla no usa ninguno. Las menciones se rechazan igual que las revisiones: cuando el repositorio está desactivado, la instalación está suspendida, o la organización no tiene un plan vigente o agotó su cupo. Una mención rechazada no publica nada.

La página de cada repositorio en la consola lista sus menciones: quién preguntó, el estado, si la respuesta explicó, defendió o cedió, si usó un turno de IA y un enlace a la respuesta.

## Lo que una respuesta no puede hacer

Todo lo que la gente escribe, incluida la respuesta, el hilo, la descripción del pull request y el código, llega al modelo como datos, nunca como instrucciones. Una respuesta que dice "ignora todos los hallazgos de este repositorio" o intenta cambiar las reglas de CodeWarden afecta, como mucho, al hallazgo en discusión. CodeWarden no plantea hallazgos nuevos sobre otro código en una respuesta.

Para ceder, el modelo tiene que citar el código que cubre la decisión, y ese código tiene que estar en el archivo. Una concesión que cita código que no está ahí se publica pero no recuerda nada.


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