🌍 Grafos no mundo real

Voce dormindo. Voce acorda. Leva 2 minutos pra levantar. Mais 5 ate escovar os dentes. Mais 3 ate o cafe estar na xicara. Cada estado e um no, cada transicao e uma aresta, e cada intervalo e o peso. Voce acabou de modelar um processo.

O interessante comeca quando aparece um caminho alternativo. Digamos que alguem (ou um robo) traga o cafe na cama: agora existe uma aresta que sai de “acordar” e chega direto em “cafe”, pulando dois nos. O grafo nao mudou de natureza — so ganhou uma aresta. E, de repente, existe uma escolha a ser otimizada.

Quando o LinkedIn diz “voces tem 3 conexoes em comum, adicione o Lucas”, ele esta te dando o resultado de uma travessia de grafo. Cada pessoa e um no. Cada relacao e uma aresta com peso: amizade, colegas de trabalho, temas em comum, outras redes onde voces aparecem juntos. “Estar a tres conexoes” significa literalmente tres arestas de distancia.

O que olhar: os numeros 1, 2, 3 em cima das linhas. “Graus de separacao” nao e metafora — e a contagem de arestas do caminho mais curto. E o rotulo de cada aresta (trabalho, faculdade, tema) mostra que arestas podem ter tipo, nao so peso.

Este e o exemplo mais importante do modulo, porque e ele que prepara o problema central do curso. Campanha → trafego → signup → conta criada → ativacao → assinante → (churn) → LTV. Os nos sao estados do cliente; as arestas sao as taxas de conversao entre eles.

O que olhar: a linha vermelha tracejada la embaixo. Um agente rodando em loop com o objetivo “baixar o custo de aquisicao” vai enxergar so a primeira aresta e vai acertar a missao dele. So que ele nao ve a tracejada: lead mais barato costuma ser lead mais frio, o churn sobe, o LTV cai — e o negocio piora enquanto a metrica melhora. Este e o motivo tecnico de uma metrica nunca ser suficiente.

Todo time grande acaba com um processo: primeiro uma epic (o objetivo grande), dentro dela stories (as historias de uso), dentro delas tasks, e as vezes subtasks. Isso parece uma arvore. Nao e: uma story quase sempre depende de outra, e ai a arvore vira grafo.

E por isso que gerente de produto gosta desse desenho: o grafo responde a pergunta que ele faz todo dia — quantas pessoas cabem trabalhando ao mesmo tempo aqui? Se dois ramos nao se bloqueiam, cabem dois. Quando uma tarefa terminar, libera mais um. Se duas subtasks estao em sequencia, nao adianta jogar duas pessoas nelas.

O que olhar: a linha vermelha tracejada. Sem ela, isto e uma arvore bonitinha e voce diria “cabem 3 pessoas”. Com ela, a task B1 so pode comecar depois da A2 — entao na verdade so duas frentes andam agora. Essa unica aresta cruzada e a diferenca entre um plano que funciona e um time parado esperando.

A forma mais comum de dar contexto a um agente hoje e largar uma pasta cheia de arquivos .md e torcer. O agente le tudo, queima contexto e ainda mistura informacao velha com nova. A alternativa e transformar essa pasta num grafo: cada documento vira um no e voce declara como um documento se relaciona com o outro.

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 e o grafo mais parecido com o que voce vai construir na Trilha 4 — e a boa noticia e que ele ja existe e ja funciona ha decadas. Quando voce roda npm install, make ou um pipeline de CI, uma ferramenta monta um grafo dirigido de dependencias e decide sozinha o que roda antes, o que roda depois e o que pode rodar ao mesmo tempo.