🌍 Grafos en el mundo real

Tú dormido. Despiertas. Tardas 2 minutos en levantarte. Otros 5 en cepillarte los dientes. Otros 3 hasta que el café está en la taza. Cada estado es un en el, cada transición es una arista, y cada intervalo es el peso. Acabas de modelar un proceso.

Lo interesante empieza cuando aparece un ruta alternativa. Supongamos que alguien (o un robot) te lleva el café a la cama: ahora hay una arista que sale de «despertar» y llega directamente a «café», saltándose dos nodos. El grafo no cambió de naturaleza — solo ganó una arista. Y, de repente, existe una elección a optimizar.

Cuando LinkedIn te dice «tienen 3 conexiones en común, agrega a Lucas», te está dando el resultado de un recorrido por un grafo. Cada persona es un nodo. Cada relación es una arista con peso: amistad, compañeros de trabajo, temas en común, otras redes donde aparecen juntos. «Estar a tres conexiones» significa literalmente tres aristas de distancia.

Qué observar: los números 1, 2, 3 encima de las líneas. “Grados de separación” no es una metáfora: es el número de aristas del camino más corto. Y la etiqueta de cada arista (trabajo, universidad, tema) muestra que las aristas pueden tener tipo, no solo peso.

Este es el ejemplo más importante del módulo, porque prepara el problema central del curso. Campaña → tráfico → registro → cuenta creada → activación → suscriptor → (cancelación) → LTV. Los nodos son estados del cliente; las aristas son las tasas de conversión entre ellos.

Qué observar: la línea roja punteada de abajo. Un agente que trabaja en loop con el objetivo de “bajar el costo de adquisición” solo verá la primera arista y va a acertar su misión. Pero no ve la línea punteada: un lead más barato suele ser un lead más frío; el churn aumenta, el LTV cae y el negocio empeora mientras la métrica mejora. Este es el motivo técnico de que una sola métrica nunca sea suficiente.

Todo equipo grande acaba con un proceso: primero una epic (el objetivo grande), dentro de ella historias (las historias de uso), dentro de ellas tareas, y a veces subtareas. Eso parece un árbol. No lo es: casi siempre una story depende de otra, y entonces el árbol se convierte en un grafo.

Y por eso al gerente de producto le gusta este diseño: el grafo responde la pregunta que hace todos los días: ¿cuántas personas pueden trabajar aquí al mismo tiempo? Si dos ramas no se bloquean entre sí, caben dos. Cuando termine una tarea, se libera otra. Si dos subtareas van en secuencia, no sirve de nada asignarlas a dos personas.

Qué observar: la línea roja punteada. Sin ella, esto es un árbol bonito y dirías “caben 3 personas”. Con ella, la tarea B1 solo puede empezar después de A2, así que en realidad solo avanzan dos frentes ahora. Esa única arista cruzada marca la diferencia entre un plan que funciona y un equipo detenido esperando.

La forma más común de dar contexto a un agente hoy es dejarle una carpeta llena de archivos .md y esperar. El agente lo lee todo, consume contexto y además mezcla información vieja con nueva. La alternativa es transformar esta carpeta en un grafo: cada documento se convierte en un nodo y tú declaras cómo un documento se relaciona con el otro.

Leia todos os arquivos .md em <./docs> e me devolva um grafo de conhecimento em JSON.

Regras:
- Cada arquivo e um no: { "id", "arquivo", "assunto_em_1_frase", "publico" }
- Cada aresta e uma relacao TIPADA entre dois nos. Use SO estes tipos:
  "pre_requisito_de" | "detalha" | "contradiz" | "substitui" | "exemplo_de"
- Se dois documentos se contradizem, crie a aresta "contradiz" e explique
  em uma frase QUAL afirmacao conflita.
- Se um documento nao se liga a nenhum outro, liste-o em "orfaos".

Formato de saida (so o JSON, sem texto em volta):
{ "nos": [...], "arestas": [{"de","para","tipo","porque"}], "orfaos": [...] }

Este es el grafo más parecido al que construirás en la Trilha 4 — y la buena noticia es que ya existe y funciona desde hace décadas. Cuando ejecutas npm install, make o un pipeline de CI, una herramienta arma un grafo dirigido de dependencias y decide por sí sola qué se ejecuta primero, qué va después y qué puede ejecutarse al mismo tiempo.