reconcile-memory

/reconcile-memory — Resolução de Contradições no Vault

Objetivo: o vault nunca deve conter duas notas que se contradizem sem saber que se contradizem. Cada contradição é resolvida ou documentada como questão aberta. Complementa /consolidate-memory (que faz dedup/archive) com uma capacidade nova: detecção semântica de conflitos.

Inspiração: /obsidian-reconcile de eugeniughelbur/obsidian-second-brain (MIT). Adaptado ao nosso vault (D:\claude-memory\) e à divisão mecânico/semântico do memory-curator.

Quando usar:

• após várias sessões no mesmo projeto (decisões podem ter evoluído sem o decisions.md ser atualizado)
• antes de um /resume importante (garantir que o contexto injetado não está contraditório)
• quando o memory-curator sinalizar candidatos em .curator-pending.md
• antes de release major (limpar decisões superadas)

Quando NÃO usar:

• vault recém-criado (< 10 decisões/logs — nada pra contradizer)
• logo após um /reconcile-memory sem novas sessões

Skill ativada: Context Manager (skill 08) em modo "vault truth-keeper".

Pré-requisito inviolável

Antes de QUALQUER leitura, aplicar policies/memory-write-rules.md:

• False absence: nunca conclua "não há contradição" sem varredura exaustiva. Enumere, não amostre.
• No fabrication: nunca invente uma contradição que não existe pra parecer produtivo. Zero contradições é um resultado válido.

Processo

Passo 1 — Snapshot (igual ao consolidate)

VAULT="${1:-D:/claude-memory}"
TS=$(date +%Y-%m-%d-%H%M)
if [ -d "$VAULT/.git" ]; then
  cd "$VAULT" && git add -A && git commit -m "snapshot pre-reconcile $TS"
else
  cp -r "$VAULT" "$VAULT.bak.$TS"
fi

Passo 2 — Varredura de contradições (4 eixos)

Argumento opcional $ARGUMENTS = tópico/projeto pra focar. Sem ele, varre o vault todo. Para escala, despachar subagents em paralelo (um por eixo):

• Decisões revertidas (architecture/<projeto>/decisions.md): pares de decisões sobre o mesmo tópico onde a mais nova reverte a antiga, mas a antiga nunca foi marcada superseded. Ex: "decidimos usar REST" depois "migramos pra GraphQL" sem atualizar a primeira.
• Fatos stale entre logs: claims factuais em logs diferentes que se contradizem (versão de lib, status de feature, nome de arquivo). O mais recente geralmente vence.
• Decisões superadas sem ref: decisões status: active que um log posterior descreve como abandonada/mudada.
• Recency drift: claim externo sem (as of ...) que um log mais novo atualiza com data — flag pra adicionar o marker.