El reto
Elige un repositorio con tests y añade una mejora acotada: un filtro, un estado vacío, una validación o un comando pequeño. Debe poder completarse y revisarse en una sesión.
Fase 1: entender
No edites todavía. Traza el comportamiento actual, localiza patrones y tests, lee las instrucciones del repositorio y propón un plan de máximo cinco pasos con riesgos.
Fase 2: construir
Implementa el plan aprobado con el cambio mínimo. Añade o ajusta una prueba que proteja el comportamiento. Conserva cambios ajenos y sigue las convenciones existentes.
Fase 3: verificar
Ejecuta pruebas focalizadas, lint y build. Comprueba manualmente el flujo si hay interfaz. Revisa el diff y corrige cualquier regresión antes de resumir.
Rúbrica
- Alcance: el diff contiene solo la mejora solicitada.
- Corrección: la prueba protege el comportamiento y pasa.
- Calidad: el código encaja con el repositorio y no duplica soluciones.
- Seguridad: no aparecen secretos ni permisos innecesarios.
- Entrega: el resumen distingue hechos comprobados de riesgos pendientes.
Cierre
Termina con git status, diff, comandos ejecutados y una revisión propia. Solo entonces crea un commit con una idea clara. El objetivo no es generar más código, sino entregar un cambio que otro programador pueda confiar y mantener.
Entrega de la lección
Qué vas a construir
Una evidencia práctica para "Proyecto final: entrega un cambio completo" aplicada a un repositorio real o de entrenamiento.
Por qué es importante
El objetivo es convertir la idea de la lección en una acción verificable, no solo en una lectura.
Repositorio o archivos iniciales
Un repositorio pequeño con Git, README y un comando de validación conocido.
Pasos
- 1. Revisa el estado de Git antes de empezar.
- 2. Pide a Codex que trabaje con alcance limitado.
- 3. Ejecuta el comando de verificación.
- 4. Revisa el diff o la evidencia producida.
- 5. Anota qué queda comprobado y qué queda pendiente.
Encargo listo para Codex
Aplica la lección "Proyecto final: entrega un cambio completo" en este repositorio. Trabaja con cambios pequeños, cita archivos concretos, ejecuta una verificación y termina con resumen de evidencias y riesgos.
Resultado esperado
Una salida revisable: mapa, plan, diff, prueba o informe según el tipo de lección.
Comando de verificación
git status --short && git diff --stat
Comprobación manual
Comprueba que el resultado coincide con el alcance pedido y que Codex no ha tocado archivos ajenos.
Mini ejercicio
Repite la práctica en otra carpeta del mismo repositorio cambiando solo una restricción.
Ver solución
Mantén el mismo objetivo, añade una restricción explícita y compara si la evidencia final mejora.
Evidencia que debes guardar
Guarda el prompt usado, comandos ejecutados, salida relevante y git diff --stat.