Arquivos de Memória PARA

Memória persistente baseada em arquivos, organizada pelo método PARA de Tiago Forte. Três camadas: um grafo de conhecimento, notas diárias e conhecimento tácito. Todos os caminhos são relativos a $AGENT_HOME.

Três Camadas de Memória

Camada 1: Grafo de Conhecimento ($AGENT_HOME/life/ -- PARA)

Armazenamento baseado em entidades. Cada entidade recebe uma pasta com dois níveis:

1. summary.md -- contexto rápido, carrega primeiro.
2. items.yaml -- fatos atômicos, carrega sob demanda.

$AGENT_HOME/life/
  projects/          # Active work with clear goals/deadlines
    <name>/
      summary.md
      items.yaml
  areas/             # Ongoing responsibilities, no end date
    people/<name>/
    companies/<name>/
  resources/         # Reference material, topics of interest
    <topic>/
  archives/          # Inactive items from the other three
  index.md

Regras PARA:

• Projetos -- trabalho ativo com um objetivo ou prazo. Mover para arquivos quando concluído.
• Áreas -- contínuas (pessoas, empresas, responsabilidades). Sem data de término.
• Recursos -- material de referência, tópicos de interesse.
• Arquivos -- itens inativos de qualquer categoria.

Regras de Fatos:

• Salvar fatos duráveis imediatamente em items.yaml.
• Semanalmente: reescrever summary.md a partir de fatos ativos.
• Nunca excluir fatos. Substituir em vez disso (status: superseded, adicionar superseded_by).
• Quando uma entidade se torna inativa, mover sua pasta para $AGENT_HOME/life/archives/.

Quando criar uma entidade:

• Mencionado 3+ vezes, OU
• Relação direta com o usuário (família, colega de trabalho, parceiro, cliente), OU
• Projeto ou empresa significativa na vida do usuário.
• Caso contrário, anotar nas notas diárias.

Para o esquema YAML de fatos atômicos e regras de decaimento da memória, veja references/schemas.md.

Camada 2: Notas Diárias ($AGENT_HOME/memory/YYYY-MM-DD.md)

Linha do tempo bruta de eventos -- a camada "quando".

• Escrever continuamente durante conversas.
• Extrair fatos duráveis para a Camada 1 durante os "heartbeats".

Camada 3: Conhecimento Tácito ($AGENT_HOME/MEMORY.md)

Como o usuário opera -- padrões, preferências, lições aprendidas.

• Não fatos sobre o mundo; fatos sobre o usuário.
• Atualizar sempre que aprender novos padrões operacionais.

Escreva -- Sem Notas Mentais

A memória não sobrevive a reinícios de sessão. Arquivos sim.

• Quer lembrar algo -> ESCREVA EM UM ARQUIVO.
• "Lembre-se disso" -> atualizar $AGENT_HOME/memory/YYYY-MM-DD.md ou o arquivo da entidade relevante.
• Aprender uma lição -> atualizar AGENTS.md, TOOLS.md, ou o arquivo de habilidade relevante.
• Cometer um erro -> documentá-lo para que o futuro você não o repita.
• Arquivos de texto no disco são sempre melhores do que mantê-los em contexto temporário.

Recuperação de Memória -- Use qmd

Use qmd em vez de grepar arquivos:

qmd query "what happened at Christmas"   # Semantic search with reranking
qmd search "specific phrase"              # BM25 keyword search
qmd vsearch "conceptual question"         # Pure vector similarity

Indexe sua pasta pessoal: qmd index $AGENT_HOME

Vetores + BM25 + reranking encontram coisas mesmo quando a redação difere.

Planejamento

Mantenha os planos em arquivos com timestamp em plans/ na raiz do projeto (fora da memória pessoal para que outros agentes possam acessá-los). Use qmd para pesquisar planos. Planos ficam desatualizados -- se um plano mais novo existir, não se confunda com uma versão mais antiga. Se notar desatualização, atualize o arquivo para anotar o que ele foi substituído.