Documentos

¿Instalado pero aparentemente sin uso? En las plataformas que aceptan hooks, la memoria se envía al agente y no es necesario enseñarle nada. En aquellas que no lo hacen, la configuración escribe una sección de memoria en el archivo de contexto de la plataforma, para que el agente sepa cómo acceder a ella. Si la memoria parece estar conectada pero el agente nunca la consulta, ese archivo es lo primero que hay que revisar.

Lo que escribe en Claude Code

En Claude Code, el pip install (brethof-brain install-hooks) mantiene un bloque gestionado en tu CLAUDE.md, reescrito al inicio de cada sesión. Es un puntero, no una copia de la enseñanza — indica a tu agente que la memoria es el Brain, cómo llegar a ella, y que cuando dices «recuerda esto» va al Brain, no a los archivos de memoria propios de Claude Code en una máquina. La enseñanza real llega al inicio de la sesión. Nunca toca nada fuera del bloque: tus propias convenciones siguen siendo tuyas. Para desactivarlo, establece BRETHOF_BRAIN_NO_CLAUDE_MD=1. El plugin nunca lo escribe: con una instalación por plugin, pega el bloque del README del plugin en ~/.claude/CLAUDE.md, o pídeselo a tu agente.

Comandos y versiones

El plugin de Claude Code incluye tres comandos: /recall (buscar ahora), /onboard (el primer minuto de un proyecto) y /curate (cerrar una sesión). No hay nada que ejecutar manualmente; la memoria organiza y ordena los registros a medida que llegan.

Lo que cambia es la forma en que hablas con tu agente. Ahora puedes decir cosas como ¿Qué decidimos respecto a los intentos de pago? or Recuerde que la caja de montaje es la que tiene el certificado antiguo. — En lenguaje sencillo, durante la conversación. Tu agente elige la herramienta adecuada; tú nunca nombras ninguna.

A lo que puede recurrir su agente

No necesita esta lista. Está aquí para que sepa qué es posible cuando pide algo específico.

• Encontrar cosas — Busca en tu memoria seleccionada, o en el historial de conversaciones original, cuando necesites las palabras exactas de una sesión pasada.
• Recuerda cosas — Guardar un hecho en un proyecto, o en la capa compartida que abarca a todos ellos.
• Enseñar cosas — Guarde una regla, o inicie un proyecto con una frase que describa lo importante en él.
• Inspeccionar cosas — listar tus proyectos, listar lo que sabe un proyecto, listar sus reglas o leer un registro.
• Eliminar elementos — eliminar un registro individual. La eliminación de una frase específica o de todo un proyecto se realiza en el panel de la cuenta.
• Revisar el registro — ver la lista de intenciones pendientes de un proyecto, eliminar las filas a medida que las decida.
• Mantener los manuales de juego — Guardar un procedimiento una vez, para toda la cuenta; recuperarlo y ejecutarlo desde cualquier proyecto; listar lo que existe; eliminar lo que ya no se utiliza.

Una cosa que un agente no puede hacer deliberadamente: Eliminar todo un proyecto. Ese único acto llega al archivo original, por lo que permanece en el panel de tu cuenta, donde una persona escribe el nombre.

Las reglas son la forma de evitar repetirse: las convenciones, restricciones y correcciones adquiridas con esfuerzo que tus agentes nunca deben olvidar. Las buenas reglas suenan como leyes: “nunca despliega los viernes”, “este proyecto utiliza tabulaciones, no espacios”, “el nombre del cliente se escribe Brethof, nunca Brefoth”. Breves, claras y válidas incluso el mes que viene.

Pídale a su agente que guarde una regla, y le preguntará una cosa: ¿es esto para todo lo que hace, o solo para este proyecto?

Esa tercera opción es la importante, y se elige con más frecuencia que las otras dos. Una regla es costosa: ocupa espacio en cada sesión para siempre, y enseña al curador qué es lo importante. Archivar conocimientos ordinarios como reglas es precisamente cómo la memoria se llena de elementos insignificantes hasta que nada destaca.

Las reglas enseñan al curador, no solo al agente

Un proyecto con un puñado de reglas claras recuerda notablemente mejor que uno sin ellas, porque las reglas le indican a su curador qué es lo importante allí. Guarda una y, en cuestión de minutos, la memoria de ese proyecto habrá vuelto a aprender cuál es.

Mantenerlos afilados

Una regla debe ser lo suficientemente breve como para poder pronunciarla en voz alta; si no cabe, probablemente se trate de conocimiento disfrazado de regla. Combine las duplicadas en una sola y elimine las reglas que ya no son relevantes; nada las depura por usted, porque no se debe permitir que nada más decida cuáles son sus leyes. Una docena de reglas en las que uno cree valen más que cincuenta que ya dejó de leer.

Proyectos en la práctica

La única decisión real es cómo dividirlos: uno por código, cliente o proyecto es el patrón que funciona. Demasiados y sin relación entre sí, los trabajos se mezclan; demasiados y el contexto se dispersa. Empezar un proyecto con un propósito en una sola oración —qué es y qué debe recordarse al respecto— es el minuto de mayor valor que se puede dedicar. Esto enseña al responsable desde el primer día, en lugar de dejar que infiera sus intenciones a partir de fragmentos.

Tres cosas diferentes se miden de manera distinta, y vale la pena saber cuál es cuál. Grabación Está limitado por el almacenamiento. Aprender Está limitado por su asignación mensual. Recordar No está limitado por nada: la búsqueda, las actualizaciones de sesión y la recuperación de información según cada solicitud siguen funcionando mientras su memoria esté en nuestros sistemas en línea.

Si la suscripción vence

Brain se pausa de inmediato; no existe un período de gracia. Su memoria se archiva después del día 7; se le envía una advertencia alrededor del día 23, y se elimina el día 30. Una cuenta activa y de pago nunca se ve afectada. El calendario completo, junto con los correos electrónicos correspondientes, se encuentra en la Política de Privacidad.

El vacío que deja un límite, y por qué nunca lo llenamos

Aunque existe un límite, no se forman nuevos recuerdos. Eso deja un vacío en tu memoria correspondiente a ese período. No volvemos a llenarlo después.. Esa es una ley de diseño deliberada, y deberías conocerla.

Un recuerdo solo se forma a partir de una conversación. Como sucede.. Un registro escrito más tarde, a partir de información ya antigua de varias semanas, sobrescribiría lo que ha sido cierto desde entonces; y su memoria comenzaría a afirmar con certeza cosas que ya no son verdaderas. Preferimos dejar un vacío en lugar de inventar una mentira con total convicción.

En resumen: la brecha es permanente en cuanto a la memoria. Tu historial de conversaciones sin procesar de ese período sigue estando allí y puede buscarse, por lo que los registros no se pierden; solo la capa procesada presenta esa deficiencia. Cuanto más tiempo funcione el límite, más se aleja tu memoria de la tarea que realmente estás realizando. Y no se repara automáticamente cuando reinicias: tu agente corrige las memorias obsoletas a medida que las encuentra, y la memoria armoniza los nuevos registros con los antiguos a medida que llegan, descartando aquellos que contradicen tus memorias más recientes. Ambos procesos avanzan hacia adelante, nunca hacia atrás.

Nadie se queda excluido en silencio. Recibes un correo electrónico cuando te acercas a un límite y otro cuando este entra en vigor, una notificación dentro de la sesión de tu agente cuando comienza, y una breve línea en cada prompt mientras el límite esté activo.