Equipos con revisores humanos

De qué se encarga HeyDeer

• Detalles y casos límite. En cada pull request, HeyDeer comprueba el manejo de errores, los valores límite, la concurrencia y los llamadores que rompe un cambio.
• Menos carga para los revisores. Los revisores ya no tienen que repasar cada línea en busca de errores, y reservan su tiempo y su atención para las decisiones que solo ellos pueden tomar.
• Precisión en los detalles. En 1000 pull requests internos, HeyDeer evaluó si los detalles del código eran correctos con más precisión que los revisores humanos.

Configuración recomendada

1. Haz que HeyDeer revise cada push. En Configuración del espacio de trabajo → Reglas de revisión, establece “Frecuencia de revisión” en “En cada push”. Consulta Revisiones automáticas.
2. Haz que la comprobación falle si hay problemas. En Publicar resultados, activa “Marcar la comprobación como fallida si se detectan problemas”. Consulta La comprobación HeyDeer Review.
3. Exige la comprobación en GitHub. En las reglas de rama de main, activa Require status checks to pass before merging y añade HeyDeer Review. Así, un pull request solo se fusiona cuando sus hallazgos se han corregido o descartado.
4. Empieza la revisión humana a partir del resultado de HeyDeer. Pide a los revisores que se ocupen de un pull request cuando su comprobación se haya superado, y que dediquen su tiempo al diseño, al comportamiento del producto y a todo lo que HeyDeer deje en manos de una persona.

Opcional: aprobar automáticamente los cambios rutinarios

Activa Aprobación automática y deja “Cambios que requieren aprobación humana” en “Cambios importantes de arquitectura y comportamiento clave”. Así, HeyDeer aprueba los pull requests rutinarios cuando no queda ningún problema y deja los cambios importantes a una persona, indicando qué decisión requiere su intervención.

Con 1 aprobación requerida en tus reglas de rama, los pull requests rutinarios pueden fusionarse sin esperar a un revisor. Activa Dismiss stale pull request approvals when new commits are pushed para que cada aprobación cubra el código más reciente.

Escribir tus estándares como comprobaciones

Si tus revisores repiten una regla una y otra vez en los comentarios, esa regla debe ir en una comprobación. Añade un archivo Markdown a .agents/checks/ por cada regla, y HeyDeer la aplicará a cada pull request que modifique los archivos coincidentes. Consulta Comprobaciones del repositorio.

.agents/checks/migrations.md

---
files: "migrations/**/*.sql"
---
The previous release keeps running while a migration
deploys. Report a migration that:

- drops or renames a table or column that code on the
  base branch still uses;
- adds a NOT NULL column without a default;
- creates an index on an existing table without
  CONCURRENTLY.