⌨️ 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
🚦 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
🔍 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
📦 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
📊 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.
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
🎒 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
💡 Ú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.