Codex para desarrollo
Incorpora Codex a tu flujo de desarrollo: prepara el entorno y el contexto, implementa y depura, revisa cambios y coordina tareas con Git y worktrees.
Encuentra tu punto de partida
Encaja cuando ya trabajáis con código y Git y queréis utilizar Codex para explorar, implementar, depurar y coordinar tareas dentro de un flujo de desarrollo revisable.
- Duración y sesiones
- 12 horas en directo · 6 sesiones de 2 h.
- Tamaño del grupo
- Hasta 12 participantes por formador como referencia, ajustable según la práctica y el feedback.
Qué aprenderás
- 01
Elegir un entorno de Codex y preparar contexto e instrucciones en AGENTS.md para una tarea de desarrollo.
- 02
Implementar y depurar cambios con Git/GitHub, revisando el diff y las pruebas frente a criterios de aceptación.
- 03
Separar tareas con worktrees, coordinar trabajo paralelo y resolver un reto nuevo con comprobaciones reproducibles.
Una propuesta de trabajo
Recorreréis las formas de trabajar con Codex y practicaréis principalmente en un entorno preparado por The Optimal Flow. Usaréis el repositorio Faro como contexto común para explorar código, añadir una funcionalidad, corregir un fallo y coordinar trabajos independientes. Aprenderéis a dar instrucciones con AGENTS.md, revisar cambios con Git/GitHub y organizar tareas en worktrees antes de resolver un reto nuevo.
Adaptamos la selección y la profundidad de los módulos al punto de partida y los objetivos del grupo.
01Entorno y contexto
App, IDE y CLI; configuración, controles, AGENTS.md y selección del contexto útil.
Trabajarás en
- Comparar app, IDE y CLI, elegir un entorno principal y reconocer sus controles de ejecución.
- Preparar AGENTS.md con convenciones, comandos y criterios; seleccionar archivos y contexto para cada tarea.
- Explorar el repositorio con Codex y comprobar que las instrucciones se aplican en una segunda tarea.
- Práctica
- Preparar el entorno y las instrucciones de Faro; pedir un mapa del proyecto y un plan para una tarea acotada.
- Cómo lo comprobarás
- Un entorno listo, un AGENTS.md breve y una tarea con contexto y criterios verificables.
02Desarrollar y revisar
Exploración, implementación, depuración, pruebas y revisión de cambios con Git/GitHub.
Trabajarás en
- Implementar un filtro por estado y diagnosticar el fallo que acepta asuntos formados solo por espacios.
- Preparar una regresión que falle antes de la corrección y revisar los casos relevantes con Vitest y Playwright.
- Leer el diff, organizar ramas y commits y preparar una PR de práctica con resultados y límites.
- Práctica
- Añadir el filtro y corregir la validación; revisar la propuesta en Git/GitHub y explicar qué comportamiento demuestra cada prueba.
- Cómo lo comprobarás
- Cambios acotados y una revisión que relaciona los criterios, el código y las comprobaciones.
03Coordinar y entregar
Worktrees, tareas independientes en paralelo, integración y entrega de un reto nuevo.
Trabajarás en
- Separar dos tareas que no comparten archivos y asignarlas a worktrees distintos con instrucciones concretas.
- Comparar las entregas, integrar de forma secuencial y repetir las comprobaciones del conjunto.
- Resolver individualmente un reto nuevo, eligiendo el entorno, el contexto y la forma de organizar el trabajo.
- Práctica
- Ensayar en paralelo una mejora de documentación y otra de pruebas independientes; después añadir un contador de solicitudes visibles como reto final.
- Cómo lo comprobarás
- Una integración revisada y una entrega individual con diff, comandos, resultados y decisiones explicadas.
Un repositorio, varias formas de trabajar con Codex
Ejemplo docente
Practicarás con varios retos de un repositorio preparado: una funcionalidad, una corrección y tareas independientes en worktrees. Terminarás resolviendo una tarea nueva y explicando los cambios y sus comprobaciones.
Caso ficticio de aula. Faro es un gestor de solicitudes con código y pruebas preparados. El equipo quiere filtrar la lista, mejorar una validación y dejar instrucciones útiles para continuar el trabajo.
- Punto de partida
- Las tareas llegan sin una pauta compartida. Quien revisa necesita conocer los criterios del cambio, cómo comprobarlo y qué trabajos se pueden separar.
- Primera propuesta
- El grupo prepara AGENTS.md, explora los archivos y trabaja el filtro y la corrección de espacios. Después separa una mejora de documentación y otra de pruebas en worktrees distintos.
- Qué revisamos
- El docente revisa si cada tarea tiene contexto y archivos delimitados, si el paralelismo evita solapamientos y si la integración conserva el filtro Todas al iniciar. El grupo contrasta también la regresión y el resultado conjunto.
- Resultado
- La entrega reúne instrucciones reutilizables, cambios revisados y comprobaciones repetibles. Cada persona resuelve después un contador de solicitudes visibles y explica por qué ha elegido ese flujo de trabajo.
Del contexto a una entrega propia
Preparar
Entorno elegido
App, IDE o CLI; práctica en uno
AGENTS.md
Convenciones y comandos del proyecto
Desarrollar
Funcionalidad y corrección
Filtro y validación con pruebas
Git y GitHub
Diff, commits y revisión
Coordinar
Worktrees
Tareas independientes e integración
Reto nuevo
Contador, pruebas y explicación
Representación didáctica de las prácticas en un repositorio preparado; cada cambio se revisa y comprueba en el entorno de aula.
Antes de darlo por terminado
- AGENTS.md recoge convenciones y comandos útiles, y la tarea aporta los criterios específicos.
- Las tareas paralelas se aíslan y su integración pasa las comprobaciones del conjunto.
- El reto individual funciona y su entrega permite repetir las pruebas y entender las decisiones.
Sesiones para llevarlo a la práctica.
Edición de referencia: 12 horas en directo, en 6 sesiones de 2 horas. Incluye entorno y contexto, desarrollo y depuración, Git/GitHub, worktrees y un reto final. Las prácticas y su revisión se realizan durante las sesiones.
- Sesión 12 h
Elegir y preparar el entorno
Conocer app, IDE y CLI; practicar configuración, controles y primer recorrido por el repositorio en un entorno principal.
Al terminarUn entorno de práctica listo y un mapa breve del repositorio.
- Sesión 22 h
Dar contexto e instrucciones
Preparar AGENTS.md, seleccionar archivos y definir criterios; comprobar cómo cambia la respuesta cuando el contexto es suficiente.
Al terminarInstrucciones reutilizables y una tarea bien delimitada.
- Sesión 32 h
Implementar y depurar
Añadir una funcionalidad pequeña y corregir un fallo con su regresión; utilizar Faro como hilo conductor de las dos prácticas.
Al terminarUn filtro y una corrección vinculados a pruebas de comportamiento.
- Sesión 42 h
Revisar con Git y GitHub
Trabajar con ramas, diffs, commits y PR de práctica; contrastar el cambio y atender hallazgos de revisión.
Al terminarUna propuesta de cambio con comprobaciones reproducibles.
- Sesión 52 h
Coordinar tareas en worktrees
Separar documentación y pruebas independientes, ejecutar en paralelo y revisar la integración; reconocer cuándo conviene secuenciar.
Al terminarDos tareas aisladas y un resultado conjunto comprobado.
- Sesión 62 h
Resolver un reto nuevo y entregar
Añadir un contador de solicitudes visibles, elegir el flujo de trabajo y revisar código y comprobaciones con feedback.
Al terminarUna entrega individual revisable con diff, pruebas y decisiones explicadas.
Bloques avanzados para ir más allá.
Podemos incorporarlos a vuestra formación si el equipo necesita profundizar.
Conectar herramientas con MCP y hooks
Incorporar fuentes y automatizar pasos repetidos del equipo dentro del flujo con Codex.
Flujos de entrega de mayor alcance
Profundizar en backend, migraciones o integración continua con objetivos y comprobaciones específicos.
Acordamos la selección, la profundidad y la dedicación al preparar vuestra propuesta.
Con guía, práctica y acompañamiento.
Cada edición incluye materiales de trabajo, feedback sobre la práctica y evaluación según los objetivos acordados.
Materiales que podéis conservar
Guía, ejercicios y criterios de revisión descargables y versionados, para uso interno.
Para preparar y cerrar la edición
Recomendación breve, kit editable de comunicación e informe de aprendizaje del grupo.
Diploma propio de The Optimal Flow
De aprovechamiento, al superar la evaluación acordada.
Un mes de soporte por correo
Sobre lo trabajado en clase, hasta dos horas acumuladas para todo el grupo.
