El bucle SDD autónomo
El bucle de funciones con verify gate está muy bien, pero por sí solo construye una función y se para. El truco de Agentum es poner una pequeña cuadrilla de agentes de rol alrededor de ese bucle y dejar que un spec entero corra solo, del borrador a un cambio que alguien ha aprobado, sin que toques nada.
En un relevo, el testigo es el trabajo y cada corredor tiene una tarea antes de pasarlo. Nadie le pide permiso al entrenador a mitad de carrera. Agentum corre un spec como un relevo: el PM le pasa un spec claro al arquitecto, que le pasa un diseño validado al bucle developer, que le pasa un cambio construido al reviewer. El testigo es el spec, y nunca se detiene por un toque humano.
Más allá de una función
Ya viste el bucle de funciones: pending, coding, verifying, done. Ese bucle es el motor, pero un cambio real es más grande que una función. Alguien tiene que convertir una idea cruda en criterios de aceptación claros, decidir la forma de la solución y revisar el trabajo terminado. En la mayoría de los equipos esas son personas. En Agentum son agentes, y los traspasos entre ellos son fases que el servidor rastrea.
Así el bucle developer se vuelve el centro de un bucle mayor. La misma disciplina que controla una función ahora controla un spec entero.
flowchart LR
A["authoring, agente PM"] --> B["architecture, agente arquitecto"]
B --> C["decompose, el motor deriva el backlog"]
C --> D["executing, el bucle de funciones"]
D --> E{"review, agente reviewer"}
E -->|pasa| Done["done"]
E -->|dudas| D
linkStyle 4 stroke:#2ea043,stroke-width:2.5px,color:#2ea043
linkStyle 5 stroke:#e0493f,stroke-width:2.5px,color:#e0493f
Las cinco fases
Una corrida lleva una fase por encima de su backlog de funciones, y avanza por ellas en orden:
- Authoring, un agente PM convierte el spec en criterios de aceptación comprobables.
- Architecture, un agente arquitecto valida el diseño y lo escribe antes de cualquier código.
- Decompose, el motor deriva el backlog de funciones del spec, sin llamada humana.
- Executing, el bucle de funciones con verify gate que ya conoces construye cada ítem, uno a uno.
- Review, un agente reviewer lee el cambio y lo aprueba o plantea dudas.
Cuando review pasa, la corrida está done. Cada agente de rol se lanza igual que el bucle de funciones lanza el suyo, así que el sustrato tmux, el modo autónomo y el cableado se mantienen iguales.
Autónomo por defecto
Toda la secuencia avanza sola. Una fase no pasa porque un humano pulsó continuar; pasa porque el agente de rol produjo su artefacto (un spec refinado, una nota de arquitectura, notas de revisión) y un veredicto legible por máquina que el motor puede parsear. Un veredicto limpio avanza y se registra en decisions.md. Una duda, o un veredicto ausente, reintenta el agente de rol hasta max_retries, y luego se detiene en blocked con el motivo.
Una parada humana es opcional, nunca por defecto. Solo cuando una corrida activa hitl_on_block una puerta agotada pausa para una persona en vez de bloquear. Esa es la promesa detrás de «abre un spec y vete»: lo arrancas una vez, y el PM, el arquitecto, el bucle developer y el reviewer lo llevan a un cambio verificado con la tapa cerrada.
Puntos clave
- El bucle de funciones es solo la fase developer de un bucle mayor, a nivel de spec.
- Cinco fases (authoring, architecture, decompose, executing, review) corren cada una como un agente de rol.
- Las fases avanzan con un artefacto más un veredicto legible por máquina, nunca un prompt humano.
- Una duda o un veredicto ausente reintenta hasta max_retries, luego bloquea. La parada humana es opcional.
- Eso es «abre un spec y vete»: todo el bucle SDD corre sin supervisión.
Ejercicios
- Nombra los cuatro roles. Para tu próximo cambio, escribe una frase para el trabajo de PM, arquitecto, developer y reviewer. ¿Cuál sueles saltarte?
- Encuentra el prompt humano. ¿Dónde en tu flujo te detienes a aprobar algo? ¿Podría un veredicto legible por máquina reemplazar ese toque?