La anatomía de un buen encargo
- Objetivo: qué comportamiento debe cambiar para el usuario.
- Contexto: dónde ocurre y qué patrón existente debe seguir.
- Límites: archivos, compatibilidad, seguridad y cosas que no debe tocar.
- Verificación: tests, build y comprobación visual esperados.
Añade búsqueda por título al catálogo. Reutiliza el estilo y los datos actuales. No añadas dependencias ni cambies las URLs. Incluye estado sin resultados, navegación con teclado y una prueba. Ejecuta lint, tests y build; resume los archivos modificados.
Casos límite desde el encargo
Si no nombras los casos límite, el agente tenderá a optimizar el camino feliz. Añade dos o tres bordes relevantes: datos vacíos, permisos, móvil, errores de red, idioma, accesibilidad, concurrencia o migraciones.
Casos límite obligatorios: - catálogo vacío: muestra estado claro - búsqueda con tildes y mayúsculas: debe encontrar resultados - móvil estrecho: el input no tapa las tarjetas - sin JavaScript durante carga: no romper navegación básica
Divide por riesgo
Una tarea pequeña puede ejecutarse directamente. Para una migración o cambio transversal, pide primero análisis y plan, revisa las decisiones y después autoriza la implementación.
Corrige el rumbo con precisión
Evita «no me gusta». Señala el comportamiento observado, el esperado y una referencia del proyecto: «El filtro reinicia el scroll; conserva la posición como hace la lista de favoritos».
Definición de terminado
Una respuesta convincente no basta. La tarea termina cuando el cambio está acotado, las verificaciones pasan y Codex explica cualquier riesgo o prueba que no pudo ejecutar.
Entrega de la lección
Qué vas a construir
Una evidencia práctica para "Pide cambios que se puedan verificar" 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 "Pide cambios que se puedan verificar" 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.
Fuentes oficiales y versión probada
Si has guardado la evidencia de esta lección, continúa con «Enseña el repositorio con AGENTS.md». Si no, repite la comprobación antes de avanzar.