# Prompt — criar a rede de contexto entre as notas

> **Antes:** rode `python3 ferramentas/mapear-contexto.py` (o passo 7 explica).
> **Como usar:** abra o Claude Code na pasta do cérebro e cole o texto abaixo, do `---` em diante.

---

Você é o Guardião deste cérebro. Sua tarefa agora é **transformar uma pilha de notas soltas numa
rede** — para que, ao abrir uma nota, eu e o agente da VPS enxerguemos na hora o que mais importa
saber sobre aquele assunto.

## Por que isso importa

Uma nota isolada responde uma pergunta. Uma nota ligada às outras responde a pergunta **e avisa
o que você não sabia que precisava perguntar**. É a diferença entre um arquivo morto e um cérebro.

## 1. Leia o raio-X

Abra `ferramentas/relatorio-contexto.md`. Ele traz:

- links quebrados,
- notas sem cabeçalho (frontmatter),
- notas ilhadas (ninguém aponta para elas),
- **pares candidatos** — notas com vocabulário parecido que ainda não estão ligadas.

O relatório é um **filtro barato**, não um julgamento. Ele diz "estas duas talvez conversem".
Quem decide é você, lendo as duas.

## 2. Conserte o que é objetivo

- **Links quebrados:** encontre o arquivo certo e corrija o caminho. Se o alvo não existe mesmo,
  remova o link e diga o que aconteceu.
- **Notas sem cabeçalho:** acrescente o frontmatter conforme `PADROES.md` §2 — `tipo`, `area`,
  `tags`, `status`, `data`. Não invente data: use a do fato quando o texto disser, senão a do
  arquivo (`git log --diff-filter=A --format=%ad -1 -- <arquivo>`).

## 3. Julgue os pares candidatos

Para cada par, **abra as duas notas inteiras** e pergunte:

> Estas duas notas tratam do **mesmo objeto concreto**?

- **Vale a ligação:** mesmo fornecedor, mesma loja, mesma pessoa, mesmo projeto, mesma decisão em
  aberto, mesmo problema que ainda não foi resolvido.
- **Não vale:** só o assunto é parecido ("as duas falam de compras"), ou o vínculo é "a ideia
  daqui serve ali". Esse critério liga tudo com tudo e destrói o valor do mapa.

Na dúvida, **não ligue**. Aresta errada custa mais caro que aresta faltando: ela manda a gente
ler a nota errada com confiança.

Classifique cada ligação aprovada:

| Situação | Campo |
|---|---|
| Uma nota **cita** a outra no texto | `relacionado` |
| Não se citam, mas tratam do mesmo objeto concreto | `relacionado_contexto` (com `elo`) |
| Você achou provável mas não tem certeza | `relacionado_sugerido` |

## 4. Escreva o elo — a parte que faz diferença

Toda ligação de contexto leva uma frase explicando **por que o alvo importa para quem está
lendo esta nota**. Escreva do ponto de vista de quem chegou aqui.

- ❌ Ruim: *"Ambas falam sobre fornecedores."* (não ajuda ninguém a decidir se abre)
- ✅ Bom: *"A negociação de prazo com o Anderson registrada aqui é a que define o custo de
  embalagem do projeto da indústria — mexer em uma muda a conta da outra."*

Sem elo, quem lê abre tudo no escuro ou não abre nada.

## 5. Me mostre antes de gravar

Apresente **todas** as ligações propostas de uma vez, em lista, cada uma com:

`nota A` ⇄ `nota B` — **elo:** a frase.

Eu aprovo, corto ou corrijo o lote inteiro numa resposta só. **Não me pergunte uma por uma.**

## 6. Grave

Só depois do meu OK. Para cada ligação aprovada:

1. No **frontmatter** da nota, no campo certo (caminhos a partir da raiz do cérebro):

```yaml
relacionado_contexto:
  - alvo: "memory/projects/industria-alimentos-via-bahia.md"
    elo: "A negociação de prazo registrada aqui define o custo de embalagem daquele projeto."
    por: <meu nome>
    em: 2026-08-07
```

2. Se a ligação for `relacionado` (uma cita a outra), garanta também o **link no corpo**, em
   markdown relativo ao arquivo: `[Indústria de alimentos](../projects/industria-alimentos-via-bahia.md)`.

**Link é navegação; frontmatter é indexação.** As duas camadas, sempre.

3. Suba com caminhos explícitos:

```bash
git add -- <só os arquivos que você editou>
git commit -m "contexto: liga <N> notas"
git pull --rebase && git push
```

## 7. Feche com o placar

Diga em três linhas: quantos links quebrados consertou, quantos cabeçalhos completou, quantas
ligações entraram — e **o que você deixou de fora por dúvida**, que é a informação mais útil
para a próxima rodada.
