Cofre Ancorado

Um cofre ancorado é um repositório Markdown de três camadas onde cada afirmação compilada pode ser rastreada até uma fonte imutável e cada página pode ser verificada quanto à desatualização com um git diff. Ele precisa de um repositório git e nada mais. A convenção vem do projeto llm-wiki-loop, que é uma implementação de referência em vez de uma dependência; esta habilidade ensina o padrão para que funcione com arquivos simples e qualquer agente que esteja na sessão.

Quando Usar

• Um agente compila notas, artigos, transcrições, logs ou código em páginas wiki nas quais sessões posteriores dependem.
• Uma página cita números, datas ou citações, e um leitor deve ser capaz de verificar cada um em relação à sua fonte.
• Páginas descrevem código, e reler a base de código a cada sessão para verificar se ainda são válidas é muito caro.
• O conhecimento deve ser corrigido sem perder o histórico: páginas substituídas são arquivadas, nunca excluídas.

Estado da sessão, filas de tarefas e continuidade da conversa são um problema diferente; use os plugins de gerenciamento de contexto ou condutor para esses. Esta habilidade trata de proveniência e desvio em um armazenamento de conhecimento durável.

As três camadas

Dois arquivos ficam na raiz do cofre. index.md é o mapa de todas as páginas atuais. log.md é um registro somente de adição do que mudou e por quê. Ambos mudam no mesmo commit que a página que eles descrevem.

Contrato do cabeçalho da página

Cada página wiki/ começa com um bloco de cabeçalho:

# Authentication architecture

> Raw: [raw/notes/auth-v1.md](../raw/notes/auth-v1.md), [raw/adr/0007-jwt.md](../raw/adr/0007-jwt.md)
> Fingerprint: git:5b237fa
> Monitored: src/auth/jwt.ts, src/auth/session.ts, package.json
> Status: Current

• Raw: lista todas as fontes das quais a página foi compilada. Afirmações inline também se vinculam à sua fonte específica: Tokens expire after 15 minutes ([raw/adr/0007-jwt.md](../raw/adr/0007-jwt.md)).
• Fingerprint: é o hash curto do commit contra o qual a página foi compilada.
• Monitored: lista os caminhos de código que a página descreve. Uma alteração em qualquer um deles após a impressão digital significa que a página pode estar desatualizada.
• Status: é Current, Outdated (código monitorado movido), ou Disputed (uma fonte mais nova contradiz a página).

Regra de ancoragem

Uma página compilada afirma apenas o que uma fonte suporta, e cada número, data ou citação aparece literalmente na fonte vinculada. Uma síntese afirma ser uma e vincula suas entradas. Uma lacuna nas fontes é escrita na página como uma lacuna em vez de ser preenchida por adivinhação.

Verifique mecanicamente: para cada afirmação vinculada, pesquise no arquivo bruto vinculado a figura exata ou a frase citada. Uma falha é um erro de ancoragem e bloqueia o commit. O script em references/details.md faz isso para um cofre inteiro.

Detecção de desvio

Compare a impressão digital com a árvore atual em vez de reler o código monitorado:

git diff --stat 5b237fa..HEAD -- src/auth/jwt.ts src/auth/session.ts package.json

Saída vazia significa que a página ainda descreve o código contra o qual foi compilada. Qualquer saída significa recompilar: releia apenas os arquivos alterados, atualize a página e aplique a nova impressão digital. A verificação é executada em milissegundos e não gasta tokens do modelo.

Fluxo de trabalho

1. Ingestão. Coloque novo material em raw/ sob um nome de arquivo datado ou com origem. Nunca reescreva um arquivo bruto existente; adicione um novo ao lado dele.

2. Compilação. Escreva ou atualize a página wiki/ com o bloco de cabeçalho, um link de origem em cada afirmação e a impressão digital do commit em que o código foi lido.

3. Verificação. Execute a verificação de ancoragem e a verificação de desvio antes de confirmar. Corrija falhas na fonte; não enfraqueça uma afirmação para fazer a verificação passar.

4. Coleta de lixo. Quando o desvio ou uma fonte contraditória aparecer e a página não for recompilada agora, altere seu status, mova-a para archive/ e registre o motivo:

   > Status: Outdated
   > Reason: src/auth/session.ts changed after git:5b237fa; see log.md 2026-09-01
   

…