Proyecto 8, dibuja tu flujo como un grafo

Dibujar el mapa de un metro que ya existe

Cuando llevas años usando un metro, conoces los trasbordos sin mirar el plano. Pero si alguien te pregunta cómo ir a otro barrio, te das cuenta de que ese conocimiento está solo en tu cabeza. Tu loop maker-checker del proyecto 7 es ese metro: las decisiones ocurren dentro del contexto del agente. Este proyecto las dibuja. Antes, repasa del loop al grafo.

Preparación

1. Parte del repo del proyecto 7 (o de cualquier flujo de agente que repitas).
2. Ramas: p08-explicit-graph, p08-parallel, p08-human-in-the-loop.
3. Crea state.md: el espacio común donde se anotan requisitos, progreso y resultados de verificación.

Experimento 1: el grafo explícito

1. Nodos: cada paso del loop, con su responsabilidad, entradas, salidas y si es agente o código determinista.
2. Aristas: todas las conexiones. Marca las condicionales (pasa o falla) y las de retroceso.
3. Estado compartido: qué campos hay y quién lee y escribe cada uno.
4. Reglas de routing en if-then:

si la verificación pasa -> nodo merge
si la verificación falla -> nodo implementar
si falta información -> nodo investigar

5. Escríbelo todo en graph.md con un diagrama mermaid, la tabla de nodos y las reglas.
6. Responde: ¿qué arista implícita has descubierto, una ruta de decisión que antes estaba escondida en el contexto del agente?

Experimento 2: abanico paralelo

Busca algo que se pueda dividir en dos partes independientes: dos módulos, dos revisiones con enfoques distintos o dos líneas de investigación. Escribe la regla de fan-out (cómo se reparte, cada subtarea con contexto propio) y la de fan-in (quién fusiona y con qué criterio). Aísla cada rama en un git worktree. Mide el tiempo de reloj, los tokens y la calidad: ¿el paralelismo ganó o el coste de coordinar se comió el ahorro?

Experimento 3: retroceso y aprobación humana

• Arista de retroceso condicional: si los tests pasan pero la revisión detecta un malentendido de requisitos, vuelve a investigación, no a implementación. El estado debe anotar en qué capa está el problema.
• Nodo de aprobación humana antes de fusionar: el grafo se detiene hasta que escribes «aprobar» o «rechazar» en state.md, con regla de tiempo límite opcional.
• Formato de la petición: qué pasó, qué cambió, por qué hace falta una persona y qué ocurre al aprobar o rechazar.
• Ejecuta al menos dos rondas y anota si tu decisión coincidió con la del nodo de verificación.

Qué medir