PTENES
TRILHA 3

🔁 Flujo y calidad

Cómo se conectan los agentes con los eventos reales de ingeniería (issues, CI, PRs, incidentes), cómo funciona la revisión de código con IA sin convertirse en un sello de aprobación, y qué puertas determinan si un cambio puede avanzar.

3
Módulos
18
Temas
~2h30
Duración
Core
Nivel
0%0 de 18
Evento issue · CI · PR · incidente agente implementador pruebas deterministas agente revisor Quality Gates ¿Pasó todo? Entonces avanza

Cómo leer: un evento real activa el flujo (módulo 3.1). En el medio, en cian, quienes implementan y revisan son separados a propósito (3.2). A la derecha, los gates solo dejan pasar lo que cumple todas las condiciones (3.3).

Mapa de la ruta

Contenido detallado

3.1~50 min

⚡ Automatizaciones en el desarrollo

Eventos que activan agentes, integración con issues, repositorios y pipelines, corrección de fallas de CI, actualización de dependencias, análisis de incidentes y documentación.

Qué es:

Los acontecimientos reales del proceso que pueden activar trabajo automático: issue aprobada, falla de CI, dependencia vulnerable, PR abierto, caída de cobertura, cambio de API, incidente, error en producción.

Por qué aprender:

Una automatización sin un evento claro se convierte en un robot que funciona en vano. El disparador define el valor: cuanto más previsible sea el evento, más confiable será la automatización.

Conceptos clave:

Evento → clasificación → agente → validación → decisión → entrega · No todo evento merece automatizarse.

Qué es:

Conectar el agente con las herramientas donde ocurre el proceso —rastreador de issues, repositorio, CI/CD— en vez de crear un flujo paralelo en algún chat.

Por qué aprender:

Una automatización que vive fuera del flujo del equipo muere en dos semanas. Dentro del PR, se ve, se revisa y se exige.

Conceptos clave:

El PR es la superficie de revisión · Trazabilidad evento→cambio · Identidad propia del agente en los sistemas.

Qué es:

Una falla en el pipeline inicia una investigación automática: el agente lee el log, reproduce el problema localmente, propone una corrección y abre un PR con evidencia.

Por qué aprender:

Es el caso ideal para empezar: el activador es objetivo, el verificador ya existe (el propio CI) y el resultado es reversible.

Conceptos clave:

Verificador listo = automatización segura · Propuesta en un PR, nunca push directo · Una falla intermitente requiere diagnóstico, no un retry a ciegas.

Qué es:

Una dependencia vulnerable genera una propuesta de actualización, y el agente lee el changelog, ajusta el código que dejó de funcionar y lo demuestra con pruebas.

Por qué aprender:

Es un trabajo recurrente, tedioso y bien definido: exactamente el tipo de tarea que conviene automatizar primero.

Conceptos clave:

Un breaking change exige leer el changelog · Actualizar sin probar es una apuesta · Una dependencia por PR.

Qué es:

Un incidente genera un diagnóstico inicial automático: recopilación de logs, correlación temporal, cambios recientes sospechosos e hipótesis ordenadas.

Por qué aprender:

En los primeros minutos de un incidente, el cuello de botella es reunir información. Ahí la IA ayuda mucho, y aplicar una corrección por su cuenta es donde estorba.

Conceptos clave:

Diagnosticar es seguro; mitigar en producción, no · Preserva la evidencia antes de intervenir · Una hipótesis ordenada agiliza el trabajo humano.

Qué es:

El criterio para decidir: se automatiza lo que es frecuente, verificable y reversible; se requiere aprobación para lo que afecta producción, bases de datos, infraestructura, permisos y seguridad.

Por qué aprender:

Sin este límite explícito, la automatización crece hasta tocar algo que nadie quería que tocara, por lo general durante el fin de semana.

Conceptos clave:

No todas las tareas deben ser autónomas · La frecuencia × el riesgo deciden · La automatización también necesita un responsable.

Ver completo
3.2~50 min

🔍 Revisión de código con IA

Revisión asistida por agentes: análisis de diffs y del contexto del repositorio, separación entre quien implementa y quien revisa, revisión arquitectónica, seguridad y límites de la revisión automática.

Qué es:

Un agente revisor puede explorar archivos relacionados, verificar contratos, analizar pruebas, encontrar duplicaciones y comparar con los patrones del repositorio; no solo mirar las líneas modificadas.

Por qué aprender:

Los defectos costosos rara vez están en la línea modificada; están en su interacción con el resto del sistema.

Conceptos clave:

El diff es el comienzo, no el alcance · La duplicación semántica solo aparece al buscar · El estándar del repo es un criterio.

Qué es:

El flujo recomendado: agente implementador → pruebas deterministas → agente revisor independiente → análisis de seguridad → quality gates → revisión humana.

Por qué aprender:

El agente que revisa no debe depender de las conclusiones de quien implementó; la separación reduce el riesgo de que ambos repitan la misma suposición incorrecta.

Conceptos clave:

Independencia > capacidad · El revisor recibe la spec + diff, no el razonamiento del autor · Contexto limpio por revisión.

Qué es:

La verificación de que el cambio respeta los límites entre módulos, no crea dependencias indebidas, no duplica capacidades existentes ni atraviesa capas.

Por qué aprender:

Es el tipo de defecto que ninguna prueba detecta y que sale caro seis meses después.

Conceptos clave:

Una violación de límites es un hallazgo de revisión · La duplicación semántica > la duplicación textual · Una regla arquitectónica puede convertirse en una prueba.

Qué es:

La revisión explícita de fallos de seguridad, impacto en el rendimiento y costo del mantenimiento futuro, cada uno con su propia lista.

Por qué aprender:

Un revisor genérico («revisa este PR») encuentra cuestiones de estilo. Un revisor con un enfoque definido encuentra lo que duele.

Conceptos clave:

Una lente por pasada · Un secreto expuesto y una inyección son bloqueantes, no sugerencias · El mantenimiento es un costo futuro real.

Qué es:

Lo que el revisor automático no ve: intención de negocio, contexto histórico, acuerdos no escritos — además de su tendencia a generar muchos comentarios de poco valor.

Por qué aprender:

Un revisor que comenta treinta nimiedades por PR entrena al equipo para ignorar las revisiones, incluso las buenas.

Conceptos clave:

Precisión > recall en la revisión · Un hallazgo sin severidad es ruido · Los falsos positivos cuestan confianza.

Qué es:

La revisión humana centrada en lo que solo ella decide: intención, prioridad, riesgo de negocio y aceptación de las consecuencias.

Por qué aprender:

La IA filtra y prepara; la responsabilidad sigue siendo de quien aprueba. No es una formalidad: es lo que mantiene a alguien pensando en el problema.

Conceptos clave:

La responsabilidad no se delega · Una persona revisa la intención, la máquina revisa la forma · Un PR pequeño se puede revisar de verdad.

Ver completo
3.3~50 min

🚦 Quality Gates

Las condiciones obligatorias antes de que un cambio avance: build, lint, pruebas, cobertura, análisis estático, seguridad, compatibilidad, rendimiento y aprobación.

Qué es:

El principio central: una regla escrita en texto es útil; esa misma regla convertida en una prueba automática es mucho más confiable.

Por qué aprender:

Con IA generando volumen, las reglas que dependen de que alguien las recuerde dejan de funcionar durante la primera semana ajetreada.

Conceptos clave:

Gate = condición obligatoria, no recomendación · Automático > disciplina · El código solo avanza si pasa.

Qué es:

Las tres primeras puertas: compila, sigue el patrón y pasan las pruebas unitarias y de integración.

Por qué aprender:

Son los gates que el agente puede usar por sí solo dentro del loop: cuanto más rápidos, más útil el ciclo de corrección automática.

Conceptos clave:

La prueba lenta no entra en el loop · La prueba inestable destruye la confianza · El lint automático elimina las discusiones sobre estilo.

Qué es:

Pruebas que fijan el contrato con quienes consumen tu API, más un mínimo de cobertura que impide que disminuya.

Por qué aprender:

Cuando aumenta el volumen de cambios, el contrato es la primera víctima silenciosa, y quien descubre la ruptura es el cliente.

Conceptos clave:

La cobertura es un piso, no una meta · Preservar el contrato es un requisito · La caída de cobertura bloquea el merge.

Qué es:

Verificación automática de vulnerabilidades críticas, secretos en commits, dependencias con CVE y patrones de código peligrosos.

Por qué aprender:

Son hallazgos objetivos y de alto costo: el tipo perfecto de regla para convertirse en bloqueo automático, sin depender de un revisor atento.

Conceptos clave:

Nunca guardes secretos en el repositorio · Una vulnerabilidad crítica bloquea · El ruido del scanner debe calibrarse.

Qué es:

Gates de rendimiento dentro de un límite acordado y el requisito de que toda migración tenga una ruta de rollback probada.

Por qué aprender:

La degradación aparece poco a poco, cambio tras cambio; y una migración irreversible es lo que transforma un error pequeño en un incidente prolongado.

Conceptos clave:

Presupuesto de rendimiento explícito · La migración reversible es un gate · Un rollback no probado no existe.

Qué es:

El pipeline completo: build → lint → pruebas → cobertura → análisis estático → seguridad → revisión → aprobación → deploy. El código solo avanza cuando se cumplen todos los gates obligatorios.

Por qué aprender:

Un gate que se puede omitir «solo esta vez» no es un gate: es una sugerencia. Y la excepción se convierte en regla en dos semanas.

Conceptos clave:

Obligatorio significa obligatorio · Excepción registrada y con plazo · La barrera protege al equipo, no lo obstaculiza.

Ver completo
← Ruta 2: Harness & Loop Ruta 4: Arquitectura →