MÓDULO 2.4

🔍 Consultando e Auditando o Vault

Como fazer perguntas eficazes ao seu segundo cérebro, e como manter o vault saudável com auditorias regulares.

6
Tópicos
40
Minutos
Intermediário
Nível
Prática
Tipo
1

❓ Como o LLM Consulta o Wiki

Ao receber uma pergunta, o LLM não varre todos os arquivos — ele usa o index.md como mapa para identificar notas relevantes e então as lê. Isso reduz o uso de tokens drasticamente.

🔍 Fluxo de Consulta

Pergunta: "O que decidimos sobre Python 3.12?" 1. Lê index.md Identifica: - python-3-12.md ✓ - sprint-planning ✓ - joao.md ✓ 2. Lê notas python-3-12.md sprint-planning.md joao.md 3. Sintetiza Combina contexto das 3 notas em uma resposta coerente Resposta Decisão: migrar em Sprint 5. João lidera. Risco: distutils
2

💬 Tipos de Perguntas Eficazes

Nem toda pergunta é igual. Perguntas específicas e contextualizadas produzem respostas muito melhores do que perguntas genéricas.

✅ Perguntas Eficazes

Factual sobre projeto:

"Qual o status atual do projeto Alpha e quais são os bloqueadores?"

Comparação:

"Quais são as diferenças entre FastAPI e Flask mencionadas no vault?"

Síntese temporal:

"Quais decisões técnicas tomamos em março de 2024?"

Relacional:

"O que o João está liderando atualmente?"

❌ Perguntas Ineficazes

Muito genérica:

"O que você sabe?"

LLM não sabe por onde começar

Fora do vault:

"Qual é a melhor linguagem de programação?"

Responde com treinamento geral, não seu vault

Sem âncora:

"Me fale sobre machine learning"

Não especifica se quer do vault ou treinamento

Impossível de responder:

"O que vai acontecer com o projeto?"

LLM não prevê o futuro — só o que foi registrado

3

📊 Consultando com Dataview

Para consultas estruturadas, o plugin Dataview permite queries tipo SQL diretamente no Obsidian — sem precisar do LLM. Ideal para dashboards e relatórios recorrentes.

📋 Projetos Ativos
```dataview
TABLE status, updated
FROM "wiki/projetos"
WHERE status = "active"
SORT updated DESC
```

Lista todos os projetos ativos com data de última atualização

👥 Pessoas por Projeto
```dataview
TABLE file.outlinks
FROM "wiki/pessoas"
WHERE length(file.outlinks) > 2
SORT file.name ASC
```

Lista pessoas com mais de 2 conexões no vault

⚠️ Notas Desatualizadas
```dataview
LIST
FROM "wiki/"
WHERE updated < date(today) - dur(30 days)
AND status = "active"
```

Notas ativas não atualizadas há mais de 30 dias

🔗 Notas Órfãs
```dataview
LIST
FROM "wiki/"
WHERE length(file.inlinks) = 0
AND length(file.outlinks) = 0
```

Notas sem nenhum link — candidatas à conexão ou remoção

4

🔧 Auditoria: Lint do Vault

A auditoria identifica problemas de saúde no vault: notas órfãs, inconsistências, links quebrados e conteúdo desatualizado. Faça semanalmente.

🔧 Processo de Auditoria

🤖 LLM Auditor Lê index.md + todas notas wiki/ + log.md 🔴 Órfãos draft-ideias.md — sem links old-meeting.md — isolado 🟠 Desatualizados projeto-beta — 45 dias sem atualização 🟡 Inconsistências joao.md diz "líder" alpha.md diz "ex-líder" 🟢 Saudáveis 87% das notas OK grafo bem conectado 📋 Relatório 2 notas órfãs 1 projeto desatualizado 1 inconsistência encontrada Ação: revisar 4 itens

Prompt de Auditoria Semanal

Faça uma auditoria completa do vault:

1. Liste notas wiki/ sem nenhum [[link]] (órfãos)
2. Liste notas com status "active" não atualizadas
   há mais de 30 dias
3. Identifique contradições entre notas
   (mesmo conceito com informações diferentes)
4. Verifique se index.md está completo
5. Reporte links [[quebrados]] (notas referenciadas
   que não existem)

Gere um relatório em formato de checklist com
ações recomendadas para cada problema.
5

📈 Métricas de Saúde do Vault

Um vault saudável tem métricas específicas. Monitore esses números mensalmente para garantir que o sistema não está degenerando.

📊 Dashboard de Saúde (exemplo)

94% Notas Conectadas ≥ 1 link 2.4 Links Médios/Nota Meta: ≥ 2.0 87% Notas Atuais Atualizadas < 30d 142 Notas no Wiki +12 este mês Crescimento do Vault (notas/mês) Jan 8 Fev 11 Mar 14 Abr 17 Mai 16 Jun 19 ← Agente automático ativado → Jul 18 Ago 22 Set 25
6

🎯 Casos de Uso: Quando Usar Cada Modo

O sistema tem três modos principais: consulta via LLM, consulta via Dataview e auditoria. Saber quando usar cada um economiza tempo e tokens.

Situação Melhor Abordagem Exemplo
Pergunta de contexto LLM + wiki/ "O que decidimos sobre X?"
Listar projetos ativos Dataview query TABLE status FROM "wiki/projetos"
Saúde do grafo LLM audit Prompt de auditoria semanal
Conexões rápidas Graph View (Obsidian) Visual do grafo no UI
Síntese criativa LLM + múltiplas notas "Conecte os conceitos de X e Y"
✅ Conceitos-chave do módulo
LLM usa index.md para localizar notas relevantes
Perguntas específicas produzem respostas melhores
Dataview = SQL estruturado sem LLM
Auditoria semanal mantém vault saudável
Métricas: conectividade, links/nota, atualidade
Cada modo tem seu caso de uso ideal
2.3 — Agente de Atualização Trilha 3 — Avançado