Validación antes de QA/merge
La validación no debe esperar al final. Antes de que un cambio llegue a QA o merge, el arnés debe comprobar que cumple la spec, respeta los guardarraíles y deja evidencias suficientes.
Papel del Reviewer
Sección titulada «Papel del Reviewer»El agente Reviewer revisa primero contra la spec. Su trabajo no sustituye a la revisión humana, pero reduce ruido y filtra problemas obvios antes de que una persona invierta criterio.
Debe comprobar:
- Si el cambio cumple criterios de aceptación.
- Si respeta el diseño técnico.
- Si se han considerado guardarraíles aplicables.
- Si hay cambios fuera de alcance.
- Si las evidencias son suficientes.
Revisión humana
Sección titulada «Revisión humana»La persona revisora se concentra en:
- Decisiones técnicas.
- Tradeoffs.
- Riesgos de producto.
- Responsabilidad final.
- Criterios que no se pueden automatizar.
La IA prepara una primera revisión; el humano decide.
Gates de calidad
Sección titulada «Gates de calidad»Un gate es un punto de control antes de avanzar en el ciclo.
Puede incluir:
- Build.
- Format.
- Lint.
- Tests unitarios o de componente.
- Tests end-to-end si aplica.
- Validación visual.
- Revisión de accesibilidad.
- Evidencias y logs estructurados.
La herramienta concreta depende del proyecto. La metodología se mantiene conceptual y adaptable.
Cuando algo falla
Sección titulada «Cuando algo falla»Un fallo debe clasificarse antes de seguir:
- Defecto introducido por el cambio.
- Ambigüedad de spec.
- Problema de entorno.
- Regla de arquitectura incumplida.
- Guardarraíl no contemplado.
El arnés debe convertir el fallo en aprendizaje: actualizar spec, contexto, skill, troubleshooting o regla de validación.
Qué se gana
Sección titulada «Qué se gana»- Menos defectos llegan a QA.
- La revisión humana es más eficiente.
- Los procedimientos manuales bajan.
- Los errores recurrentes se transforman en reglas.
- La velocidad aumenta porque hay menos retrabajo.
Default recomendado
Sección titulada «Default recomendado»Ningún cambio debería avanzar sin una revisión contra spec y una evidencia mínima de validación.