🧠Memória

Claude não tem memória entre conversas – exceto o que está escrito em arquivos. O Harness Maxxing organiza essa memória em arquivos markdown simples que o Claude Code carrega automaticamente.

Três níveis

/root/maxxing/
  CLAUDE.md  memory.md                         workspace (global)
  projects/acme/
    CLAUDE.md  memory.md                       project acme
    topics/blog/
      CLAUDE.md  memory.md                     topic acme / blog

O Claude Code carrega todos os CLAUDE.md da pasta da sessão até a raiz do workspace, e cada CLAUDE.md contém a linha @memory.md, que importa o arquivo de memória dele. Uma sessão em projects/acme/topics/blog/ lê, portanto, todos os seis arquivos.

Arquivo	Contém	Quem escreve
`CLAUDE.md`	instruções estáveis: o que é o projeto/tópico e como trabalhar nele. O primeiro parágrafo abaixo do título é a descrição exibida na interface.	você (ou o Claude, quando você pede)
`memory.md`	o que foi aprendido: decisões, preferências, estado do trabalho, caminhos e URLs úteis	Claude, por meio da skill `memory`

O que vai em cada lugar

Memória do tópico (o mais comum): o estado desta linha de trabalho, suas decisões e convenções.
Memória do projeto: o que vale para todos os tópicos do projeto.
Memória global: suas preferências e regras válidas em qualquer lugar (idioma, tom, "nunca fazer push sem perguntar"...). Mantenha-a curta – ela é carregada em todas as sessões.

Não vão para a memória: conversa fiada, perguntas pontuais, logs passo a passo e nunca segredos (coloque-os em Configurações -> Chaves e mencione apenas o nome da chave).

As skills de memória

memory – ao final de uma conversa importante, o Claude registra fatos duradouros no arquivo certo: tópicos curtos e datados, substituindo fatos desatualizados em vez de acumulá-los. Você também pode pedir explicitamente: "lembre que ...".
memory-compaction – mantém os arquivos curtos e consistentes. Uma tarefa agendada "Memory compaction" a executa todos os dias às 05:00 (veja Crons; ela começa assim que a configuração inicial terminar e o Claude estiver conectado). Ela age em arquivos maiores que o limite de linhas (Configurações -> Memória, 200 linhas por padrão) ou que estejam redundantes, contraditórios ou desatualizados: ela une duplicatas, resume o histórico antigo e reordena cada arquivo (regras e preferências, estado atual, decisões, referências, contexto). Ela só edita arquivos memory.md.

Limpeza do segundo cérebro (Configurações -> Memória)

Tamanho máximo por arquivo: o limite de linhas citado acima (ou Sem limite).
Limpar agora: inicia a compactação imediatamente, em uma sessão na raiz do workspace que você pode acompanhar.
A lista mostra cada memory.md com o número de linhas; os arquivos acima do limite aparecem em vermelho.
Pelo shell: maxxing memory exibe a mesma lista.

Editando a memória você mesmo

Os arquivos de memória são arquivos comuns: abra-os em Arquivos, edite e salve. As alterações valem a partir do próximo turno de todas as sessões nesse escopo.

Backup

A memória é a coisa mais valiosa do servidor. Ative o Backup para enviá-la todos os dias a um repositório privado do GitHub, com histórico.