Empieza por preguntas, no por cambios
En un repositorio desconocido, la primera tarea debe reducir incertidumbre. Pide rutas, símbolos y comandos concretos para poder comprobar cada afirmación.
Analiza este repositorio sin editar archivos. Identifica: 1. punto de entrada 2. módulos principales 3. flujo de una petición 4. pruebas y comandos de validación 5. tres riesgos técnicos Cita archivos y líneas.
Sigue un flujo real
Una lista de carpetas no explica un sistema. Elige un comportamiento visible y pide a Codex que siga el recorrido desde la interfaz o endpoint hasta datos, efectos secundarios y tests.
- ¿Dónde se valida la entrada?
- ¿Qué contrato une los módulos?
- ¿Dónde se transforma o persiste el dato?
- ¿Qué prueba fallaría si cambia este comportamiento?
Repos grandes, monorepos y multi-repo
En un monorepo no pidas «entiende todo». Pide primero el mapa de workspaces, paquetes, comandos y dependencias internas. Después baja a una ruta concreta y exige que Codex diga qué no ha inspeccionado.
Analiza este monorepo sin editar. Devuelve: - workspaces o paquetes detectados - comando para instalar y probar cada paquete relevante - dependencias internas del paquete que voy a tocar - límites de lo que no has leído Después céntrate solo en packages/web.
Si la tarea cruza varios repositorios, trabaja por contratos: API, eventos, esquema, paquete publicado o documentación versionada. No dejes que Codex parchee dos repos a la vez sin una verificación independiente en cada uno.
Haz que enseñe evidencia
Pide que diferencie hechos observados de inferencias. Si falta una prueba, que lo diga. Esa disciplina reduce respuestas plausibles pero incorrectas.
Ejercicio
Escoge una funcionalidad pequeña, obtén su mapa y verifica manualmente dos referencias. Guarda el resumen en tus notas, no dentro del repositorio salvo que el equipo quiera documentación nueva.
Entrega de la lección
Qué vas a construir
Una evidencia práctica para "Explora un repositorio sin perderte" 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 "Explora un repositorio sin perderte" 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 «Pide cambios que se puedan verificar». Si no, repite la comprobación antes de avanzar.