Saltar a contenido

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: o nit:. Los blocker: se resuelven antes de mergear; las question: de negocio las responde el dueño del producto o el cliente, no el agente.
  • Check en verde: en BeneficiosCenter, el workflow CI del PR (backend con tests de integración contra SQL Server, más la consola). En GatewayQR, que no tiene CI, mvn test con 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és vuelven 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és existentes 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és sin una revisión pendiente real (pendiente).