/ingest
Toma algo en bruto y conviértelo en conocimiento consultable. Es la operación que hace crecer la memoria en lugar de dejarla acumular.
La regla que no se toca: el bruto nunca se modifica. No lo reescribes, no lo renombras, no lo reordenas, ni lo eliminas aunque sea feo o duplicado. Cuando dentro de seis meses una página de la wiki parezca incorrecta, la única forma de verificarla será volver a la fuente. Si tocaste la fuente, no hay nada a lo que volver.
Qué haces, en orden
1. Encuentra el material
Mira memoria/grezzo/. Si el usuario indicó un archivo, ese. Si no indicó nada, toma el que aún no figure en memoria/wiki/index.md.
Si grezzo/ está vacío, dilo y detente: "El bruto está vacío. Pon algo dentro y vuelve a llamarme."
2. Léelo
| Tipo | Cómo |
|---|---|
.md, .txt, .csv, .json | Read |
.pdf | Read lee los PDF directamente |
| Una URL | WebFetch |
| Audio, video | necesita una transcripción: pide al usuario que la ponga en el bruto, no intentes adivinar el contenido por el nombre del archivo |
Si un formato no sabes abrirlo, dilo y continúa con los demás. No finjas haberlo leído ni resumas un archivo por su título.
3. Escribe las páginas
Una fuente se convierte en una o más páginas dentro de memoria/wiki/, no en un único resumen. Una página por cada cosa de la que se hable: un cliente, un concepto, una decisión, un proceso.
Cómo debe ser una página:
- corta: si supera una pantalla, son dos páginas
- autónoma: se entiende sin haber leído la fuente
- enlazada: nombra las otras páginas con
[[nombre-archivo]]dentro de las frases, no en una lista al final - con la fuente al inicio: de qué archivo del bruto proviene, para que sea verificable
El nombre del archivo es la regla que lo sostiene todo. Una página se llama como su tema, en minúsculas y con guiones: el cliente Rossi Srl está en rossi-srl.md, y dondequiera que lo nombres escribes [[rossi-srl]]. El enlace es siempre el nombre del archivo sin .md. Así, seguir un enlace significa abrir ese archivo, sin tener que adivinarlo, y eso es lo que te permite navegar la memoria saltando de una página a otra. Si el enlace y el nombre del archivo no coinciden, el salto se rompe.
Esta de abajo es la página rossi-srl.md:
---
fonte: memoria/grezzo/call-rossi-2026-03-14.md
data: 2026-03-14
---
Rossi Srl paga a 28 días y siempre ha sido puntual. En la llamada de marzo
[[marco]] pidió trasladar la facturación a fin de mes porque su
departamento de compras cierra el ciclo el día 30. También afecta a [[fatturazione]].
Si ya existe una página sobre ese tema, actualízala en lugar de crear una segunda. Dos páginas sobre el mismo cliente es la forma en que una wiki deja de servir.
Si la fuente nueva contradice lo que había, no borres lo antiguo: escribe que ha cambiado y desde cuándo. "En marzo pagaba a 28 días, desde julio pasó a 60" vale más que reescribir "60" y ya, porque el cambio es a su vez información: la próxima vez que ese cliente exceda el plazo sabrás si es una anomalía o su nueva normalidad. Señalar las contradicciones es la mitad del motivo por el que sirve la memoria.
4. Actualiza el índice y el registro
Siempre, y en la misma pasada.
memoria/wiki/index.md: una línea por página, con el ancla. Una página que no está en el índice no la encuentra nadie.
memoria/wiki/log.md: una entrada al principio.
## [2026-03-14 16:20] ingest | Transcripción llamada Rossi del 14 de marzo
Tres páginas: [[rossi-srl]] (nueva), [[fatturazione]] y [[marco]] (actualizadas).
El formato de la primera línea, ## [data] tipo | título, no es un capricho: mantiene el registro legible con un solo comando (grep "^## \[" memoria/wiki/log.md), cuando haya cien entradas.
5. Di lo que has hecho
Tres líneas. Qué has leído, cuántas páginas has tocado, y una cosa que has aprendido y antes no estaba. La última es la que hace que el usuario entienda que ha servido para algo.
Los errores que no debes cometer
| Error | Por qué es un error |
|---|---|
| Modificar o renombrar un archivo del bruto | Pierdes lo único verificable que tienes |
| Una página única con todo dentro | No se reutiliza, no se enlaza, no se actualiza |
Páginas sin [[enlaces]] | Se convierten en una carpeta de archivos, no en una memoria |
| Un enlace que no coincide con el nombre del archivo | Seguirlo se convierte en adivinar, y la navegación se rompe |
| Reescribir un dato antiguo encima del nuevo sin decir que ha cambiado | Pierdes el cambio, que era la información |
| Resumir un archivo que no has podido abrir | Parece verdad y es inventado |
Escribir las páginas y olvidar el index.md | Las has escrito para nada |
| Añadir una segunda página sobre un tema que ya tiene una | Desde ahora, ninguna de las dos es fiable |