Flujo de trabajo con un agente: tarea, revisión, merge

Delegar no es soltar: es seguir un ciclo

Un agente que trabaja bien sobre tu proyecto lo hace en una rama (M13): tu línea principal sigue intacta mientras él intenta. El ciclo profesional tiene seis movimientos y uno central —tu revisión— que no se puede delegar en la IA. El flow no es «le digo y ya está»: es encargar, mirar, probar, decidir y cerrar.

El ciclo de seis movimientos

1 · Tarea
instrucción acotada: objetivo, archivos permitidos, criterio de listo, reglamento (M19-OA02).
2 · Rama
el agente trabaja en rama propia; tu main sigue virgen mientras intenta.
3 · Diff
te presenta sus cambios; tú lees qué tocó, no solo qué dice.
4 · Prueba
corres la suite y la función a mano sobre SU rama: su verde no es tu verde.
5 · Merge
aprobado: su rama se integra a main; rechazado: feedback y vuelta al 1.
6 · Cierre
rama borrada, commit en main con mensaje que explica el qué y el porqué.

Cómo se ve una tarea bien acotada

La tarea completa cabe en 8 líneas: eso es una tarea, no una conversación

texto

TAREA: agregar filtro por estado (activo/inactivo) a la lista de contactos.\n\nRAMA: feature/filtro-contactos (trabaja ahi, no toques main).\nALCANCE: solo src/pages/contacts.* y tests/contacts.*. Si necesitas otro archivo,\ndetente y pregunta.\nCRITERIO DE LISTO:\n- el filtro cambia la lista sin recargar la pagina\n- prueba nueva: con 3 contactos mixtos, el filtro devuelve solo los del estado elegido\n- suite completa verde\nENTREGA: diff de archivos tocados + comando de prueba con su salida + como probarlo a mano.\nNO hagas commit a main; tu trabajo vive en la rama hasta mi revision.

Nota que el criterio de listo describe la PRUEBA (3 contactos mixtos, estado elegido): cuando el "cómo sé que terminó" está en la orden, el agente no decide solo cuándo dar por terminada la tarea.

Los tres errores de flujo que cuestan caro

El patrón de los tres: delegar el momento que NO era delegable —leer, probar, decidir la frontera—. El ciclo existe precisamente para que esos tres momentos sean tuyos.
Error	Qué parece	Qué es
Revisar solo el reporte del agente	«me dijo qué hizo, ya está»	leer la propaganda y no el diff: lo que tocó de más solo sale en la evidencia
Merge sin prueba manual	«la suite está verde»	la suite no cubre lo nuevo si lo nuevo salió distinto; 3 minutos de clic valen un incidente
Trabajar directo en main	«es un cambio chiquito»	sin rama no hay rebote limpio: si falla, desordenas la línea principal con el desastre dentro

Para reforzar

Prueba

El agente entrega la tarea: diff revisado, suite verde en su rama. ¿Qué falta para poder hacer merge a main?

El commit final en main debe ser del agente, porque fue él quien hizo el trabajo.

Detecta el flujo roto

Un alumno describe su rutina con el agente. Señala la práctica que romperá el proyecto:

Marca la línea o las líneas con error y pulsa Comprobar.

Toma la siguiente tarea de tu proyecto y escríbela con los cinco ingredientes del ejemplo (rama, alcance, criterio de listo, entrega, prohibición de main). Ejecuta el ciclo completo con agente o simulándolo en papel, y anota en qué movimiento te tentaste por saltártelo.

Dirigir un agente es gerencia en pequeño: el ciclo que no haces hoy es el bug que mergueas mañana.

Tu texto se guarda sólo en este dispositivo.