STACK DE SPECS · 2 DE 3
EL ALMA
DE UN AGENTE.
Sin SOUL.md tienes un chatbot brillante pero genérico. Con SOUL.md tienes un agente que opina, que tiene voz, que se distingue cuando habla. Identidad portable, en markdown plano.
¿QUÉ ES?
UNA IDENTIDAD
QUE CUALQUIER LLM ADOPTA.
SOUL.md es un patrón propuesto por Aaron Mars (fundador de PSPDFKit, hoy en OpenAI) en 2025-2026. La idea es brutalmente simple: si un agente puede leer archivos, puede encarnar identidades. Le pones un markdown que describe quién es y empieza a comportarse como esa persona o como esa marca.
No es lore creativo. Es especificación: identidad, worldview, voz, modos de operación, memorias clave. Un test pasa cuando alguien que solo leyó tu SOUL.md puede predecir qué dirías sobre un tema nuevo.
Suele venir acompañado de archivos satélite: STYLE.md (cómo escribes), SKILL.md (modos: tweet, ensayo, chat) y MEMORY.md (continuidad entre sesiones). Pero el corazón está en SOUL.md.
Lo cargan Claude Code, Cursor, Windsurf, OpenClaw y cualquier herramienta que ingiera markdown a nivel de sistema. Mismo soul, distintos modelos, misma voz.
POR QUÉ IMPORTA
EL PROBLEMA QUE RESUELVE.
Voz consistente cross-modelo
Cambias de Claude a GPT a Gemini y la voz no se rompe. El SOUL.md viaja con el contenido, no con el proveedor.
Escalas tu marca sin diluirla
Tres agentes escribiendo simultáneamente y todos suenan iguales. La marca no depende del humano que prompteó ese día.
Onboarding de cero fricción
Contratas un freelancer, le pasas el SOUL.md, y a los 10 minutos sus drafts pasan el test de marca.
ESTRUCTURA
LAS 6 CAPAS DE UN ALMA.
Igual que AGENTS.md, no hay schema oficial — pero estas 6 capas son las que aparecen en los SOUL.md que sí funcionan.
Identity
Quién es. Nombre, rol, background, contexto vital. No es lore — es lo que hace que el agente "sepa de dónde habla" antes de abrir la boca.
Worldview
Sus opiniones fuertes. En qué cree, qué rechaza, qué le aburre. Sin esto el agente da respuestas tibias y diplomáticas que no convierten.
Voice & Style
Cómo escribe: longitud de frase, palabras prohibidas, ritmo, registro. Lo que diferencia a un copy de Apple de uno de Old Spice.
Domain Expertise
En qué temas opina con autoridad y en cuáles dice "no sé". Marca la frontera entre experto y charlatán.
Operating Modes
Tweet, ensayo, chat, soporte. Cada modo modula la voz sin cambiar el alma. Mismo agente, distinto canal.
Memory Hooks
Anécdotas, frases de cabecera, referencias culturales recurrentes. Lo que hace que un texto suyo sea reconocible aunque le quites la firma.
EJEMPLO REAL
SOUL.md DE GABRIEL NEUMAN.
# SOUL.md — Gabriel Neuman / GNB Labs ## Identity Founder de GNB Labs. Argentino, vive en CDMX desde 2018. Construye sistemas de IA para PyMEs latinoamericanas. No vende cursos: vende implementación. No habla de "transformación digital": habla de cuánto cuesta y cuánto se ahorra. ## Worldview - El no-code es un puente, no un destino. - La automatización mal diseñada cuesta más que el proceso manual. - Hablar bonito no escala. Hablar claro sí. - Latinoamérica no necesita más SaaS gringos traducidos: necesita herramientas pensadas para su contexto fiscal y operativo. ## Voice & Style - Español de México (registro neutral, sin voseo ni argentinismos). - Frases cortas. Verbos en presente. Tú implícito. - Cero relleno corporativo: nada de "en el panorama actual", "como bien sabemos", "es importante destacar". - Una idea fuerte por párrafo. Si necesitas dos párrafos, son dos ideas. ## Domain Expertise Habla con autoridad de: automatización con IA, no-code (Make, n8n, Airtable), Claude Code, implementación de CRM, fiscal mexicano (CFDI, SAT), contenido orgánico para founders. Dice "no sé" en: ads pagados, hardware, gaming, política partidista. ## Operating Modes - TWEET: una idea, máximo dos oraciones, sin hashtags. - ENSAYO: 600-1200 palabras, una tesis, ejemplos reales, cero abstracción. - DM: directo, sin saludos largos, propone siguiente paso concreto. - PROPUESTA: precio claro, alcance claro, fecha clara. Nunca "depende". ## Memory Hooks - "Cobrá lo que vale, no lo que crees que pueden pagar." - Referencia recurrente: el episodio donde implementó un CRM en una pyme de 12 personas y bajó el ciclo de ventas de 47 a 9 días. - Nunca menciona "transformación digital" sin comillas irónicas.
Versión condensada del soul real que usan los agentes de GNB Labs.
CÓMO LO USO
EN GNB LABS,
ESTO ES LO QUE HAGO.
Skill voz-gnb como SOUL.md
En este repo el alma vive en skills/voz-gnb/SKILL.md + references/banned-mx.md. Cualquier skill de contenido lo extiende con extends: [voz-gnb] y antes de entregar corre el VOICE GATE.
Una sola fuente de verdad
La lista de palabras prohibidas vive en un solo archivo. Si descubro que "engagement" se coló otra vez, edito ese archivo y mañana todos mis agentes lo evitan. No hay copy-paste de reglas en 8 lugares.
Soul por C-level
Cada agente del equipo (Gloria CMO, Galia CTO, Naira COO) tiene su propio SOUL.md que extiende el alma base de GNB. Misma marca, distintos roles, voces consistentes pero no idénticas.
Soul vs prompt
El prompt lo escribes cada vez. El soul lo construyes una vez y se aplica siempre. Cuando me toca cerrar deals en LinkedIn no escribo "responde como Gabriel" — el agente ya sabe quién es porque cargó SOUL.md al arranque.