Desarrollo de Software con IA

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

Operar un ciclo real con agente: instrucción acotada, revisión de diffs, prueba y cierre.

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]

Esta actividad interactiva ('Explicacion visual') requiere el motor completo de Lumbre. El contenido estatico se muestra arriba; para la experiencia interactiva, visita la version online de este objeto.

Cómo se ve una tarea bien acotada

La tarea completa cabe en 8 líneas: eso es una tarea, no una conversación
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.

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.
ErrorQué pareceQué 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

Proyecto: tu documento maestro para dirigir un agente
El documento donde viven el reglamento y el criterio de listo: sin él, cada tarea empieza de cero.

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:

  1. Cada tarea nueva abre una rama con nombre de la función.
  2. Pide el diff antes de decidir el merge, aunque confíe en el reporte.
  3. Da tareas grandes de una sola vez y hace merge cuando el agente dice «terminé».
  4. Borra la rama y anota el criterio de listo cumplido al cerrar.

Identifica la linea con error.

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.

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