Implantación en tu equipo

Etapas

1. Pruébalo en unos pocos pull requests. Un espacio de trabajo nuevo empieza con “Solo manual”. Comenta @heydeer review en varios pull requests recientes de distintos tipos y compara los hallazgos con los de tus revisores.
2. Cubre las carencias que viste. Añade solo lo que esas revisiones demostraron que necesitas: convenciones, reglas que siempre deben cumplirse y prioridades. Consulta Dónde va cada regla.
3. Activa las revisiones automáticas. Empieza con “Una vez por PR” en uno o dos repositorios, luego pasa a “En cada push” con un “Máximo de revisiones automáticas por PR” y configura la frecuencia de la organización. Consulta Revisiones automáticas.
4. Publica la comprobación sin que bloquee. De forma predeterminada, la comprobación HeyDeer Review pasa aunque la revisión encuentre problemas. Déjalo así mientras el equipo se acostumbra a los hallazgos.
5. Exige la comprobación cuando el equipo confíe en ella. Haz que HeyDeer Review sea una comprobación obligatoria en tus reglas de rama de GitHub y luego activa “Marcar la comprobación como fallida si se detectan problemas”. A partir de entonces, una versión que no se revise automáticamente esperará a @heydeer review. Consulta La comprobación HeyDeer Review.
6. Decide sobre la aprobación automática. Está desactivada de forma predeterminada. Si la activas, empieza con “Solo cambios sencillos” y descarta las aprobaciones obsoletas en tus reglas de rama. Consulta Aprobación automática.
7. Configura las notificaciones y el control de gastos. Añade un correo del espacio de trabajo para los avisos de créditos y de la prueba, y activa la recarga automática con un límite de uso. Consulta Notificaciones y Recarga automática y límites de uso.
8. Explica al equipo cómo trabajar con HeyDeer. Comparte los comandos en comentarios de PR, cómo descartar un hallazgo con una respuesta y cómo escribir pull requests fáciles de revisar.

Lista de comprobación

• Se revisaron algunos pull requests reales con “Solo manual”
• Se añadieron AGENTS.md, comprobaciones o instrucciones para lo que esas revisiones pasaron por alto
• Se marcaron los archivos generados y se filtraron los pull requests de bots
• Se activó “Una vez por PR” y luego “En cada push” con un límite de revisiones
• Se publicó la comprobación HeyDeer Review sin que falle por problemas
• Se decidió si exigir la comprobación y hacer que falle por problemas
• Se decidió sobre la aprobación automática
• Se configuraron un correo de notificaciones, la recarga automática y un límite de uso
• Se compartieron los comandos y cómo descartar un hallazgo

Al cabo de unas semanas, vuelve a leer las revisiones recientes, mueve las reglas mal ubicadas y elimina las que no cambian nada.