Wiki Lint

Skill: wiki-lint

Implementação do conceito de "lint" da LLM Wiki do Karpathy adaptada ao vault de advocacia. Detecta inconsistências silenciosas que se acumulam sem monitoramento.

O que a skill faz

Roda cinco verificações no vault Obsidian:

1. Wikilinks quebrados. Encontra [[X]] apontando para arquivo inexistente. Considera basename, caminho relativo e aliases do frontmatter na resolução.
2. Tags fora do vocabulário canônico. Compara todas as tags (frontmatter + inline) com _tags.md. Sinaliza tags não cadastradas (ex.: #bancário quando o canônico é #bancario).
3. Páginas órfãs. Arquivos sem nenhum incoming wikilink. Exclui arquivos estruturais (_index, _MOC, MOC-*, _template, _tags, Home, _checkpoint*) e arquivos abaixo de 200 caracteres (stubs/placeholders).
4. Conceitos órfãos. Precedentes padronizados (Tema, EAREsp, EREsp, REsp, Súmula, ADI, IRDR) citados em ≥2 arquivos sem ficha consolidada em Precedentes/. Sugere criação da ficha.
5. Divergências em precedentes. Mesmo precedente referenciado com datas diferentes em arquivos distintos (ex.: EAREsp 1280825 com "30/03/2021" em uma ficha e "30/03/2022" em outra).

Uso

python ~/.claude/skills/wiki-lint/scripts/wiki_lint.py "C:/Users/gabri/OneDrive/Documentos/Obsidian Vault"

Argumentos opcionais:

• --saida <arquivo.md> — caminho explícito do relatório (default: <vault>/_lint/lint-YYYY-MM-DD.md)
• --orfa-min-tamanho <chars> — limiar mínimo para considerar arquivo como órfão real (default: 200)

Sem dependências externas: usa apenas stdlib (re, pathlib, collections).

Regras de uso pela Claude

1. Rodar antes de iniciar trabalho de fôlego no vault (ex.: criar nova área, refatorar taxonomia, ingerir lote de precedentes). O relatório aponta dívida acumulada que vale resolver antes de adicionar mais conteúdo.
2. Após o lint, abrir o relatório no Obsidian (não só ler o stdout). Os wikilinks no relatório são clicáveis e levam direto ao arquivo problemático.
3. Cadência sugerida: rodar semanalmente (segunda de manhã, junto com a rotina de prazos). Ou quando o usuário mencionar sintomas de inconsistência ("não acho aquela tese", "citei o precedente errado").
4. Não corrigir automaticamente. A skill apenas detecta. Cada categoria pede julgamento humano: tag fora do vocabulário pode ser typo (corrigir) OU candidata a entrar no vocabulário (atualizar _tags.md).
5. Ao corrigir wikilinks quebrados, verificar se o destino existia e foi renomeado vs. nunca existiu. Renomeação: ajustar todos os incoming. Inexistente: criar a ficha ou remover a referência.
6. Conceitos órfãos têm prioridade alta: cada precedente citado ≥3x sem ficha é dívida que pesa nas peças (re-pesquisa de zero, citações inconsistentes). Criar ficha em Precedentes/ consolidando.
7. Páginas órfãs nem sempre são lixo: pode ser ficha boa esquecida do MOC. Antes de deletar, ver se faz sentido linkar do MOC da área.

Exemplo de saída

# Wiki Lint — 2026-04-30

| Categoria | Total |
|---|---:|
| Wikilinks quebrados | 3 |
| Tags fora do vocabulário | 5 |
| Páginas órfãs | 12 |
| Conceitos órfãos | 4 |
| Divergências em precedentes | 2 |

## 1. Wikilinks quebrados

**[[Teses/rmc-irdr-tema5-tjam]]** cita destinos inexistentes:
1. `[[Tema 5 TJAM]]`

## 4. Conceitos órfãos

### EAREsp 1280825

Citado em 5 arquivo(s):
1. [[Teses/prescricao-consignado]] (data citada: 30/03/2021)
2. [[Modelos/ReplicasRMC/_MOC]] (data citada: 30/03/2021)
...

> Sugestão: criar `Precedentes/earesp-1280825.md` consolidando.

## 5. Divergências em precedentes

### EAREsp 1280825

Datas distintas encontradas: 30/03/2021, 30/03/2022
1. [[Teses/prescricao-consignado]] → **30/03/2021**
2. [[Aprendizado/X]] → **30/03/2022**

Limitações conhecidas

1. Precedentes em formato livre não são detectados. Captura apenas padrões Tema NNN, EAREsp NNN, REsp NNN, Súmula NNN STF/STJ/TST, ADI NNN, IRDR NNN. Casos como "Súmula Vinculante 47" ou "AgInt no AREsp" não entram (extender padrões em PRECEDENTE_PATTERNS do script).
2. Aliases do frontmatter são lidos para resolução de wikilinks, mas apenas se a tag estiver bem formada (aliases: [a, b] ou aliases:\n - a\n - b).
3. Não detecta contradições semânticas. Se duas fichas dizem coisas opostas sobre o mesmo precedente sem divergência de data, a skill não pega — isso pede leitura humana.
4. Tags em texto corrido fora de frontmatter podem ser falsos positivos se o autor escreveu, p. ex., o#1 (não é tag, é "número um"). A regex pede # precedido de espaço/início e seguido de letra; mas casos como \#literal não são tratados.

Ver também

• Skill obsidian-markdown — sintaxe Obsidian completa (caso de criar fichas novas a partir do relatório)
• Memória reference_autoresearch.md — origem do conceito (Karpathy)
• Memória feedback_rag_processos.md — por que descartamos RAG vetorial e mantemos a wiki como fonte canônica