themsquared/brain-linking

Brain linking

Um vault é um grafo. Uma nota sem links está perdida. Toda nota que você escreve deve se conectar a pelo menos duas páginas existentes, e pelo menos uma página existente deve apontar de volta para ela.

Esta skill é para qualquer vault Obsidian ou base de conhecimento markdown que use [[wikilinks]]. Não está vinculada aos arquivos de uma só pessoa.

Antes de escrever

1. Leia o schema do vault na raiz. Nomes comuns: CLAUDE.md, AGENTS.md, README.md. Siga esse arquivo se ele existir.
2. Pesquise o que já existe: rg -il '<tópico ou nome>' --glob '*.md'.
3. Se uma página sobre o tópico já existir, adicione conteúdo a ela (ou solte uma nota de caixa de entrada apontando para ela). Não crie uma quase-duplicata.

Toda nota deve ter

• Um link de subida: um [[link]] para seu hub pai. Exemplos: um [[índice]] de pessoa ou projeto, uma página [[conceitos/...]], um hub de projeto ou hub de área.

• Links laterais: pelo menos um [[link]] para uma pessoa, projeto, produto, conceito ou reunião relacionada que já exista.

• Pessoas e coisas como links, não texto simples: se uma pessoa, produto ou projeto tem uma página, escreva [[Nome]]. Se deveria ter uma e não tem, ainda assim faça o link. O Obsidian mostra o link pendente, e o mantenedor cria a página.

• Frontmatter: about, area, source, suggested_home, date, agent. Use valores de area que o vault já utiliza (geralmente trabalho vs vida, ou a própria lista de áreas do vault).

• Uma seção Relacionados no final:

  ## Relacionados
  - [[hub-pai]]
  - [[irmão-ou-pessoa]]
  

Alvos de link

• Use o nome exato do arquivo existente (kebab-case). Verifique com rg --files | rg <slug> antes de linkar.
• Prefira alguns links fortes a uma pilha de links fracos. Linke o que um leitor realmente clicaria em seguida.
• Nunca linke apenas para uma página de data, uma nota diária ou uma tag. Isso não conecta tópicos.

Notas de reunião e gravação

Uma nota de reunião ou gravação linka para:

• a pessoa, equipe ou projeto sobre o qual era;
• cada participante que tem uma página;
• qualquer conceito ou decisão que produziu.

Uma transcrição com zero links é o órfão mais comum.

Fontes brutas

Arquivos em _raw/ (ou a pasta de captura equivalente do vault) nunca são editados. Não adicione links dentro deles. Em vez disso, a página de resumo ou reunião que os cita linka para o arquivo bruto, de modo que ele entre no grafo através dessa página.

Escrevendo em uma caixa de entrada compartilhada (robôs)

• Se o vault disser para escrever apenas em _agents/inbox/ (ou outro caminho de caixa de entrada), faça isso.
• As regras de link acima ainda se aplicam a notas da caixa de entrada, e suggested_home deve nomear uma página real.

Nunca coloque no vault

• Credenciais, tokens ou segredos
• Detalhes de contato privados que não pertencem a um grafo compartilhado
• Registros médicos ou outros dados pessoais sensíveis
• Material confidencial de terceiros que você não tem permissão para armazenar

Verificação rápida antes de finalizar

• Pelo menos um link de subida e um link lateral, ambos para arquivos reais (ou páginas novas intencionais)
• Nomes de pessoas, produtos e projetos estão linkados
• Seção Relacionados presente
• Nenhuma duplicata de uma página existente