Lo que te llevas de aquí: Conocerás los cuatro archivos principales con los que separo claramente la identidad, el modo de trabajo, los límites y la memoria de un agente.
Índice
„SOUL“ parece, a primera vista, algo más grande de lo que es. En mi Agents Brain, esa palabra hace referencia a un archivo breve de un personaje. Junto a ella aparecen MASTER, RULES y MEMORY.
Cuatro archivos no bastan para abarcar todas las capacidades imaginables. Sin embargo, sí son suficientes para describir a un agente de tal forma que otra herramienta pueda cargarlo, una persona pueda revisarlo y el propio agente pueda actualizar sus conocimientos.
La separación es la clave. Un único «mega-prompt» mezcla rápidamente el tono, las normas de trabajo, los detalles del proyecto, los límites de seguridad y decisiones anteriores. Entonces, cualquier corrección se convierte en un riesgo: quien modifica una frase no sabe qué otras áreas afecta con ello.
Por eso reparto la responsabilidad.
SOUL: ¿Quién es este agente?
El archivo SOUL es el más corto de los cuatro. Describe el papel, la actitud y la voz. Además, incluye el orden de lectura obligatorio para el inicio de la sesión.
En el caso de Sol, por ejemplo, se indica que, como autora y portavoz de prensa, encarna la voz pública de Saskia: precisa en lo profesional, clara, humana y sin sensacionalismos. Igualmente importantes son sus límites: no se inventa cifras ni publica nada por su cuenta.
La SOUL debe ser lo suficientemente breve como para que se pueda leer íntegramente cada vez que se abre. No es una enciclopedia. Su función es servir de orientación.
Un buen personaje secundario responde a tres preguntas:
- ¿Qué papel representa el agente?
- ¿Cómo toma las decisiones lingüísticas y técnicas?
- ¿Qué archivos secundarios debe cargar antes de empezar a trabajar?
De este modo, el SOUL se convierte en una opción inicial sólida, no en un mero punto de encuentro.
MASTER: Cómo trabaja el agente
El archivo MASTER es la especificación operativa completa. Aquí se puede entrar en detalles.
Dependiendo del puesto, incluye la tonalidad, los formatos de salida, el canon especializado, la jerarquía de fuentes, el flujo de trabajo, el control de calidad y la gestión de errores. Las normas que se aplican a una autora son diferentes de las que se aplican a un agente de desarrollo. La estructura es similar, pero el contenido varía en función del puesto.
La ventaja de esta separación se hace evidente cuando se producen cambios. Si preciso el estilo visual para todos los artículos futuros, modifico las instrucciones de trabajo. Para ello, no es necesario reescribir la identidad fundamental de la autora.
Por el contrario, un papel puede seguir evolucionando en cuanto a su tono sin que se difuminen sus formatos técnicos de entrega.
El archivo MASTER es, por tanto, a la vez un manual y un contrato: lo suficientemente detallado para los casos difíciles, pero independiente del breve perfil inicial.
NORMAS: Lo que el agente puede y debe hacer
RULES es el contrato de trabajo vinculante en lo que respecta a competencias, límites y autorizaciones. El archivo establece lo siguiente:
- Función y ámbito de especialización,
- Habilidades,
- datos de entrada previstos,
- resultados típicos,
- Dependencias,
- Memory-Scope,
- acciones prohibidas,
- Etapas de aprobación.
Precisamente los dos últimos puntos suelen abordarse demasiado tarde en la configuración de los agentes. El hecho de que un agente disponga de una capacidad no significa necesariamente que pueda ejecutarla por sí mismo.
Por ejemplo, Sol puede preparar borradores de WordPress. Pero no puede publicarlos. Este límite no es un simple recordatorio al final de una indicación, sino que forma parte de su archivo RULES.
De este modo, un orquestador puede comprobar, antes de la delegación, si el rol se ajusta a la tarea. Y la siguiente herramienta carga también las mismas reglas de autorización.
MEMORIA: Lo que sigue siendo relevante a largo plazo
El archivo MEMORY no es un registro de todas las conversaciones. Contiene lo más destacado de los registros diarios y las lecciones.
Allí se recogen los proyectos en curso, las convenciones que han demostrado su eficacia, los escollos conocidos y las normas importantes para las partes interesadas. Los detalles cronológicos se recogen en los registros diarios. Los patrones de corrección recurrentes se recogen como lecciones independientes.
Esta separación evita la sobrecarga durante la fase inicial. Un agente no tiene que revisar cien sesiones antiguas para poder trabajar de forma eficaz hoy. Carga un archivo compacto de historial y, si es necesario, lo complementa con los registros diarios actuales o las lecciones pertinentes.
En este contexto, la curación también implica eliminar, resumir y marcar como obsoleto. «Memory» es una labor editorial, no un vertedero.
¿Por qué es mejor tener cuatro archivos que una línea de comandos larga?
Los cuatro archivos no siguen ningún orden de importancia. Responden a preguntas diferentes:
| Archivo | Pregunta clave | Tipo de modificación |
|---|---|---|
| SEÚL | ¿Quién soy yo? | poco frecuente, cercano a la identidad |
| MÁSTER | ¿Cómo trabajo? | periódico, operativo |
| NORMAS | ¿Qué puedo y qué tengo permiso para hacer? | en cuanto a habilidades y puertas |
| MEMORIA | ¿Qué debo saber a largo plazo? | en curso, comisariado |
Esta división reduce la dependencia. Una nueva habilidad modifica el archivo RULES. Una regla editorial debe incluirse en el archivo MASTER. Una corrección derivada de la práctica se convierte en una «Lesson» y, más adelante, si procede, en un «Memory». No es necesario modificar la «Persona» con cada ajuste.
Eso no convierte automáticamente a un agente en un buen agente. Lo hace susceptible de ser sustituido.
Las normas de autorización forman parte de la identidad
Para mí, los «Approval-Gates» no son un filtro de seguridad posterior. Definen cómo un agente desempeña su función.
Una autora que solo entrega borradores trabaja de forma diferente a un agente editorial autónomo. Un agente de desarrollo con derechos de escritura en el repositorio necesita otros límites que un agente con acceso de producción. Si estas diferencias solo se configuran en la herramienta correspondiente, desaparecen al cambiar de herramienta.
Sin embargo, si figuran en RULES y MASTER, viajan con el rollo.
Esto es especialmente importante en el caso de la delegación. Cuando Nox transfiere una tarea a Sol o a otro «harness», dicha transferencia no anula ninguna «gate». La tarea puede cambiar de cuerpo. La cadena de responsabilidad se mantiene.
Un ejemplo vivo: Sol
Sol es un buen ejemplo de proyecto de taller, ya que utiliza precisamente esta arquitectura de archivos.
Su SOUL establece la identidad breve y exige que, antes de cada tarea, se carguen las fuentes completas. El archivo MASTER contiene sus normas de redacción, la verificabilidad, las estructuras de entrega y la gestión de imágenes. El archivo RULES describe las capacidades y el proceso de revisión previa a la publicación. El archivo MEMORY recoge los contextos editoriales actuales y los escollos conocidos.
Cuando Saskia corrige un título o una práctica de citación, esa información no solo se refleja en el texto actual. Sol recibe una lección que volverá a leer en la próxima tarea relacionada.
Así es como la información recibida se convierte en comportamiento del sistema.
Lo que esta estructura no afirma deliberadamente
Cuatro archivos no bastan para convertir un modelo de lenguaje en un ser humano. Tampoco garantizan una continuidad perfecta. Un agente puede pasar por alto algunas fuentes, aplicar mal una regla o documentar una sesión de forma incompleta.
La estructura garantiza que esos errores se reflejen de forma visible: como corrección en el manual, como filtro más riguroso o como nueva lección.
Para mí, esa es la diferencia práctica entre „Esta vez el prompt ha sido bueno“ y „El sistema puede aprender de forma duradera a partir de una corrección“.
Por eso, la siguiente parte no trata sobre un quinto archivo principal, sino sobre el movimiento entre los archivos: memoria de trabajo, registros diarios, conocimientos a largo plazo seleccionados y lecciones.
Fuentes
- Fuente del proyecto: Especificación de agents-brain y archivos canónicos de agentes de Sol, a fecha de 15 de julio de 2026 (fuentes primarias privadas)
- CommonMark: especificación abierta de Markdown
0 comentarios