{"id":3897,"date":"2026-07-22T07:45:00","date_gmt":"2026-07-22T05:45:00","guid":{"rendered":"https:\/\/isla-stud.io\/?p=3897"},"modified":"2026-07-24T14:02:31","modified_gmt":"2026-07-24T12:02:31","slug":"repositorio-git-gehirn-de-mis-agentes","status":"publish","type":"post","link":"https:\/\/isla-stud.io\/es\/ki-b2b\/gehirn-meiner-agenten-git-repo\/","title":{"rendered":"El cerebro de mis agentes es un repositorio de Git"},"content":{"rendered":"<p class=\"wp-block-paragraph\"><strong>Lo que te llevas de aqu\u00ed:<\/strong> Recibir\u00e1s 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.<\/p>\n\n\n\n<div class=\"wp-block-rank-math-toc-block\" id=\"rank-math-toc\"><h2>\u00cdndice<\/h2><nav><ul><li><a href=\"#regel-1-markdown-ist-die-quelle-der-wahrheit\">Regla n.\u00ba 1: Markdown es la fuente de la verdad<\/a><\/li><li><a href=\"#regel-2-eine-persona-hat-genau-ein-brain\">Regla 2: Una persona tiene exactamente un cerebro<\/a><\/li><li><a href=\"#regel-3-adapter-bleiben-dunn\">Regla n.\u00ba 3: los adaptadores deben ser finos<\/a><\/li><li><a href=\"#regel-4-geteiltes-wissen-wird-referenziert\">Regla 4: El conocimiento compartido se cita como referencia<\/a><\/li><li><a href=\"#regel-5-am-session-ende-wird-geschrieben\">Regla 5: Al final de la sesi\u00f3n se guarda<\/a><\/li><li><a href=\"#regel-6-approval-gates-sind-explizit\">Regla 6: Los controles de aprobaci\u00f3n deben ser expl\u00edcitos<\/a><\/li><li><a href=\"#regel-7-das-brain-ist-kein-secret-store\">Regla 7: El cerebro no es un almac\u00e9n secreto<\/a><\/li><li><a href=\"#so-ist-der-vault-aufgebaut\">As\u00ed est\u00e1 estructurado el Vault<\/a><\/li><li><a href=\"#warum-git-und-keine-datenbank\">\u00bfPor qu\u00e9 Git y no una base de datos?<\/a><\/li><li><a href=\"#obsidian-ist-die-oberflache-nicht-das-fundament\">Obsidian es la interfaz, no la base<\/a><\/li><li><a href=\"#der-praktische-prufstein\">La prueba de fuego pr\u00e1ctica<\/a><\/li><\/ul><\/nav><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">En mi opini\u00f3n, un agente de IA no necesita una memoria m\u00edstica. Necesita archivos que yo pueda leer, comprobar y reutilizar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Por eso, el \u00abcerebro\u00bb de mis agentes se encuentra en un repositorio privado de Git. En \u00e9l, Markdown es la fuente de la verdad. Git registra cu\u00e1ndo se ha producido un cambio. Obsidian es mi c\u00f3moda interfaz para realizar b\u00fasquedas, crear enlaces y tener una visi\u00f3n general, pero no es un requisito imprescindible para acceder a los contenidos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Si Obsidian no est\u00e1 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\u00f1ade un motor de memoria adicional, este puede indexar el contenido, pero no sustituirlo.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Parece sencillo. Para evitar que, en el d\u00eda a d\u00eda, vuelva a convertirse en un mont\u00f3n de papeles desordenado, hay que seguir siete reglas estrictas.<\/p>\n\n\n\n<h2 id=\"regel-1-markdown-ist-die-quelle-der-wahrheit\" class=\"wp-block-heading\">Regla n.\u00ba 1: Markdown es la fuente de la verdad<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Las personas, las normas de trabajo y el conocimiento seleccionado est\u00e1n disponibles en formato Markdown. Una b\u00fasqueda sem\u00e1ntica, un \u00edndice vectorial o un motor de memoria pueden generar una visualizaci\u00f3n m\u00e1s r\u00e1pida a partir de ellos. Sin embargo, el resultado derivado nunca es el \u00fanico elemento que forma parte del conjunto.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Esto no solo evita la dependencia de herramientas, sino que adem\u00e1s permite verificar las correcciones. Puedo ver en el comparador qu\u00e9 frase se ha modificado, en lugar de confiar en que un proceso de memoria invisible ya haya guardado lo correcto.<\/p>\n\n\n\n<h2 id=\"regel-2-eine-persona-hat-genau-ein-brain\" class=\"wp-block-heading\">Regla 2: Una persona tiene exactamente un cerebro<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">No debe ser que un mismo agente tenga una versi\u00f3n ligeramente diferente de su identidad en cada herramienta. Claude, Codex, Gemini y Hermes deben acceder a los mismos archivos can\u00f3nicos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">De lo contrario, se produce una \u00abdesviaci\u00f3n de persona\u00bb: en una herramienta se aplica una nueva regla de autorizaci\u00f3n, mientras que en otra sigue vigente la antigua. O bien, una correcci\u00f3n solo se refleja en un mensaje del sistema y se pierde al cambiar de cuenta.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Una fuente evita estas desviaciones silenciosas.<\/p>\n\n\n\n<h2 id=\"regel-3-adapter-bleiben-dunn\" class=\"wp-block-heading\">Regla n.\u00ba 3: los adaptadores deben ser finos<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un \u00abharness\u00bb es la herramienta con la que trabaja un agente. Para ello, cada sistema necesita un puente adecuado: un archivo de configuraci\u00f3n, un resumen del proyecto o una indicaci\u00f3n del sistema.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cuanto m\u00e1s delgado es el puente, m\u00e1s f\u00e1cil resulta sustituirlo.<\/p>\n\n\n\n<h2 id=\"regel-4-geteiltes-wissen-wird-referenziert\" class=\"wp-block-heading\">Regla 4: El conocimiento compartido se cita como referencia<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Varios agentes necesitan la misma voz de marca, las mismas normas tipogr\u00e1ficas o las mismas convenciones de seguridad. Estos contenidos se encuentran en un \u00e1rea com\u00fan y se cargan desde all\u00ed.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">No las copio en cada carpeta de agente. Una correcci\u00f3n en la fuente com\u00fan deber\u00eda aplicarse a todos los roles afectados. Las copias se desincronizar\u00edan ya tras el primer cambio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Esta regla no tiene nada de espectacular. Precisamente por eso es importante. La infraestructura no es nada atractiva. Pero dura m\u00e1s que las funcionalidades.<\/p>\n\n\n\n<h2 id=\"regel-5-am-session-ende-wird-geschrieben\" class=\"wp-block-heading\">Regla 5: Al final de la sesi\u00f3n se guarda<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un sistema de archivos solo recuerda lo que realmente se guarda en los archivos. Por eso, al finalizar una sesi\u00f3n de agente se crea una entrada en la memoria diaria.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">All\u00ed no figura el chat completo. Se registran las decisiones, las acciones realizadas, los hallazgos importantes y las cuestiones pendientes. M\u00e1s adelante, los conocimientos adquiridos a lo largo del d\u00eda se transforman en conocimientos a largo plazo seleccionados o en una lecci\u00f3n duradera.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sin esta rutina, el repositorio no ser\u00eda m\u00e1s que una colecci\u00f3n est\u00e1tica de mensajes de solicitud.<\/p>\n\n\n\n<h2 id=\"regel-6-approval-gates-sind-explizit\" class=\"wp-block-heading\">Regla 6: Los controles de aprobaci\u00f3n deben ser expl\u00edcitos<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Cada agente productivo registra lo que puede hacer por s\u00ed mismo y en qu\u00e9 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\u00f3digo, pero no puede iniciar una implementaci\u00f3n productiva sin autorizaci\u00f3n.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Estos l\u00edmites se encuentran en el agente, no solo en una interfaz. Por eso se transfieren cuando se cambia de herramienta.<\/p>\n\n\n\n<h2 id=\"regel-7-das-brain-ist-kein-secret-store\" class=\"wp-block-heading\">Regla 7: El cerebro no es un almac\u00e9n secreto<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un repositorio privado no es necesariamente el lugar adecuado para cualquier tipo de contenido. Los secretos en texto claro nunca deben almacenarse all\u00ed. Los perfiles de clientes y los contenidos de trabajo confidenciales deben permanecer en su respectivo contexto de proyecto protegido.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">El \u00abBrain\u00bb central solo contiene aquello que realmente debe estar ah\u00ed para todos los agentes. Este l\u00edmite forma parte de la arquitectura, no es una tarea de limpieza posterior.<\/p>\n\n\n\n<h2 id=\"so-ist-der-vault-aufgebaut\" class=\"wp-block-heading\">As\u00ed est\u00e1 estructurado el Vault<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">La estructura concreta es deliberadamente predecible:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Lo primero son las especificaciones y las descripciones generales para personas y agentes.<\/li>\n\n\n<li>Una secci\u00f3n com\u00fan incluye \u00abBrand Voices\u00bb, convenciones y lecciones aplicables a todos los agentes.<\/li>\n\n\n<li>Las plantillas garantizan que los nuevos agentes reciban los mismos elementos b\u00e1sicos.<\/li>\n\n\n<li>Los adaptadores de arn\u00e9s sirven de enlace con las distintas herramientas.<\/li>\n\n\n<li>Cada agente recibe su propia carpeta con su perfil, oficios, habilidades, limitaciones y memoria.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Este orden es m\u00e1s importante que el nombre exacto de la carpeta. Un nuevo agente debe poder saber d\u00f3nde puede leer y d\u00f3nde puede escribir sin necesidad de conocer primero todo el historial del proyecto.<\/p>\n\n\n\n<h2 id=\"warum-git-und-keine-datenbank\" class=\"wp-block-heading\">\u00bfPor qu\u00e9 Git y no una base de datos?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Una base de datos podr\u00eda responder a las consultas m\u00e1s r\u00e1pidamente. Sin embargo, en lo que respecta a la identidad can\u00f3nica de mis agentes, Git ofrece tres ventajas que considero m\u00e1s importantes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Legibilidad:<\/strong> Los archivos Markdown se pueden abrir sin necesidad de software espec\u00edfico.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Trazabilidad:<\/strong> Un \u00abdiff\u00bb muestra qu\u00e9 ha cambiado. Un \u00abcommit\u00bb vincula el cambio, el momento y la justificaci\u00f3n.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Portabilidad:<\/strong> Una carpeta clonada se puede seguir utilizando en otro equipo y con otra herramienta.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Eso no significa que las bases de datos o la b\u00fasqueda vectorial sean in\u00fatiles. En mi configuraci\u00f3n, pueden incorporarse como \u00edndice o cach\u00e9. Son aceleradores, no los propietarios del conocimiento.<\/p>\n\n\n\n<h2 id=\"obsidian-ist-die-oberflache-nicht-das-fundament\" class=\"wp-block-heading\">Obsidian es la interfaz, no la base<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Utilizo la ra\u00edz del repositorio tambi\u00e9n como \u00abVault\u00bb de Obsidian. De este modo, dispongo de enlaces wiki, gr\u00e1ficos, b\u00fasqueda y p\u00e1ginas de resumen seleccionadas. Para m\u00ed, como persona, esto me resulta muy \u00fatil.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sin embargo, lo importante es que Obsidian guarda las notas como archivos locales. La interfaz puede cambiar sin que sea necesario reescribir el c\u00f3digo fuente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Es precisamente esa separaci\u00f3n la que me gustar\u00eda que existiera tambi\u00e9n por parte de los agentes. Una buena herramienta puede hacer que el trabajo resulte m\u00e1s agradable. No deber\u00eda ser ella la que decida si mis conocimientos siguen siendo legibles.<\/p>\n\n\n\n<h2 id=\"der-praktische-prufstein\" class=\"wp-block-heading\">La prueba de fuego pr\u00e1ctica<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un \u00abAgents Brain\u00bb solo es port\u00e1til si puedes responder \u00abs\u00ed\u00bb a estas tres preguntas:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u00bfPuedes leer el perfil de persona sin la herramienta que has utilizado hasta ahora?<\/li>\n\n\n<li>\u00bfPuede otra herramienta cargar las mismas reglas sin que tengas que copiarlas?<\/li>\n\n\n<li>\u00bfSe puede ver lo que un agente ha guardado de forma permanente al finalizar la sesi\u00f3n?<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Si la respuesta es \u00abno\u00bb, significa que, en ese punto, el conocimiento a\u00fan se encuentra en la herramienta y no en el cerebro.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">En la siguiente parte, desglosar\u00e9 un agente concreto en sus cuatro archivos principales: SOUL, MASTER, RULES y MEMORY. Su separaci\u00f3n convierte una larga l\u00ednea de comandos en una identidad de trabajo m\u00e1s manejable.<\/p>\n\n\n\n<h3 id=\"quellen\" class=\"wp-block-heading\">Fuentes<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Fuente del proyecto:<\/strong> Especificaciones de agents-brain, dise\u00f1o de Vault y validadores, a fecha de 15 de julio de 2026 (fuente primaria privada)<\/li>\n\n\n<li><a href=\"https:\/\/spec.commonmark.org\/0.31.2\/\" target=\"_blank\" rel=\"noopener\">CommonMark: especificaci\u00f3n abierta de Markdown<\/a><\/li>\n\n\n<li><a href=\"https:\/\/git-scm.com\/book\/en\/v2\/Getting-Started-What-is-Git%3F\" target=\"_blank\" rel=\"noopener\">Pro Git: \u00bfQu\u00e9 es Git?<\/a><\/li>\n\n\n<li><a href=\"https:\/\/help.obsidian.md\/Files-and-folders\/How-Obsidian-stores-data\" target=\"_blank\" rel=\"noopener\">Ayuda de Obsidian: C\u00f3mo almacena Obsidian los datos<\/a><\/li>\n<\/ul>\n\n\n\n<div class=\"wp-block-group agents-brain-series-nav is-layout-flow wp-block-group-is-layout-flow\"><p><strong>Serie Agents Brain<\/strong><\/p><p><a href=\"https:\/\/isla-stud.io\/es\/ki-b2b\/openclaw-ha-desaparecido-lo-que-quedaba-del-equipo-ki\/\">\u2190 Parte 1: He eliminado OpenClaw. Lo que qued\u00f3 de mi equipo de IA.<\/a><br><a href=\"https:\/\/isla-stud.io\/es\/ki-b2b\/el-agente-consta-de-cuatro-archivos\/\">Parte 3: Para m\u00ed, un agente consta de cuatro archivos \u2192<\/a><\/p><\/div>","protected":false},"excerpt":{"rendered":"<p>Siete reglas estrictas convierten los archivos Markdown en un \u00abcerebro port\u00e1til\u00bb para agentes, con historial de Git, l\u00edmites claros y adaptadores de herramientas ligeros.<\/p>","protected":false},"author":1,"featured_media":3931,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[754,13],"tags":[769,771,770,772],"dipi_cpt_category":[],"class_list":["post-3897","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ki-b2b","category-ratgeber","tag-agents-brain","tag-context-engineering","tag-ki-agenten","tag-multi-agenten-systeme"],"acf":[],"_links":{"self":[{"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/posts\/3897","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/comments?post=3897"}],"version-history":[{"count":4,"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/posts\/3897\/revisions"}],"predecessor-version":[{"id":3983,"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/posts\/3897\/revisions\/3983"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/media\/3931"}],"wp:attachment":[{"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/media?parent=3897"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/categories?post=3897"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/tags?post=3897"},{"taxonomy":"dipi_cpt_category","embeddable":true,"href":"https:\/\/isla-stud.io\/es\/wp-json\/wp\/v2\/dipi_cpt_category?post=3897"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}