Instrucciones de revisión

Añadir instrucciones

1. Abre Configuración del espacio de trabajo → Instrucciones de revisión. Para un repositorio, abre Repositorios → (un repositorio) → Instrucciones de revisión.
2. Escribe texto sin formato o Markdown, hasta 12.000 caracteres.
3. Selecciona Guardar instrucciones del espacio de trabajo o Guardar instrucciones del repositorio.

• Las instrucciones del espacio de trabajo se aplican a todos los repositorios. Las instrucciones del repositorio se suman a ellas y prevalecen cuando se contradicen.
• En la página de un repositorio, Vista previa de las instrucciones combinadas muestra ambas en orden.
• Los cambios se aplican a las revisiones solicitadas después de guardar.
• Solo los administradores del espacio de trabajo pueden editar las instrucciones.
• No pongas contraseñas, tokens ni otros secretos en las instrucciones.

Qué va en las instrucciones

Las instrucciones contienen pautas que solo importan cuando HeyDeer revisa: qué priorizar, qué dejar tal cual, la terminología de tu equipo y cómo redactar los comentarios.

Pon las convenciones de código en AGENTS.md, para que los agentes de programación también las sigan. Si HeyDeer debe verificar un requisito en cada pull request al que se aplique, ponlo en una comprobación del repositorio.

Para guardar estas pautas en el repositorio, junto al código al que se refieren, usa REVIEW.md. Un pull request puede cambiar REVIEW.md, así que deja en las instrucciones lo que no debe poder cambiar.

Las instrucciones prevalecen sobre REVIEW.md, AGENTS.md y las skills, pero no pueden impedir que se ejecute una comprobación del repositorio. Consulta Cuando las pautas se contradicen.

Escribir instrucciones eficaces

Deja que HeyDeer revise algunos pull requests antes de escribir nada. Añade una instrucción cuando se repita un fallo o un comentario no deseado, unas pocas cada vez, y lee las siguientes revisiones para ver el efecto.

• Agrupa las instrucciones en unos pocos encabezados, como Prioridades, Dejar tal cual, Terminología y Comentarios.
• Escribe una instrucción por viñeta e indica las rutas, funciones y bibliotecas a las que se refiere.
• Añade el motivo cuando no sea obvio.
• Mantén las exclusiones concretas: “No comentes los archivos de scripts/one-off/”, no “No comentes los scripts”, que también oculta errores reales.
• Para definir cómo informa HeyDeer, usa la configuración: Idioma de la revisión, Alcance de los comentarios y Aprobación automática.

## Priorities

- Code under src/payments/ is high risk. Look hardest at retries,
  refunds and anything that could charge a customer twice.

## Leave alone

- Files under scripts/one-off/. They run once by hand and are deleted.
- Formatting. The formatter runs in CI.

## Terms

- A "workspace" is a customer account, not a folder on disk.

## Feedback

- Name the input that triggers a bug, and suggest the smallest fix.

Si parece que se ignora una instrucción, consulta Solución de problemas.