La brecha entre lo que dice un PR y lo que hace
Tu equipo mergea 50 PRs a la semana. ¿Cuántos alguien realmente leyó línea por línea? La respuesta es incómoda. Y la brecha entre lo que los PRs afirman y lo que el código realmente hace es donde los bugs llegan a producción.
La anatomía de un cambio perdido
Un PR dice "Fix login timeout." El diff muestra un cambio de timeout en el servicio de auth. Se ve bien, aprobado. Pero enterrado en la línea 247 de un diff de 300 líneas, también hay un cambio en la duración de sesión de 24 horas a 7 días. Nadie lo mencionó. Nadie lo detectó.
Esto no es malicioso. El desarrollador arregló el timeout y, ya que estaba en el archivo, ajustó la duración de sesión también. Olvidó mencionarlo en la descripción. El reviewer vio "Fix login timeout" y se enfocó en la lógica del timeout. Ambos humanos hicieron su trabajo — y un cambio llegó a producción sin documentar.
Con escala, empeora
Equipos pequeños con 5 PRs a la semana pueden detectar esto manualmente. Con 50 PRs a la semana, nadie lee cada línea. Con 200 PRs — común en equipos usando agentes de IA — la matemática es imposible.
Cada PR que llega a producción con cambios no documentados es una futura sesión de debugging. "¿Cuándo cambió la duración de sesión?" "¿Por qué hay esta nueva dependencia en nuestro lock file?" "¿Quién agregó esta variable de entorno?" Las respuestas están enterradas en el PR #847 de hace tres semanas.
Cómo se ven los cambios no documentados
Hemos analizado miles de PRs. Los cambios no documentados más comunes caen en categorías predecibles:
Cerrando la brecha
La solución no es "escribir mejores descripciones" — los humanos siempre olvidarán cosas, y los agentes de IA siempre serán confidentemente incompletos. La solución es verificación automatizada.
Vigil lee cada descripción de PR, extrae las afirmaciones, verifica cada una contra el diff, y detecta todo lo que la descripción no mencionó. Se ejecuta en cada PR automáticamente — sin config, sin paso manual, sin memoria humana requerida.
La brecha entre lo que dice un PR y lo que hace no tiene que ser un misterio. Puede ser un reporte.