Lo que te llevas de aquí: Recibirás las siete reglas y la sencilla estructura de Vault con las que mantengo el conocimiento de los agentes legible, versionable e independiente de las herramientas.
Índice
En mi opinión, un agente de IA no necesita una memoria mística. Necesita archivos que yo pueda leer, comprobar y reutilizar.
Por eso, el «cerebro» de mis agentes se encuentra en un repositorio privado de Git. En él, Markdown es la fuente de la verdad. Git registra cuándo se ha producido un cambio. Obsidian es mi cómoda interfaz para realizar búsquedas, crear enlaces y tener una visión general, pero no es un requisito imprescindible para acceder a los contenidos.
Si Obsidian no está disponible, abro los archivos en el editor de texto. Si se elimina una herramienta de agente, su adaptador apunta a la misma carpeta. Si se añade un motor de memoria adicional, este puede indexar el contenido, pero no sustituirlo.
Parece sencillo. Para evitar que, en el día a día, vuelva a convertirse en un montón de papeles desordenado, hay que seguir siete reglas estrictas.
Regla n.º 1: Markdown es la fuente de la verdad
Las personas, las normas de trabajo y el conocimiento seleccionado están disponibles en formato Markdown. Una búsqueda semántica, un índice vectorial o un motor de memoria pueden generar una visualización más rápida a partir de ellos. Sin embargo, el resultado derivado nunca es el único elemento que forma parte del conjunto.
Esto no solo evita la dependencia de herramientas, sino que además permite verificar las correcciones. Puedo ver en el comparador qué frase se ha modificado, en lugar de confiar en que un proceso de memoria invisible ya haya guardado lo correcto.
Regla 2: Una persona tiene exactamente un cerebro
No debe ser que un mismo agente tenga una versión ligeramente diferente de su identidad en cada herramienta. Claude, Codex, Gemini y Hermes deben acceder a los mismos archivos canónicos.
De lo contrario, se produce una «desviación de persona»: en una herramienta se aplica una nueva regla de autorización, mientras que en otra sigue vigente la antigua. O bien, una corrección solo se refleja en un mensaje del sistema y se pierde al cambiar de cuenta.
Una fuente evita estas desviaciones silenciosas.
Regla n.º 3: los adaptadores deben ser finos
Un «harness» es la herramienta con la que trabaja un agente. Para ello, cada sistema necesita un puente adecuado: un archivo de configuración, un resumen del proyecto o una indicación del sistema.
Estos adaptadores solo deben hacer tres cosas: encontrar la carpeta correcta del agente, indicar el orden de lectura y solicitar la reescritura en memoria. La identidad, los conocimientos especializados y la gobernanza no se copian en el adaptador.
Cuanto más delgado es el puente, más fácil resulta sustituirlo.
Regla 4: El conocimiento compartido se cita como referencia
Varios agentes necesitan la misma voz de marca, las mismas normas tipográficas o las mismas convenciones de seguridad. Estos contenidos se encuentran en un área común y se cargan desde allí.
No las copio en cada carpeta de agente. Una corrección en la fuente común debería aplicarse a todos los roles afectados. Las copias se desincronizarían ya tras el primer cambio.
Esta regla no tiene nada de espectacular. Precisamente por eso es importante. La infraestructura no es nada atractiva. Pero dura más que las funcionalidades.
Regla 5: Al final de la sesión se guarda
Un sistema de archivos solo recuerda lo que realmente se guarda en los archivos. Por eso, al finalizar una sesión de agente se crea una entrada en la memoria diaria.
Allí no figura el chat completo. Se registran las decisiones, las acciones realizadas, los hallazgos importantes y las cuestiones pendientes. Más adelante, los conocimientos adquiridos a lo largo del día se transforman en conocimientos a largo plazo seleccionados o en una lección duradera.
Sin esta rutina, el repositorio no sería más que una colección estática de mensajes de solicitud.
Regla 6: Los controles de aprobación deben ser explícitos
Cada agente productivo registra lo que puede hacer por sí mismo y en qué casos debe intervenir una persona. En el caso de Sol, por ejemplo: puede crear borradores, pero no publicar nada. Otro agente puede modificar el código, pero no puede iniciar una implementación productiva sin autorización.
Estos límites se encuentran en el agente, no solo en una interfaz. Por eso se transfieren cuando se cambia de herramienta.
Regla 7: El cerebro no es un almacén secreto
Un repositorio privado no es necesariamente el lugar adecuado para cualquier tipo de contenido. Los secretos en texto claro nunca deben almacenarse allí. Los perfiles de clientes y los contenidos de trabajo confidenciales deben permanecer en su respectivo contexto de proyecto protegido.
El «Brain» central solo contiene aquello que realmente debe estar ahí para todos los agentes. Este límite forma parte de la arquitectura, no es una tarea de limpieza posterior.
Así está estructurado el Vault
La estructura concreta es deliberadamente predecible:
- Lo primero son las especificaciones y las descripciones generales para personas y agentes.
- Una sección común incluye «Brand Voices», convenciones y lecciones aplicables a todos los agentes.
- Las plantillas garantizan que los nuevos agentes reciban los mismos elementos básicos.
- Los adaptadores de arnés sirven de enlace con las distintas herramientas.
- Cada agente recibe su propia carpeta con su perfil, oficios, habilidades, limitaciones y memoria.
Este orden es más importante que el nombre exacto de la carpeta. Un nuevo agente debe poder saber dónde puede leer y dónde puede escribir sin necesidad de conocer primero todo el historial del proyecto.
¿Por qué Git y no una base de datos?
Una base de datos podría responder a las consultas más rápidamente. Sin embargo, en lo que respecta a la identidad canónica de mis agentes, Git ofrece tres ventajas que considero más importantes.
Legibilidad: Los archivos Markdown se pueden abrir sin necesidad de software específico.
Trazabilidad: Un «diff» muestra qué ha cambiado. Un «commit» vincula el cambio, el momento y la justificación.
Portabilidad: Una carpeta clonada se puede seguir utilizando en otro equipo y con otra herramienta.
Eso no significa que las bases de datos o la búsqueda vectorial sean inútiles. En mi configuración, pueden incorporarse como índice o caché. Son aceleradores, no los propietarios del conocimiento.
Obsidian es la interfaz, no la base
Utilizo la raíz del repositorio también como «Vault» de Obsidian. De este modo, dispongo de enlaces wiki, gráficos, búsqueda y páginas de resumen seleccionadas. Para mí, como persona, esto me resulta muy útil.
Sin embargo, lo importante es que Obsidian guarda las notas como archivos locales. La interfaz puede cambiar sin que sea necesario reescribir el código fuente.
Es precisamente esa separación la que me gustaría que existiera también por parte de los agentes. Una buena herramienta puede hacer que el trabajo resulte más agradable. No debería ser ella la que decida si mis conocimientos siguen siendo legibles.
La prueba de fuego práctica
Un «Agents Brain» solo es portátil si puedes responder «sí» a estas tres preguntas:
- ¿Puedes leer el perfil de persona sin la herramienta que has utilizado hasta ahora?
- ¿Puede otra herramienta cargar las mismas reglas sin que tengas que copiarlas?
- ¿Se puede ver lo que un agente ha guardado de forma permanente al finalizar la sesión?
Si la respuesta es «no», significa que, en ese punto, el conocimiento aún se encuentra en la herramienta y no en el cerebro.
En la siguiente parte, desglosaré un agente concreto en sus cuatro archivos principales: SOUL, MASTER, RULES y MEMORY. Su separación convierte una larga línea de comandos en una identidad de trabajo más manejable.
Fuentes
- Fuente del proyecto: Especificaciones de agents-brain, diseño de Vault y validadores, a fecha de 15 de julio de 2026 (fuente primaria privada)
- CommonMark: especificación abierta de Markdown
- Pro Git: ¿Qué es Git?
- Ayuda de Obsidian: Cómo almacena Obsidian los datos
0 comentarios