LLM Wiki Distiller

O que LLM Wiki Distiller faz?

Ideia Central

Manter uma base de conhecimento pessoal voltada para uso por modelos de linguagem: registrar o que o usuário aprendeu, o que valoriza, o que observou, o que salvou, o que sempre esquece e o que deseja que o modelo lembre no futuro. Não repita conhecimento geral enciclopédico; foque em reter a perspectiva pessoal do usuário, os caminhos das fontes, informações novas após a data de corte do treinamento e contexto pessoal reutilizável.

A raiz da base fixa quatro diretórios + três arquivos raiz (index.md / log.md / pending.md):

1. raw/: Materiais brutos, anexos e inbox a processar.
2. wiki/: Entradas destiladas mantidas pelo LLM.
3. _staging/: Propostas temporárias para processamento em lote paralelo (diretório permanente, conteúdo transitório – excluído após integração).
4. review/: Relatórios de revisão (review/YYYY-MM/ arquivados por mês; o relatório mais recente serve como cursor de revisão).

Qualquer criação, modificação, exclusão, arquivamento ou revisão substancial deve atualizar sincronizadamente index.md e log.md.

Mapa de Recursos

Este arquivo é apenas para roteamento. Após determinar o modo, leia o mode correspondente; o mode informará quais reference/schema ler em seguida.

• modes/quick.md: Adição, modificação, arquivamento e exclusão rápidos, sem passar pelo inbox.
• modes/distill.md: Processamento de raw/inbox/ ou outros materiais brutos e destilação formal.
• modes/review.md: Revisão, verificação de integridade, propostas de mesclagem; cada rodada gera um relatório com data.
• modes/search.md: Consulta e resumo somente leitura, sem escrita.
• modes/integrate.md: Quando em orquestração paralela, o orquestrador consolida as propostas de múltiplos subagentes capture-only no repositório (único escritor, serial).
• references/raw.md: Diretório raw, classificação de fontes, anexos, tratamento de materiais duplicados.
• references/wiki.md: Determinação de tipo de página wiki, limites, regras de escrita.
• schemas/common.md: Campos YAML comuns, vocabulário controlado, datas e estados.
• schemas/raw.md: Ponteiros markdown raw, metadados de fonte, regras de referência a anexos.
• schemas/wiki.md: Frontmatter e estrutura de corpo para cada tipo de página wiki.
• schemas/root.md: Formato de index.md, log.md, pending.md.
• schemas/report.md: Localização do relatório de revisão, frontmatter e estrutura do corpo (o relatório mais recente serve como cursor de revisão).
• schemas/proposal.md: Formato de proposta temporária para capture-only → integrate na orquestração paralela.

Não leia todos os recursos de uma vez. Siga os passos do mode gradualmente.

Passo 0: Verificação do Diretório Raiz da Base

Antes de usar qualquer modo, confirme se o diretório de trabalho atual é a raiz da base de conhecimento. Faça apenas uma verificação leve e idempotente; não leia outros reference/schema.

Considere o diretório atual como uma base existente que precisa atingir pelo menos 2 tipos de sinais:

• Existe raw/, e dentro dele inbox/, attachment/, dropzone/ ou outras classificações raw.
• Existe wiki/, e dentro dele concept/, entity/, summary/, scrap/ ou outras classificações wiki.
• Existem pelo menos 2 dos arquivos raiz index.md, log.md, pending.md.

Tratamento:

• Atingiu 2 ou mais tipos: Continue para a porta do modo.
• Atingiu 0 tipos e o diretório atual está vazio ou quase vazio: Pergunte ao usuário se deseja inicializar a base no diretório atual ou fornecer o caminho de uma base existente.
• Atingiu 0–1 tipos e o diretório atual é claramente outro projeto: Pare e solicite que o usuário forneça o caminho da base; não crie raw/, wiki/ no projeto atual.
• Se o usuário especificar explicitamente o caminho da base na solicitação, mude para esse caminho e refaça esta verificação.

Porta do Modo

Escolha um dos quatro com base na semântica da solicitação do usuário, sem exigir que ele diga o nome do modo:

1. O usuário quer revisar/manter a base existente, por exemplo, "revisar", "verificar contradições", "executar verificação de integridade" → Leia modes/review.md.
2. O usuário quer apenas consultar/perguntar/resumir conteúdo existente, sem adicionar ou modificar → Leia modes/search.md.
3. O usuário quer adicionar, modificar, arquivar ou excluir, mas sem processar inbox/materiais brutos raw → Leia modes/quick.md.
4. O usuário quer processar raw/inbox/, recortes, textos longos, conversas, redes sociais, PDFs, transcrições de vídeo, projetos GitHub ou outros materiais brutos → Leia modes/distill.md.

Se o modo for incerto, priorize: se o usuário solicita escrita, mas a fonte ainda não foi organizada, vá para destilação; consulta pura vai para pesquisa; manutenção da base vai para revisão.

Complemento para Orquestração Paralela: O modo de destilação tem uma variante capture-only (cada subagente assume apenas uma entrada, escreve apenas seu resumo + raw + proposta _staging/<id>.md, sem tocar em páginas compartilhadas), em conjunto com o modo integrate (o orquestrador consolida várias propostas no repositório). As restrições estão descritas na seção "Modo de Execução" de modes/distill.md; quando paralelizar e como atribuir subagentes é decidido pelo CLAUDE.md do projeto chamador, não por esta skill.

Regras Rígidas Compartilhadas

• Trate o wiki como "memória compilada", não como repositório de texto original. Mantenha os caminhos das fontes raw; não copie o texto completo original para o wiki.
• O YAML original_url deve conter apenas URLs externas principais, para abrir rapidamente páginas web, vídeos, postagens, artigos, páginas iniciais de projetos etc.; apenas http:// ou https:// são permitidos. Caminhos locais .md, raw/..., wiki/summary/..., caminhos de anexos, caminhos absolutos/relativos, links internos do Obsidian e links para documentos locais em conversas nunca devem ser escritos em original_url; se não houver URL externa, deixe como array vazio []. Caminhos raw, páginas de resumo e evidências internas devem ser escritos no corpo, em ## Fontes ou related. Pesquisas complementares, materiais de fundo e leituras adicionais vão no final do corpo, em ## Fontes, não no frontmatter. Não use o campo sources no YAML do wiki.
• Conhecimento anterior a 2025-01-01 deve ser escrito de forma leve por padrão, a menos que seja importante para o usuário, raro ou constitua a base do raciocínio do usuário. Conhecimento posterior a 2025-01-01 pode receber mais atenção, pois pode preencher lacunas pós-treino do modelo, mas ainda com foco em "utilidade" em vez de "completeza".
• Use datas absolutas. Não escreva apenas "ontem", "hoje" ou "recentemente" em fatos persistentes, a menos que a data absoluta também seja fornecida.
• Diferencie fatos, inferências, preferências e sinais fracos. Sinais fracos não devem ser escritos como fatos estáveis.
• Quando uma nova fonte conflitar com uma página antiga, mantenha ambas as versões, fontes e datas, marque o conflito e não sobrescreva silenciosamente.
• Antes de escrever, pesquise por páginas duplicadas, títulos semelhantes, aliases, URLs de origem e frases centrais.
• Por padrão, não exclua fisicamente conhecimento; arquive, marque como obsoleto ou substituído mantendo o histórico. Confirme antes de excluir de fato.
• Para conclusões sensíveis, de alto impacto, médicas/jurídicas/financeiras ou de definição de identidade, se as evidências forem ambíguas, pergunte ao usuário antes de escrever.
• Diferencie "trabalho de julgamento" de "operações mecânicas": julgamento (decidir o que destilar, mesclar, avaliar se um conteúdo é importante/deve ser mantido/excluído) deve ser feito diretamente pelo agente, após entender o significado semântico — essa é a razão de ser desta skill; scripts não têm capacidade de julgamento. Operações mecânicas (filtrar por regras claras, contar, renomear, converter formatos e, conforme a base cresce, infraestrutura como busca local/índice/banco vetorial) devem ser feitas com ferramentas de linha de comando ou scripts e, preferencialmente, dessa forma.
• Ao executar operações mecânicas, prefira métodos que não exijam ler o conteúdo completo do arquivo no contexto do agente (grep/sed/awk/scripts únicos, execução cega) e valide os resultados com contagens e diffs (wc -l, grep -c, git diff --stat), em vez de ler o arquivo inteiro ou imprimir o texto completo para conferência — economiza tokens e o resultado é igualmente confiável. Somente leia antes de agir se a operação exigir julgamento (por exemplo, ao revisar e decidir se um conteúdo deve ser excluído).
• Não inclua arquivos de orquestração do agente. AGENTS.md, CLAUDE.md ou estratégias de subagentes de diferentes plataformas devem ser mantidos pelo projeto do usuário.