TheElephantCoder/memory-sync

Sincronização de memória

Mantém as sessões de começarem frias.

Estrutura

memory/
  MEMORY.md        # curada, sempre carregada, manter abaixo de 8k
  SOUL.md          # quem é o agente
  USER.md          # quem é você
  sessions/        # notas brutas por sessão, limpas após ~30d
  decisions/       # pequenos ADRs
  tiers/
    hot.md         # sempre carregado
    warm.md        # carregado por palavra-chave
    cold/          # somente leitura explícita

Ciclo de vida

Início: leia MEMORY.md e tiers/hot.md. Talvez warm.md se a tarefa corresponder. Não leia sessions/ a menos que esteja investigando o histórico. Deve levar menos de 15s no total.

Fim: execute harness memory sync ou deixe o gancho de saída fazer isso. Ele destila o log da sessão em MEMORY.md, poda itens antigos e adiciona um ADR se você tomou uma decisão real.

Dicas

• MEMORY.md é curada, não apenas anexada. Mantenha abaixo de 8k tokens, edite cirurgicamente.
• Se você considerou 2 ou mais abordagens e escolheu uma, escreva um pequeno decisions/ADR-###.md.
• Sem segredos na memória, eles serão redigidos de qualquer forma.

Comandos:

harness memory show
harness memory edit
harness memory prune --dry-run
harness memory sync --auto