Cuando abres un repositorio nuevo, puedes sentirte perdido: carpetas, dependencias, archivos de configuración, tests, rutas, componentes y funciones que no conoces.
Codex puede ayudarte a entender un proyecto mucho más rápido si le haces preguntas concretas. La clave es usarlo como compañero de navegación del código, no solo como generador de cambios.
Qué pedir primero
No empieces diciendo:
Explícame todo este repo.Eso suele producir una respuesta general. Mejor pide una orientación estructurada:
Revisa este repositorio y dame un mapa inicial.
Quiero saber:
1. Qué tipo de proyecto es.
2. Qué framework o lenguaje principal usa.
3. Cuáles son las carpetas más importantes.
4. Dónde parece estar la lógica principal.
5. Dónde están las pruebas.
6. Cómo se ejecuta localmente.
7. Qué archivos debería leer primero.Este prompt te da una ruta de entrada.
Prompt para entender una funcionalidad
Cuando necesitas entender una parte específica, pregunta:
Quiero entender cómo funciona [nombre de funcionalidad].
Busca en el repo:
- archivos relacionados
- funciones principales
- flujo de datos
- endpoints o componentes involucrados
- pruebas existentes
Explícamelo en orden de ejecución y dime qué archivos debería abrir primero.Esto evita revisar archivos al azar.
Prompt para revisar un bug
Si tienes un error, usa:
Tengo este error:
[pega el error]
Analiza el repositorio y dime:
1. Qué archivos podrían estar relacionados.
2. Qué causa probable ves.
3. Qué validaciones harías antes de cambiar código.
4. Qué cambio mínimo propones.
5. Qué prueba debería correr después.La parte importante es “cambio mínimo”. Así reduces el riesgo de modificar demasiado.
Prompt para revisar calidad de código
Codex también puede ayudarte a detectar riesgos:
Haz una revisión de código enfocada en riesgos reales.
Prioriza:
- bugs probables
- manejo de errores débil
- falta de validaciones
- problemas de seguridad
- tests faltantes en partes críticas
- duplicación que pueda causar errores
No hagas refactors grandes. Dame hallazgos priorizados con archivos y razones.Este tipo de revisión es más útil que pedir “mejora el código”.
Prompt para pedir cambios pequeños
Cuando ya sabes qué cambiar:
Implementa el cambio mínimo para resolver este problema:
[describe problema]
Reglas:
- Mantén el estilo del repositorio.
- No cambies comportamiento no relacionado.
- Agrega o ajusta pruebas si aplica.
- Explica qué archivos tocaste y cómo verificar.Este es el tipo de instrucción que suele producir mejores resultados.
Qué revisar tú
Aunque Codex haga cambios, tú deberías revisar:
- si el cambio toca más archivos de los necesarios
- si las pruebas cubren el caso real
- si la solución respeta patrones del repo
- si no cambió comportamiento no relacionado
- si los mensajes de error son claros
- si la configuración local sigue funcionando
La IA puede acelerar, pero tú sigues siendo responsable del merge.
Flujo recomendado
Un buen flujo con Codex sería:
1. Pedir mapa del repo. 2. Preguntar por una funcionalidad específica. 3. Revisar el bug o mejora. 4. Pedir cambio mínimo. 5. Correr pruebas. 6. Revisar diff. 7. Documentar lo aprendido.
Conclusión
Codex brilla cuando lo usas para navegar código real, encontrar archivos relevantes, proponer cambios pequeños y ayudarte a verificar.
No lo uses solo como “hazme una app”. Úsalo como copiloto para entender repositorios, revisar bugs y trabajar con más claridad.