Referencias Oficiales: Best Practices · Instructions · Sandboxing
Por qué hace falta una segunda guía de principiante
La mayoría de fallos iniciales no vienen del modelo, sino de arrancar con una tarea demasiado grande.
Este documento define un loop de primer día centrado en control y evidencia.
Loop de 45 minutos del primer día
0–10 min: fijar límites
- validar reglas en
AGENTS.md - validar sandbox y approval mode
- definir archivos que no se deben tocar
10–25 min: ejecutar una tarea acotada
Empieza con una tarea que toque pocos archivos.
25–35 min: verificar y revisar diff
- correr checks de lint/docs
- revisar alcance de cambios
- revertir ediciones accidentales
35–45 min: dejar evidencia de handoff
- qué cambió
- qué pasó
- qué falta
- quién es el siguiente owner
Plantilla inicial de prompt
Goal:
<un resultado concreto>
Context:
<archivos relevantes y restricciones>
Constraints:
<qué no debe cambiar>
Done when:
<comandos y criterio de aprobación>Anti-patrones de principiante
Empezar con un refactor grande
Reduce calidad de feedback desde el inicio.
Saltar revisión de sandbox
Los incidentes tempranos suelen ser de límites, no de sintaxis.
Declarar "done" sin output de comandos
"Se ve bien" no es evidencia.
Checklist rápido
- límites definidos
- una tarea acotada completada
- comandos de verificación ejecutados
- alcance de diff revisado
- nota de handoff registrada
Si esto se cumple, tu loop inicial en Codex está sano.