Referencias Oficiales: Best Practices · Review · Worktrees · Automations
Por qué importa un manual operativo
Conseguir un buen resultado puntual con Codex es posible. Mantener calidad estable durante semanas es otro problema.
La brecha suele ser de ritmo operativo, no de capacidad del modelo.
Modelo operativo en una tabla
| Horizonte | Objetivo | Artefacto principal | Owner |
|---|---|---|---|
| Diario | estabilidad de lanes | evidence snapshot | owner del lane |
| Semanal | entregar alcance revisable | merge packet | owner de review/release |
| Ventana release | proteger producción | release decision record | owner final de decisión |
| Ventana incidente | recuperar con previsibilidad | rollback + incident note | on-call + owner de escalación |
Si falta una fila, baja la confiabilidad.
Contrato de lane (obligatorio)
Todo handoff debe incluir:
- estado de objetivo
- evidencia
- alcance de diff
- nota de riesgo
- siguiente owner
Sin excepciones en trabajo de equipo.
Cadencia diaria (estructura de 15 minutos)
Inicio
- confirmar owner del lane
- confirmar blocker principal
- confirmar objetivo de verificación del día
Checkpoint intermedio
- adjuntar salida de comandos fresca
- confirmar ausencia de scope drift
- marcar bloqueos temprano
Snapshot de cierre
- done/partial/blocked
- salida de comandos
- directorios cambiados
- riesgos residuales
- siguiente owner
Cadencia corta > reportes largos.
Pipeline semanal de merge
- congelar alcance
- ejecutar lanes + snapshots diarios
- rerun del lane verifier
- review branch-vs-base
- registrar decisión de merge
Si siempre está "casi listo", el scope freeze es débil.
Bundle de artefactos recomendado
Para cada candidato a merge:
- resumen de implementación
- resumen de verificación
- merge packet
- rollback note
- borrador de comunicación de release
Este bundle define velocidad de recuperación cuando hay incidentes.
Métricas útiles
- review lead time
- tasa de retrabajo post-review
- blocker age
- frecuencia de rollback
- cumplimiento de frescura de evidencia
Menos métricas, más utilidad.
Política de escalación
Si un blocker se repite dos loops:
- marcar
blocked - adjuntar evidencia
- reasignar owner
- fijar deadline
- rerun de verificación antes de desbloquear
Bloqueos sin owner son más peligrosos que tests fallando.
Modo incidente
Si el riesgo en producción se materializa:
- pausar merges de feature lanes
- pasar a lane de contención
- ejecutar política de rollback trigger
- documentar decisiones en tiempo real
- volver a ritmo normal tras estabilizar
No inventes workflow de incidente durante el incidente.
Calibración trimestral
Cada trimestre, revisar:
- qué gates detectan defectos reales
- qué artefactos nadie consume
- dónde cae la calidad de handoff
- qué checks son demasiado lentos para la cadencia diaria
Luego simplificar con evidencia.
Checklist rápido
Antes del merge semanal:
- contratos de lane completos
- evidencia de verifier lane en verde
- merge packet listo
Antes del release en producción:
- release decision record completo
- owner de rollback localizable
- paquete de comunicación preparado
Codex acelera. El manual operativo mantiene repetibilidad.