/ingest
Pega uma coisa bruta e transforma em conhecimento consultável. É a operação que faz a memória crescer em vez de acumular.
A regra que não se toca: o bruto nunca é modificado. Não o reescreve, não o renomeia, não o reorganiza, não o apaga nem quando é feio ou duplicado. Quando daqui a seis meses uma página da wiki parecer errada, o único modo de verificá-la será voltar à fonte. Se você tocou na fonte, não há mais nada a que voltar.
O que fazer, em ordem
1. Encontre a coisa
Olhe em memoria/grezzo/. Se o usuário indicou um arquivo, use esse. Se não indicou nada, pegue aquele que ainda não consta em memoria/wiki/index.md.
Se grezzo/ estiver vazio, diga e pare: "O bruto está vazio. Coloque algo lá e me acione novamente."
2. Leia-a
| Tipo | Como |
|---|---|
.md, .txt, .csv, .json | Read |
.pdf | Read lê PDFs diretamente |
| Uma URL | WebFetch |
| Áudio, vídeo | precisa de uma transcrição: peça ao usuário para colocar no bruto, não tente adivinhar o conteúdo pelo nome do arquivo |
Se um formato não puder ser aberto, diga e siga em frente com os outros. Não finja que leu e não resuma um arquivo pelo título.
3. Escreva as páginas
Uma fonte se torna uma ou mais páginas dentro de memoria/wiki/, não um resumo único. Uma página por assunto: um cliente, um conceito, uma decisão, um processo.
Como deve ser uma página:
- curta: se passar de uma tela, são duas páginas
- autônoma: entende-se sem ter lido a fonte
- ligada: mencione as outras páginas com
[[nome-do-arquivo]]dentro das frases, não numa lista no final - com a fonte no topo: de qual arquivo do bruto veio, para ser verificável
O nome do arquivo é a regra que sustenta tudo. Uma página se chama como seu assunto, em minúsculas e com hífens: o cliente Rossi Srl está em rossi-srl.md, e onde quer que o mencione escreva [[rossi-srl]]. O link é sempre o nome do arquivo sem .md. Assim, seguir um link significa abrir aquele arquivo, sem ter que adivinhar, e é o que permite navegar pela memória pulando de uma página para outra. Se o link e o nome do arquivo não coincidirem, o salto se quebra.
Abaixo está a página rossi-srl.md:
---
fonte: memoria/grezzo/call-rossi-2026-03-14.md
data: 2026-03-14
---
Rossi Srl paga em 28 dias e sempre foi pontual. Na call de março
[[marco]] pediu para mudar o faturamento para o fim do mês porque o
setor de compras deles fecha o ciclo no dia 30. Também afeta [[faturamento]].
Se uma página sobre esse assunto já existe, atualize-a em vez de criar uma segunda. Duas páginas sobre o mesmo cliente são a forma como uma wiki deixa de servir.
Se a nova fonte contradiz o que estava lá, não apague o antigo: escreva que mudou e desde quando. "Em março pagava em 28 dias, desde julho passou para 60" vale mais do que reescrever "60" e pronto, porque a mudança é por si só uma informação: na próxima vez que aquele cliente atrasar, você saberá se é uma anomalia ou a nova normalidade. Sinalizar as contradições é metade do motivo pelo qual a memória serve.
4. Atualize o índice e o log
Sempre, e na mesma passada.
memoria/wiki/index.md: uma linha por página, com o link. Uma página que não está no índice ninguém encontra.
memoria/wiki/log.md: uma entrada no topo.
## [2026-03-14 16:20] ingest | Transcrição call Rossi de 14 de março
Três páginas: [[rossi-srl]] (nova), [[faturamento]] e [[marco]] (atualizadas).
O formato da primeira linha, ## [data] tipo | título, não é um capricho: mantém o log legível com um único comando (grep "^## \[" memoria/wiki/log.md), quando forem cem entradas.
5. Diga o que fez
Três linhas. O que leu, quantas páginas tocou, e uma coisa que aprendeu e que antes não estava lá. A última é a que faz o usuário entender que serviu para algo.
Os erros a não cometer
| Erro | Por que é um erro |
|---|---|
| Modificar ou renomear um arquivo do bruto | Perde a única coisa verificável que você tem |
| Uma página única com tudo dentro | Não se reutiliza, não se liga, não se atualiza |
Páginas sem [[links]] | Viram uma pasta de arquivos, não uma memória |
| Um link que não coincide com o nome do arquivo | Segui-lo se torna adivinhar, e a navegação se quebra |
| Reescrever um dado antigo por cima do novo sem dizer que mudou | Perde a mudança, que era a informação |
| Resumir um arquivo que não conseguiu abrir | Parece verdadeiro e é inventado |
Escrever as páginas e esquecer index.md | Escreveu-as em vão |
| Adicionar uma segunda página sobre um assunto que já tem uma | Daqui em diante, nenhuma das duas é confiável |