ADR-006 — Revisión de PRs con un solo desarrollador¶
Status: accepted (2026-11-16, decisión del operador)
Contexto¶
La metodología del equipo pide que cada PR lo apruebe un desarrollador distinto del autor, y que
un merge sin aprobación (regla de urgencia) lleve la etiqueta revisar-después para que otro
desarrollador lo revise dentro de las 24 h. El equipo de BeneficiosCenter y GatewayQR es un solo
desarrollador (confirmado el 2026-11-16). Con eso, la aprobación de un segundo desarrollador no
puede ocurrir nunca: la regla de urgencia pasa a ser el camino de siempre y la etiqueta
revisar-después queda sin dueño. Los repositorios son privados en plan free, así que GitHub
tampoco aplica protección de rama.
Alternativas¶
- (A) Seguir mergeando por regla de urgencia y acumular etiquetas
revisar-después. - (B) Contratar o pedir un revisor externo para cada PR.
- (C) Revisión automática independiente de contexto fresco, más el check en verde como segunda revisión (elegida).
Decisión¶
Mientras el equipo sea de un solo desarrollador, la segunda revisión de cada PR es una revisión independiente de contexto fresco: un agente que solo ve el diff y el contexto del repositorio, sin la conversación en la que se escribió el código.
- Antes del merge: la revisión clasifica cada hallazgo como
blocker:,question:onit:. Losblocker:se resuelven antes de mergear; lasquestion:de negocio las responde el dueño del producto o el cliente, no el agente. - Check en verde: en BeneficiosCenter, el workflow
CIdel PR (backend con tests de integración contra SQL Server, más la consola). En GatewayQR, que no tiene CI,mvn testcon JDK 8 corrido localmente y su resultado en la descripción del PR. - Registro: el veredicto de la revisión queda en la descripción del PR o como comentario.
- Merge: lo hace el desarrollador (admin) con merge commit.
- Etiqueta
revisar-después: deja de usarse en el flujo normal. Solo se usa si un PR se mergea sin la revisión independiente (urgencia real), y se quita cuando esa revisión se hace. - Vuelta atrás: si se suma otro desarrollador, se vuelve a la aprobación humana de la metodología.
Consecuencias¶
- Los PRs no se bloquean por falta de un segundo desarrollador y cada merge tiene un segundo par de ojos registrado.
- Las etiquetas
revisar-despuésvuelven a significar algo: una revisión pendiente de verdad. - Un agente no reemplaza el criterio de negocio: las decisiones de producto siguen necesitando al dueño.
- GatewayQR depende de un check local hasta tener CI propio.
Plan de implementación¶
- Aplicar este ADR a todos los PRs de BeneficiosCenter y GatewayQR desde el 2026-11-16.
- GatewayQR: el README apunta a este ADR.
- Cerrar las etiquetas
revisar-despuésexistentes después de revisar esos PRs con este mecanismo.
Verificación¶
- Los PRs mergeados desde el 2026-11-16 tienen su revisión independiente registrada (pendiente).
- No quedan etiquetas
revisar-despuéssin una revisión pendiente real (pendiente).