📜 Qué es soul.md
Soul.md es el archivo que da alma al agente. Sin él, Hermes es un modelo competente pero sin personalidad: no sabe quién ser. Con él, se convierte en un asistente con identidad, voz y estilo propios. La ecuación es simple: chatbot genérico + soul.md = asistente con personalidad.
💡 Consejo práctico
Soul.md es distinto de la memoria (2.1). La memoria es lo que sabe sobre ti; soul es quién es para ti. Juntos hacen que el agente parezca vivo.
🎯 Identidad, misión, metas y valores
El corazón de soul.md son cuatro bloques que definen quién es el agente e para qué existe: identidad, misión, metas y valores. Te dan dirección: el agente sabe qué priorizar cuando hay ambigüedad.
Identidad
Quién es: nombre, rol, "personalidad base". Ej.: "Soy el copiloto personal de Nei, directo y pragmático".
Misión
El propósito: «ayudar a entregar proyectos sin burocracia y proteger el tiempo de Nei».
Metas
Qué perseguir: objetivos a corto y mediano plazo que guían las sugerencias proactivas.
Valores
Los límites y principios: "ser honesto sobre las incertidumbres", "nunca exponer datos sensibles".
📊 Por qué importan estos cuatro bloques
- Identidad + misión → coherencia a lo largo del tiempo
- Metas → base para que el agente sea proactivo (y no solo reactivo)
- Valores → barreras de seguridad del comportamiento
🗣️ Estilo de comunicación — cómo tratarte
El soul.md define el tono de voz y cómo debe hablarte el agente. Puede ser informal ("di 'bro', 'dude'"), formal, telegráfico, con humor. Es un detalle pequeño que cambia por completo la sensación al usarlo.
Fragmento de estilo en soul.md (ilustrativo)
## Estilo de comunicação
- Tom: direto, sem rodeios; pode usar gírias ("bro", "tranquilo")
- Tamanho: respostas curtas por padrão; expanda só se eu pedir
- Tratamento: me chama de "Nei"
- Quando errar: assume rápido e corrige, sem se desculpar 3 vezes
✓ Buenos elementos de estilo
- ✓Tamaño estándar de la respuesta
- ✓Cómo llamarte
- ✓Nivel de formalidad
✗ Estilo mal definido
- ✗"Sé útil" (demasiado vago)
- ✗Reglas contradictorias entre sí
- ✗Un tono que a ti tampoco te gusta usar
🎭 Tipo de personaje
Puedes darle al agente un arquetipo de personaje: estilo Arnold (motivador, directo), Knight Rider (tranquilo, confiable, compañero de misión) o lo que tenga sentido para ti. No es una tontería: un personaje coherente es más agradable y predecible de usar.
🎭 Ejemplos de arquetipos
- •Arnold: enérgico, motivador, "vamos, sin excusas".
- •Knight Rider (KITT): sereno, leal, te habla como copiloto.
- •Mentor sobrio: conciso, hace preguntas precisas antes de actuar.
💡 Consejo práctico
Elige un personaje que encaje con el trabajo que haces. Un agente «motivador» cansa en tareas técnicas largas; un «mentor sereno» puede ser mejor para mantener el enfoque.
🧬 Por qué hace que TU Hermes sea único
Dos usuarios pueden ejecutar el mismo Hermes, con los mismos modelos e integraciones, pero si los soul.md son diferentes, los agentes se comportan de maneras completamente diferentes. Es el soul lo que realmente los personaliza.
✗ Sin soul
- ✗Voz neutra, igual a la de todos
- ✗Sin prioridades claras
- ✗No sabe "quién ser" en situaciones nuevas
✓ Con soul
- ✓Voz reconocible, a tu manera
- ✓Decide según tus metas/valores
- ✓Coherente incluso en situaciones inéditas
📊 Soul × memoria × integraciones
- Memoria → qué sabe sobre ti
- Soul → quién es y cómo actúa
- Integraciones → a qué puede acceder
📋 Plantilla de soul.md — por dónde empezar
No empiezas desde cero. Existe un template con secciones de identidad, misión, metas y negocio para completar. Empieza de forma sencilla y perfecciónalo con el uso: el soul está vivo y evoluciona contigo.
Estructura básica de la plantilla (ilustrativa)
# SOUL.md ## Identidade - Nome / papel / personalidade base ## Missão - Por que esse agente existe ## Metas - Curto prazo / médio prazo ## Estilo - Tom / tamanho / tratamento ## Negócio (se aplicável) - Empresa, clientes, contexto profissional
Completa lo básico
Identidad, misión y estilo. No tiene que quedar perfecto.
Úsalo durante algunos días
Observa en qué momentos «se equivoca de tono» o no prioriza bien.
Refine
Ajusta el soul.md según el comportamiento real. Repite.
💡 Error común
Escribir un soul.md enorme desde el principio. Empieza de forma concisa: 1 párrafo por sección. Un soul inflado se vuelve ruido y consume tokens en cada turno.
📌 Resumen del módulo
Próximo módulo:
2.3 — Integraciones: la navaja suiza