Organizador de Vault

O que Organizador de Vault faz?

Transforme um vault markdown bagunçado em uma base de conhecimento limpa, interligada e indexada que um LLM (ou um colega de equipe) possa consultar rapidamente. Construído com base no princípio de Karpathy: trate o conhecimento como código. Fontes brutas são arquivos fonte, a wiki compilada é a saída de compilação, o INDEX é o esquema, e esta skill é o compilador + linter.

O modelo (3 camadas)

Camada	O quê	Onde
RAW	Não processado: transcrições, clipes, dumps, capturas de tela	00_Inbox/raw/, pasta de tópico mais próxima
COMPILED	Páginas sintetizadas, com referências cruzadas usando [[wikilinks]]	Pastas PARA (01_–04_)
SCHEMA	Arquivos INDEX, CLAUDE.md, as regras	INDEX.md por pasta + um índice mestre

Todo arquivo carrega frontmatter type: (raw | compiled | reference | framework | client | index). Consulte references/standards.md para os modelos de frontmatter e INDEX.

Workflow

Execute nesta ordem. Audite e proponha antes de alterar qualquer coisa. Nunca exclua ou mova sem confirmar. Prefira um repositório git para que as alterações sejam reversíveis.

1. Auditoria (somente leitura)

# vault inteiro:
python3 scripts/audit.py <vault_root> --stale-days 120 --report /tmp/vault-audit.md
# uma subpasta, mas resolve [[wikilinks]] contra o vault inteiro (evita falsos indicadores de "quebrado"):
python3 scripts/audit.py <subfolder> --link-root <vault_root> --report /tmp/vault-audit.md

Retorna um relatório de saúde: frontmatter ausente, wikilinks quebrados/ausentes, órfãos, seções Relacionadas ausentes, duplicatas, arquivos obsoletos, pastas sem um INDEX. Leia-o e mostre ao usuário a tabela de resumo e os principais problemas. (--json para saída de máquina.)

2. Triagem

Agrupe as descobertas e pergunte o que corrigir agora vs. depois. Prioridade padrão:

1. Pastas sem um INDEX (mata a recuperação)
2. Frontmatter ausente (mata a pesquisa + Propriedades)
3. Wikilinks quebrados (mata o grafo)
4. Seções Relacionadas ausentes + órfãos (mata a descoberta)
5. Arquivos obsoletos / duplicatas (limpeza)

3. Limpeza (por arquivo)

Para cada arquivo sinalizado:

• Adicione frontmatter YAML (title, type, source, author, created, description, tags) — infira a partir do conteúdo, use a data de hoje para created se desconhecido.
• Adicione [[wikilinks]] na primeira menção de qualquer conceito, ferramenta, pessoa ou arquivo que exista em outro lugar no vault.
• Adicione uma seção ## Relacionados no final com 3–8 [[wikilinks]] para as páginas mais conectadas. Adicione o arquivo de volta em Relacionados de 2–3 dessas páginas (bidirecional).
• Corrija wikilinks quebrados: redirecione para o slug correto ou deixe como um stub intencional se o destino valer a pena ser escrito depois. Use os modelos em references/standards.md. Não remova frontmatter ou links existentes.

4. Organização (proponha primeiro)

• Mova itens mal colocados para a camada/pasta correta (raw → 00_Inbox/raw/, compiled → PARA).
• Normalize nomes de arquivo para kebab-case; mescle ou renomeie duplicatas.
• Mantenha as movimentações pequenas e reversíveis. Liste cada movimentação e obtenha um sim antes de executá-la.

5. Registro (a entrega)

• Para cada pasta de conteúdo, gere ou atualize INDEX.md: um ponteiro de uma linha por arquivo (- [[nome-do-arquivo]] — breve chamariz), agrupado por tipo, mais recente ou mais importante primeiro.
• Construa/atualize um índice mestre (ex.: INDEX.md na raiz ou uma pasta de esquema meta/) que aponte para cada INDEX de pasta.
• Este registro é o que torna a recuperação rápida e o que você entrega a um colega.

6. Linting (confirmação)

Execute audit.py novamente. Mostre as contagens antes/depois. O vault está "limpo" quando as contagens de frontmatter, cobertura de INDEX e links quebrados estiverem em zero (órfãos/obsoletos podem permanecer por escolha).

Enviando para um colega

Quando o objetivo for compartilhar o vault organizado com um colega: certifique-se de que o INDEX mestre esteja atualizado, toda pasta tenha seu próprio INDEX e um README.md curto na raiz explique o modelo de 3 camadas e como navegar. O README + índice mestre é o ponto de entrada.

Regras

• Auditoria somente leitura primeiro, sempre. Superficie, não surpreenda.
• Nunca exclua ou mova em massa sem confirmação explícita; recomende commitar primeiro.
• Não toque em .obsidian/, .git/, ou configuração do Claude Code (settings.json, hooks).
• Corresponda às convenções existentes do vault (este: PARA + os padrões em references/standards.md).
• Trabalhe em lotes; relate o que mudou após cada lote.

Arquivos

• scripts/audit.py — scanner somente leitura, o motor. Execute-o primeiro e por último.
• references/standards.md — especificação de frontmatter, taxonomia de tipos, modelos de INDEX + README.