PTENES
MÓDULO 6.2 · PRÁCTICA

🏁 Ejercicio: ejecución, gates, revisión y entrega

Etapas 5 a 8. Con la preparación lista, ahora toca ejecutar el loop, pasar los gates, someter el cambio a un revisor independiente y entregar un pull request que se sostenga por sí solo.

6
Etapas
75
Minutos
Aplicado
Nivel
Práctico
Tipo
0%0 de 6
5

⌨️ Etapa 5 — Ejecuta la implementación

Ahora sí, el agente escribe código, dentro del loop que definiste y con el plan aprobado de antemano. Aprobar el plan cuesta dos minutos y evita rehacer una hora de implementación en la dirección equivocada.

🧪 Hazlo ahora — activar el loop

Objetivo: ejecutar la etapa 5 sin improvisar.

Leia, nesta ordem: AGENTS.md, docs/exercicio/spec.md, docs/exercicio/loop.md.
Siga o loop exatamente como está escrito.

Comece pelo passo 1: apresente o PLANO em no máximo 10 linhas
(o que vai mudar, em quais arquivos, e como cada critério de aceitação
será verificado) e PARE. Não escreva código antes da minha aprovação.

Lee el plan y responde estas tres preguntas: (1) ¿solo modifica los archivos previstos? (2) ¿cubre todos los criterios? (3) ¿inventó alguna abstracción que nadie pidió? Apruébalo o corrígelo. Después:

Plano aprovado <com ajustes: ...>. Prossiga com os passos 2 e 3 do loop.
Ao terminar: cole a saída REAL e completa de <comando de teste> e rode
"git diff --stat" para eu ver o tamanho da mudança.

Cómo verificar: revisa el --stat contra el límite del AGENTS.md y ejecuta tú mismo el comando de prueba. Nunca aceptes el resumen del agente como evidencia: ejecútalo.

⚠️ Atención

Si el ciclo llega al límite (3 intentos) o repite el mismo error dos veces, detente — tal como se acordó. Esto no es un fracaso del ejercicio: es el control funcionando. Anota en el registro lo que se intentó y decide tú el siguiente paso.

Plan primero

Tu aprobación

--stat

Revisa el tamaño

Ejecútalo tú

La prueba, de verdad

Detener

Es el control adecuado

6

🚦 Etapa 6 — Aplica los quality gates

Ejecuta la batería del módulo 3.3 sobre tu cambio. Aquí descubres qué puertas todavía no tiene tu repositorio — y esta lista es uno de los productos más valiosos del ejercicio.

🧪 Hazlo ahora — el paso por las puertas

<comando de build>     # ☐ passou
<comando de lint>      # ☐ passou
<comando de teste>     # ☐ passou · cole a saída no registro
git diff --stat        # ☐ dentro do limite de arquivos
git diff -- <pasta de testes>   # ☐ VAZIO (nenhum teste existente alterado)
git diff -- <arquivo de dependências>  # ☐ VAZIO (nenhuma dependência nova)
git log -p | grep -iE "senha|password|secret|token|api[_-]?key"  # ☐ nada

Cómo verificar: anota en el registro cuáles de estos gates ya son automáticos en tu CI y cuáles acabas de ejecutar manualmente. Cada verificación manual es un elemento del backlog: debería estar en el pipeline, no en tu memoria.

✓ Señal de una buena ejecución

  • ✓Diff dentro del límite acordado
  • ✓Pruebas existentes intactas; pruebas nuevas que cubren el nuevo comportamiento
  • ✓Cero dependencias agregadas
  • ✓Puedes explicar cada archivo modificado

✗ Señales de alerta en el diff

  • ✗Una prueba antigua «ajustada» junto con la corrección
  • ✗Excepción capturada y descartada en silencio
  • ✗Archivo de configuración modificado sin motivo aparente
  • ✗Abstracción nueva para un solo uso

Todos los gates

Sin excepción

Manual hoy

Automático mañana

Prueba intacta

Revisa con git diff

Explícalo todo

Archivo por archivo

7

🔍 Etapa 7 — Revisión independiente

Abre una sesión nueva, sin el historial de la implementación. Esta es la etapa que más sorprende a quienes hacen el ejercicio: el revisor encuentra cosas que quien implementó defendía con convicción diez minutos antes.

🧪 Hazlo ahora — el revisor

Você é o revisor independente. Não implementou nada disto e não deve confiar
em nenhuma afirmação de quem implementou.

Especificação: docs/exercicio/spec.md
Diff: <cole a saída de "git diff origin/<base>...HEAD">

Leia os arquivos relacionados antes de concluir e responda:
1. a mudança cumpre TODOS os critérios de aceitação? o que ficou faltando?
2. algo fora do escopo declarado foi alterado?
3. algum comportamento existente muda para quem consome?
4. o tratamento de erro cobre os casos previstos na spec?
5. os testes provam o comportamento novo ou apenas executam o código?
6. existe algo aqui que passa nos testes e ainda assim está errado?

Formato: no máximo 7 achados, cada um com
[bloqueante | importante | menor] · arquivo:linha · por que é problema · como verificar.
Se não houver bloqueante, diga isso explicitamente.

Cómo verificar: toma cada hallazgo bloqueante e intenta reproducirlo tú mismo. Corrige los que se sostienen —volviendo al ciclo, con las mismas reglas— y regístralo en el registro.md cuántos hallazgos eran reales. Esa tasa es tu medida de confianza en el revisor.

💡 Consejo práctico

La pregunta 6 («pasa las pruebas y aun así está mal») es la que más aporta. Haz esa pregunta en todas las revisiones de ahora en adelante: es el antídoto directo contra el defecto más peligroso de la ruta 4.

Sesión nueva

Contexto limpio

Spec + diff

Y nada más

Reproduce

Antes de corregir

Tasa real

Mide al revisor

8

📦 Etapa 8 — Prepara la entrega

Un PR con evidencia se revisa en minutos; un PR sin evidencia se aprueba sin leerlo, lo que es peor que no revisarlo, porque crea la ilusión de control.

🧪 Hazlo ahora — cuerpo del pull request

## O que muda
<2 a 3 linhas, em português, do ponto de vista de quem usa>

## Especificação
docs/exercicio/spec.md  (critérios de aceitação atendidos: <liste>)

## Fora do escopo (não foi alterado de propósito)
- <...>

## Evidência
<saída real do comando de teste — colada, não resumida>
git diff --stat: <n> arquivos, +<n> -<n>
gates: build ✓ · lint ✓ · testes ✓ · sem dependência nova ✓ · sem segredo ✓

## Revisão independente
<achados do revisor e o que foi feito com cada um>

## Risco e reversão
Risco: <baixo/médio> · Como reverter: <comando ou passo>

Cómo verificar: pídele a alguien del equipo que lea solo el cuerpo del PR (sin abrir el diff) y diga qué hace el cambio y cuál es el riesgo. Si puede hacerlo, la entrega está lista. Si no, falta evidencia o claridad, y es más rápido corregirlo ahora.

Evidencia

Pegada, no narrada

Fuera del alcance

También se declara

Reversión

En una línea

Prueba del lector

Sin abrir el diff

5

📊 Haz la retrospectiva del ejercicio

Cada intervención tuya durante el ejercicio puede convertirse en una rule, un gate o un elemento del AGENTS.md. Así es como el sistema mejora por sí solo en la próxima tarea, y eso es lo que diferencia a quien usa IA de quien construye con IA.

lo que corregí cada intervención tuya se convierte en RULE (se aplica en todas las tareas) se convierte en GATE (el CI lo impide) se convierte en un elemento de AGENTS.md → próxima tarea te exige menos

Cómo leer: este es el ciclo que hace que el método valga la pena. Cada vez que corriges al agente manualmente, pregúntate a cuál de las tres categorías corresponde. Si no corresponde a ninguna, probablemente era una decisión que solo una persona puede tomar; y eso también es información.

Verificación rápida: durante el ejercicio tuviste que recordarle al agente tres veces que no tocara las pruebas. ¿Qué hacer con eso?

Intervención

Se convierte en regla

Se repitió 3 veces

Automatiza

Falta un gate

Va al backlog

La próxima vez

Requiere menos de ti

6

🎒 Arma tu kit de entregables

Llegaste al final con artefactos, no con anotaciones. Reúne todo en un solo lugar: eso es lo que convierte dos días de workshop en un cambio permanente de práctica.

📦 Qué te llevas

✓ Modelo de especificación (T1)
✓ AGENTS.md con permisos y límites (T2)
✓ Modelo de loop con tres salidas (T2)
✓ Prompt para investigar un fallo de CI (T3)
✓ Prompt para una revisión independiente (T3)
✓ Checklist de quality gates (T3)
✓ Guía de modernización de código legado (T4)
✓ Auditoría de legibilidad del repositorio (T4)
✓ Búsqueda de duplicación semántica (T4)
✓ Playbooks: feature, bug, legado, incidente (T5)
✓ Esqueleto de skill y conjunto base de rules (T5)
✓ Checklist de gobernanza de una página (T5)

💡 Último consejo práctico

No intentes instalar los doce artefactos en el equipo de una sola vez. Empieza por dos: el AGENTS.md e o prompt de revisión independiente. Son los que dan resultados visibles en la primera semana, y los resultados visibles son lo que da espacio para los otros diez.

Artefacto

No la anotación

Con control de versiones

En el repositorio

Empieza con 2

No con doce

Resultado

Compra espacio

🏁 Fin del curso

La ingeniería de software con IA no elimina la ingeniería tradicional: aumenta la importancia de los fundamentos. Los modelos y las herramientas cambiarán rápido. El conocimiento duradero está en saber especificar, estructurar el contexto, crear harnesses, diseñar loops, automatizar, probar, revisar, controlar la arquitectura, limitar la autonomía, modernizar con seguridad, aplicar gobernanza y convertir las reglas en verificaciones ejecutables.

El profesional más valioso no será solo quien sepa pedirle código a la IA. Será quien sepa construir el sistema en el que la IA pueda trabajar con seguridad, calidad, velocidad y control.

✓
Ejecutaste el flujo completo - spec, harness, loop, implementación, gates, revisión y entrega.
✓
Con evidencia - y un registro que mide tu propia práctica.
✓
Con un kit - doce artefactos listos para el repositorio de tu equipo.