Memoria

La memoria es cómo los agentes de MadoHub recuerdan cosas entre sesiones. Sin ella, cada terminal nuevo supone que un agente reaprende tus convenciones, tu stack, tu estilo de código y las decisiones que tomaste la semana pasada. La memoria sobrevive entre sesiones y proyectos, así un agente retoma donde lo dejó el anterior en lugar de empezar de cero.

La memoria es independiente del historial de chat de una sesión. El historial de chat es la conversación que estás teniendo ahora mismo; la memoria es el fondo duradero sobre el que el agente se apoya. Tú mantienes el control de lo que se recuerda: la suposición de un agente sobre lo que vale la pena conservar va primero a una cola de revisión, y tú la apruebas antes de que aterrice en memoria a largo plazo.

Qué puedes hacer con esto

• Guardar seis tipos de cosas — preferencias, hechos, decisiones, patrones, postmortems y eventos. Cada entrada se etiqueta con su tipo para que el panel de Memoria pueda filtrarla y etiquetarla limpiamente.
• Organizar por namespace — mantén la memoria específica de un persona separada de la memoria específica de un proyecto. Un agente que recupera una convención de proyecto no se traerá las preferencias personales de cada persona.
• Revisar antes de que cuaje — cada memoria candidata se sienta en una cola pendiente para tu aprobación. Edita la redacción, cambia el tipo, recházala o apruébala tal cual.
• Auto-inyectar memoria relevante — activa el recall automático y las entradas que coincidan se antepone a cada conversación nueva, así preferencias y decisiones relevantes afloran sin que el agente tenga que pedirlas.
• Buscar manualmente — los agentes pueden llamar a recall explícitamente con una consulta de texto completo cuando necesitan algo concreto.

Cómo usarlo

1. Abre Configuración → Memoria para llegar al panel de Memoria.
2. Revisa los candidatos en la pestaña Pending review. Para cada uno puedes:
   • Approve tal cual
   • Edit el contenido o el tipo, y luego aprobar
   • Reject
   • Volver al turno de conversación original que la produjo
3. Navega y gestiona las entradas aprobadas en la pestaña Approved, agrupadas por namespace. Edita, borra o añade memoria nueva manualmente desde aquí.
4. Activa o desactiva la inyección automática de recall para elegir si la memoria que coincide se auto-antepone a las conversaciones nuevas, o solo aparece cuando un agente llama a recall explícitamente.
5. Opcional: en la sección Advanced, activa políticas como auto-aprobar candidatos que se han visto suficientes veces con suficiente confianza.

Casos de uso comunes

• "Usamos pnpm, nunca npm." — una preferencia que un agente puede recuperar en cada sesión nueva en lugar de descubrirla fallando primero.
• "Decidimos mantener auth en el monolito, no separarlo." — una decisión que debería seguir reapareciendo para que los agentes futuros no la re-litigien.
• "El test inestable en payments.spec lo causa una race en el mock clock." — un postmortem que vale la pena recordar la próxima vez que alguien toque ese archivo.
• "Las respuestas de la API de este proyecto son camelCase JSON." — un hecho que el agente incorpora siempre que genere o edite código de API en ese espacio de trabajo.

Consejos y buenas prácticas

• Revisa la cola pendiente con regularidad. Una decision o postmortem errónea o caducada es peor que una que falte, porque seguirá reapareciendo en futuros recalls.
• Usa los namespaces deliberadamente — acota las convenciones de proyecto al namespace workspace: para que no se filtren a otros proyectos.
• Fija las entradas que nunca quieras que se auto-sobrescriban; las entradas fijadas afloran primero en el recall.
• Si la memoria empieza a sentirse ruidosa, desactiva la inyección automática y deja que los agentes llamen a recall explícitamente solo cuando lo necesiten.

Funciones relacionadas

• MadoAgent — el panel donde los agentes más usan la memoria.
• Configuración — donde viven el panel de Memoria y sus políticas.

Limitaciones

• Las consultas de recall necesitan al menos 3 caracteres — las más cortas se rechazan para que el agente sepa reformular en lugar de no recibir nada en silencio.
• Los candidatos se auto-archivan tras 30 días de inactividad, así que no dejes la cola sentada para siempre.
• La memoria no sustituye al historial de chat; es una capa más pequeña y curada de hechos duraderos.