lembrar

Você vai responder uma pergunta sobre o passado do projeto. A informação provavelmente existe e está indexada — só não está no seu contexto, porque o acervo frio nunca entra no boot. Seu trabalho é fazer o segundo movimento: consultar, ler a fonte, e responder.

O bug que esta skill existe para matar

O usuário pergunta "você lembra do X?". Você olha o contexto, não acha, e responde "não".

A resposta está errada — não por má-fé, mas porque você respondeu com o corpus quente (MEMORY.md, que carrega sozinho) sobre uma pergunta cuja resposta vive no corpus frio (handovers antigos, MEMORY_ARCHIVE.md), que está indexado e a um comando de distância.

REGRA DURA: não responda "não lembro" / "não tenho essa informação" sobre o passado do projeto antes de rodar a query. A ausência no contexto não é evidência de ausência no acervo — é só evidência de que o acervo é frio. Se depois da query não houver hit, aí sim diga que não achou, e diga onde procurou.

Passo 1 — Resolva o projeto (barato, sem cerimônia)

Default: o projeto do diretório atual. O --project aceita parte do slug, então na prática o nome da pasta do projeto basta.

Por que isto NÃO é o /retomar. Lá, projeto errado custa uma sessão inteira e passa despercebido — por isso aquela skill pergunta em vez de chutar. Aqui, projeto errado custa 5 segundos e é óbvio na hora (os hits vêm sem relação com a pergunta). Risco assimétrico, protocolo assimétrico: aqui você chuta o barato e corrige.

Passo 2 — Rode a query CEDO

npx @tbluhm82/o1mem query "<a pergunta do usuário>" -k 5
npx @tbluhm82/o1mem query "<pergunta>" --project <slug> -k 5   # projeto explícito

Instalação a partir do repo, sem npm — chame o Python direto:

python <repo>/rag/o1mem_rag.py --project <slug> query "<pergunta>" -k 5

Três coisas que mudam o resultado:

• Use as palavras do usuário, não as suas. A busca é semântica: reescrever a pergunta em vocabulário técnico afasta do jeito que a coisa foi escrita no handover.
• A primeira query da sessão leva ~45s (carrega o modelo de embeddings). Dispare-a antes de ler qualquer arquivo, não depois — e avise o usuário que está buscando, senão parece travado.
• -k 5, não -k 3. Aqui você não sabe o que procura; hit 4 respondendo é comum.

Passo 3 — Leia os hits pelo TIPO

Os hits vêm marcados. Os dois tipos têm papéis diferentes e confundi-los desperdiça a busca:

• (handover) = acervo frio. É A RESPOSTA, não um índice para outra coisa. Se o trecho responde a pergunta, abra o handover de origem e responda a partir dele. Não descarte um hit por ele não ser project_*.md.
• (memory) = corpus quente. Serve de desempate para decidir qual project_*.md abrir.

Sempre abra a fonte antes de afirmar. O chunk é um trecho: ele diz que o assunto está ali, não necessariamente a conclusão inteira. Responder pelo chunk sem abrir o arquivo é como citar uma frase pelo resultado da busca.

Passo 4 — Responda. Não despeje.

A entrega é uma resposta em prosa, com a fonte citada — não a saída da busca colada.

Sim — [resposta direta].
[o porquê, se o handover registrar]

Fonte: HANDOVER_20260712_143000.md (sessão de 12/jul)

• Citar é obrigatório. Nome do arquivo e data. É o que permite o usuário conferir e o que separa "lembrei" de "inventei".
• Se os hits divergirem (dois handovers dizendo coisas diferentes), diga isso, com as datas — o mais recente costuma ser a decisão que valeu, mas quem decide é o usuário.
• Se não houver hit útil, seja específico no fracasso: "consultei o índice do projeto X (N chunks) e não achei nada sobre isso". Ofereça o próximo passo real — outro projeto, ou reindexar incluindo os handovers (--handovers DIR), que é a causa mais comum de acervo frio faltando no índice.
• Índice vazio ou inexistente (stats retorna 0 chunks): não é "não lembro", é "o acervo desse projeto nunca foi indexado". Diga assim e ofereça rodar npx @tbluhm82/o1mem index --project <slug>.

O que esta skill NÃO é

• Não retoma sessão. Não lê modo de retomada, não abre o RETOMADA, não propõe próximo passo. Pergunta respondida, fim. Se o usuário quer voltar a trabalhar, é /retomar.
• Não escreve memória. Consulta é leitura. Se algo que emergiu merece virar memória, o usuário pede.
• Não indexa. Se o índice está velho ou vazio, ela avisa e oferece — não roda reindexação por conta própria (é lento e o usuário pode estar no meio de outra coisa).
• Não responde "não lembro" sem ter buscado. Esse é o bug que ela existe para matar.