🛠️ Manos a la obra

Tres señales legítimas para migrar: necesitas ejecutar partes al mismo tiempo; necesitas un revisor que no vea cómo se hizo el trabajo; el contexto se está convirtiendo en un pantano y el agente pierde la instrucción original.

Si no está presente ninguno de los tres, mejora el bucle. Migrar sin una de estas señales es comprar complejidad gratis.

Las tres señales resumen todo lo que los recorridos 2 y 3 ya mostraron: paralelismo, contexto limpio y pantano de contexto.

Anota el costo por ejecución, el tiempo total y una medida de calidad que puedas verificar, antes de cambiar nada.

Migrar sin línea base es fe, no ingeniería. Sin los números de antes, nunca sabrás si el grafo valió la pena.

Las tres medidas —costo, tiempo, calidad— son las mismas que volverás a comparar en el tema 6.

Divide el loop donde cambia la responsabilidad, la herramienta o el contexto necesario. En el resumen diario eso da tres nodos naturales: quién busca, quién escribe, quién revisa.

Cortar en el lugar equivocado te da un grafo con nodos artificiales que solo complican las cosas. Cortar en el lugar correcto te da nodos que ya existían, ocultos en el loop.

Un cambio de responsabilidad, herramienta o contexto — cualquiera de los tres ya justifica una separación.

Antes de programar, define qué lleva cada arista: el investigador entrega notas (no HTML sin procesar), el escritor entrega un borrador, el revisor devuelve su aprobación junto con sus críticas.

Sin un contrato explícito, cada nodo termina enviando lo que quedó en su propio contexto, y el pantano vuelve por la puerta de atrás.

Este es el state schema en miniatura: nombre del campo, formato, obligatorio o no.

El revisor que rechaza devuelve el trabajo al escritor, con un máximo de N vueltas y un criterio de progreso.

Sin límite, la factura es infinita: el mismo problema de un loop sin condición de parada, ahora dentro de un nodo del grafo.

Límite de vueltas + criterio de progreso, no solo límite de vueltas. Sin progreso medido, N vueltas repiten N veces el mismo error.

Ejecuta ambos en paralelo durante algunos días con las mismas entradas y compara los resultados con la línea de base del tema 2.

Si el grafo no mejoró ninguna de las tres medidas, vuelve al bucle: compraste complejidad sin obtener nada a cambio.

Admitir que no valió la pena es parte del trabajo, no un fracaso. La migración es una hipótesis que se pone a prueba, no una creencia.

Campaña, tráfico, landing, registro, activación, retención, LTV, cancelación; los nodos son estados del cliente y las aristas son tasas de conversión.

El embudo ya es un grafo; solo que nadie suele dibujarlo así. Dibujarlo deja claro dónde pierde realmente al cliente.

Cada arista es una tasa de conversión medible, no una flecha decorativa.

El abandono y el costo de adquisición vuelven al inicio del embudo y cierran un ciclo dentro del grafo del negocio.

Es este ciclo el que hace que el sistema tenga un comportamiento propio — y es lo que un agente miope, que solo mira hacia adelante, no ve.

Un embudo sin la arista de vuelta es una foto; con ella, es un sistema dinámico.

"LTV sobre CAC debe ser mayor que 3" es una relación entre dos métricas, no una métrica aislada.

Un loop con un único objetivo ni siquiera puede expresar esta relación — solo ve la métrica que le diste.

La restricción entre nodos es otra forma de arista, invisible para quien piensa en una sola métrica.

En el backlog hay tres tipos de aristas: descomposición (un épico contiene una historia que contiene una tarea), dependencia (debe terminarse antes) y bloqueo (impide el inicio).

Confundir los tres hace que el backlog se convierta en un árbol engañoso. Solo el primero es jerarquía; los otros dos convierten el árbol en un grafo de verdad.

Descomponer ≠ depender ≠ bloquear. Una herramienta de backlog que trata los tres como iguales oculta información.

Cuenta cuántas tareas están listas al mismo tiempo: el ancho del nivel del grafo de backlog.

Así calculas cuántas personas o agentes necesitas de verdad, en vez de adivinar cuántos "caben" en el sprint.

La anchura del nivel es la misma idea que fan-out — cuántos nodos independientes existen en ese punto del grafo.

Con el grafo del negocio o del backlog escrito, un agente puede proponer una asignación, señalar el cuello de botella y simular el efecto secundario de un cambio.

Sin el grafo, el agente solo opina sobre la métrica que mencionaste: no ve el sistema, solo el punto que señalaste.

El grafo escrito es lo que transforma «pregúntale al agente» en «dale el grafo al agente». La diferencia es enorme.

Describes un proceso en texto corrido y el agente devuelve nodos, aristas condicionales y lo que pasa por cada arista, en JSON.

Y el punto de partida más rápido para pasar de «proceso en la cabeza» a «proceso dibujado».

JSON de nodos y aristas es el formato común que los siguientes prompts de esta lista asumen como entrada.

El segundo paso del método de dos etapas: dibuja cualquier grafo y luego pídele al agente que genere el script que lo ejecuta.

Así se pasa del diagrama al código sin escribir la orquestación a mano — el agente lo traduce y tú lo revisas.

Diseñar y generar son dos etapas separadas a propósito: diseñar es pensamiento humano; generar es trabajo mecánico.

Busca ciclos sin salida, aristas sin condición, nodos sin límite de costo, uniones que no verifican la cardinalidad y estados que se filtran entre nodos.

Son los mismos defectos que la ruta 4 te enseñó a reconocer, ahora automatizados en un único prompt de verificación.

Auditoría de grafo y verificador de grafo: el mismo principio del módulo 2.2 aplicado a la estructura, no al resultado.

Dado un conjunto de objetivos automatizados, señala cuáles se afectan mutuamente y qué métrica de uno es un efecto secundario del otro.

La colisión entre bucles (ruta 2, fallo 3) solo aparece cuando alguien —o algo— observa el conjunto. Este prompt automatiza esa observación.

La colisión se hace visible cuando dibujas la arista entre dos bucles, y esa es la arista que busca el prompt.

Dados dos nodos vecinos, define el contrato de la arista entre ellos: nombres de los campos, formato, qué es obligatorio y qué explícitamente NO debe pasar.

Lo que NO debe pasar es la parte que todos olvidan, y la que evita que el contexto vuelva a convertirse en sopa dentro del grafo.

State schema formaliza el contrato que el tema 4 del módulo 5.1 ya te pedía escribir a mano.

Invierte el orden: primero, cómo sabrás que funcionó, con un caso de prueba malo; solo después, el prompt del agente.

Y el cierre de todo el curso en un único hábito: primero el verificador, siempre: loop, nodo o grafo completo.

El mismo principio del módulo 2.2, ahora empaquetado como un prompt listo para usar en cualquier nodo nuevo que crees.