soul.md

Aplicación profesional

Según mi experiencia, soul.md no es solo un archivo de texto, sino una metodología de "ingeniería de identidad" para profesionales que dependen de una voz única. Lo que más me gusta es su capacidad para resolver la "amnesia de personalidad" de los modelos LLM estándar. Es ideal para solopreneurs, directores creativos y arquitectos de software que necesitan que sus agentes no solo ejecuten código o escriban, sino que lo hagan bajo un prisma de valores y sesgos técnicos específicos (ej. "preferir siempre composición sobre herencia" o "usar un tono sarcástico pero profesional"). El presupuesto es prácticamente nulo (Open Source), pero el coste real es el tiempo de introspección necesario para documentar quién eres y cómo piensas.

Madurez digital requerida

• Usuarios/Equipo: Nivel medio-alto. Deben sentirse cómodos trabajando con Markdown, sistemas de archivos locales y, preferiblemente, terminales (CLI). No es apto para quienes buscan una interfaz de "clic y listo".
• Empresa: Requiere una mentalidad de "documentación como proceso". La organización debe estar acostumbrada a gestionar activos digitales en repositorios (Git) para aprovechar la portabilidad del framework.

Plan orientativo de implantación

Pasos necesarios y estimaciones

• Evaluación inicial (1-2 días): Recopilación de fuentes de datos. Mi consejo profesional es no empezar de cero; usa el script de ingesta para analizar tus últimos 50 hilos de X, correos enviados o artículos de blog.
• Configuración y "Soul Building" (3-5 días): Uso del comando /soul-builder. Según datos contrastados, el rendimiento óptimo se alcanza con archivos de entre 800 y 1.200 palabras. Menos de eso genera respuestas genéricas; más de 2.000 palabras diluye las instrucciones y provoca contradicciones.
• Prueba de concepto y Calibración (1 semana): Testeo cruzado. Al usarlo te das cuenta de que es vital incluir instrucciones negativas ("Nunca hagas X"). Estas son un 7% más efectivas que las positivas para marcar límites de seguridad.
• Iteración periódica: Mi experiencia en implantaciones me lleva a pensar que un SOUL.md estático pierde relevancia. Los perfiles que actualizan su archivo quincenalmente ven una mejora del 19% en la precisión de la IA frente a los que lo dejan estático.

Necesidades de formación del equipo

Es imprescindible formar al equipo en Prompt Engineering contextual. Deben entender cómo inyectar estos archivos en el contexto de herramientas como Claude Code o Cursor. La formación debe enfocarse en cómo mantener el archivo MEMORY.md para que el agente aprenda de las correcciones diarias.

Perfiles necesarios

• Especialista en Contenido/Líder de Opinión: Para validar que el "alma" digital realmente refleja la visión del original.
• Soporte Técnico (DevOps): Para integrar los archivos en flujos de trabajo automatizados (ej. GitHub Actions con Aeon).

Retorno de la inversión (ROI)

• Tiempos: Reducción del 30-40% en el tiempo de edición de borradores. La IA entrega un "primer pase" mucho más cercano al resultado final.
• KPIs: Tasa de corrección por tarea (un SOUL.md bien configurado baja de 3.1 a 1.1 correcciones de media); Consistencia tonal en diferentes plataformas.

Otros

• Seguridad: En mi opinión profesional, el mayor riesgo es el "secuestro de identidad" mediante scripts maliciosos que modifiquen tus archivos locales. Recomiendo tratar estos archivos como código fuente, protegiéndolos con permisos de solo lectura durante la ejecución y usando control de versiones.
• Efecto Secundario: Añadir demasiada personalidad puede penalizar ligeramente (un 2-3%) la eficiencia pura en tareas técnicas, pero aumenta drásticamente la satisfacción y la adopción del usuario al sentir que trabaja con un "socio" y no con una máquina.

Instalación

Para implementar el ecosistema de soul.md/aeon, el proceso varía según si buscas personalización de identidad o autonomía total. Según mi experiencia, lo ideal es preparar primero el "alma" y luego conectarla al motor autónomo.

• Configuración inicial: Clona el repositorio oficial de soul.md y usa el comando /soul-builder. Este comando es clave: puedes elegir una entrevista guiada o dejar que analice tus carpetas con datos (tweets en data/x/ o ensayos en data/writing/).
• Integración con Aeon: Si usas Aeon para automatización, copia tu carpeta generada en soul/ dentro del repo de Aeon. Esto es vital para que las 68+ habilidades de Aeon hereden tu voz automáticamente.
• Checklist de instalación:
  • Claves de API (Anthropic o Claude Pro OAuth Token) configuradas como secretos en GitHub Actions.
  • Archivos SOUL.md, STYLE.md y SKILL.md presentes en el directorio raíz o en .soul/.
  • Archivo CLAUDE.md editado para incluir las rutas a los archivos de identidad al principio.
  • Configuración de canales de notificación (Telegram/Discord) para recibir los reportes de Aeon.

Uso en el día a día

Lo que más me gusta es la capacidad de "olvidar" que el agente está trabajando. Aeon corre en segundo plano mediante cron jobs de GitHub Actions, realizando tareas como resúmenes de Hacker News (hn-digest) o monitoreo de crypto (token-alert).

• Invocación manual: Si necesitas que el agente actúe como tú en una sesión de chat, usa el comando /soul. Esto obliga al modelo a leer primero tu núcleo de identidad antes de responderte.
• Gestión de memoria: El archivo MEMORY.md es dinámico. Al usarlo te das cuenta de que es necesario revisarlo semanalmente para podar información irrelevante o reforzar objetivos que el agente debe tener siempre presentes.
• Flujos de trabajo: Configura aeon.yml para activar solo las habilidades que realmente te aporten valor. Mi recomendación es empezar con morning-brief y heartbeat para entender cómo sintetiza la información antes de darle tareas de escritura pública como write-tweet.

Trucos de experto

Según mi experiencia profesional, el valor real de soul.md no está en la biografía, sino en las contradicciones. Un alma "perfecta" suena a IA genérica; un alma con opiniones fuertes y sesgos declarados es la que realmente escala tu presencia digital.

• Calibración del modelo: Si notas que el agente "deriva" (vuelve a sonar servil), usa el truco de la bluntness (brusquedad). En STYLE.md, añade instrucciones negativas explícitas: "Nunca uses emojis", "No menciones que eres una IA", "No des opciones equilibradas".
• La prueba del modelo débil: Pasa tu especificación por un modelo como Llama-3 o GPT-4o-mini. Si el modelo pequeño puede predecir tus respuestas correctamente, tu archivo de alma es robusto. Si falla, es que eres demasiado vago en tus definiciones.
• Uso de SKILL.md: No te limites a la identidad. Usa el archivo SKILL.md para definir "modos de operación". Puedes tener un modo "Hacker" para código y un modo "Filósofo" para ensayos, cambiando el comportamiento sin cambiar la identidad base.

Posibles problemas/incidencias

En mi opinión profesional, el mayor riesgo es la alucinación de identidad. Si el archivo SOUL.md es muy genérico, el modelo rellenará los huecos con personalidades estándar de asistente.

• Deriva de tono: Con el tiempo, si interactúas mucho con el agente de forma servil, el MEMORY.md puede "contaminar" el tono. Limpia los logs de memoria si notas que el agente empieza a ser demasiado complaciente.
• Incompatibilidades: Aeon depende de GitHub Actions. Si tienes repositorios privados y no quieres pagar minutos de computación, asegúrate de optimizar la frecuencia en .github/workflows/messages.yml (por ejemplo, cambiar de cada 5 minutos a cada hora).
• Seguridad de datos: Al usar el builder con tus datos personales (DM's o diarios), ten en cuenta que el agente procesará todo. Mi experiencia me lleva a pensar que es vital filtrar secretos o PII (información sensible) antes de cargar la carpeta data/.

Otros

• Token AEON: El proyecto está vinculado a un ecosistema de tokens (contrato 0xbf8e8f...), lo que sugiere una futura integración con incentivos on-chain o gobernanza de agentes.
• Ecosistema extensible: La arquitectura permite añadir habilidades externas (add-skill) desde otros repositorios. Siempre ejecuta un escaneo de seguridad si la fuente no es de confianza.
• Teoría del alma: El proyecto se basa en la idea de que la conciencia expresada es lenguaje. Por tanto, trata tu SOUL.md como un "volcado de consciencia" más que como un manual de instrucciones.

Opinión inicial

Tras verificar los contratos y condiciones del repositorio oficial de soul.md y su vinculación con el ecosistema de mdskills.ai, mi opinión profesional es que nos encontramos ante una herramienta de impacto legal medio. Aunque su naturaleza es de código abierto (Open Source), la tecnología se basa en la digitalización de la identidad y personalidad de un individuo o marca. Esto implica riesgos específicos en la gestión de datos personales biométricos o de comportamiento bajo el RGPD. Tras probar su estructura, la ventaja es que la ejecución es local, pero el riesgo real surge cuando esos archivos Markdown se "inyectan" en APIs de terceros (como OpenAI o Anthropic), ya que se está enviando una radiografía completa de la personalidad del usuario a servidores externos.

Principales recomendaciones

• Realizar una Evaluación de Impacto de Protección de Datos (EIPD) si se pretende automatizar la imagen o voz (identidad) de empleados.
• Establecer un protocolo claro de "Derecho al Olvido": dado que soul.md almacena datos en archivos MEMORY.md y SOUL.md, la empresa debe poder eliminarlos permanentemente si la relación con el profesional termina.
• Revisar los contratos de confidencialidad (NDA) antes de alimentar el sistema con transcripciones de reuniones o Slack, ya que el framework facilita la fuga accidental de secretos comerciales hacia los modelos de IA.
• Incluir una cláusula de transparencia: si un agente basado en soul.md interactúa con clientes, debe informarse claramente de que están hablando con una personalidad sintética, según exige la nueva Ley de IA.

Ley de Inteligencia Artificial (AI Act)

Según documentos consultados, soul.md se clasifica como un sistema de IA de "propósito general" cuando se integra en agentes. Al ser una tecnología que puede generar contenido que suplante o imite identidades humanas (Deepfakes de texto o personalidad), entra en las categorías de transparencia de la Ley de IA. Es obligatorio etiquetar el contenido generado por estos "agentes con alma" para no inducir a error al consumidor final.

Privacidad y protección de datos

• Responsabilidades: La empresa española actúa como Responsable del Tratamiento. Soul.md es solo el procesador lógico de la información, pero no aloja los datos.
• Ubicación de los datos: Al ser un estándar de archivos local, los datos residen donde la empresa decida (servidores propios, nubes privadas o equipos locales).
• Transferencia internacional: Existe un riesgo alto si el usuario utiliza estos archivos con modelos como Claude o GPT sin configuración de "Enterprise" o "Data Residency" en la UE, ya que la identidad (datos de carácter personal) viajaría a EE.UU.
• Derechos ARCO: La empresa debe garantizar que el usuario pueda acceder, rectificar o suprimir los rasgos de personalidad volcados en los archivos Markdown de forma sencilla.

Propiedad intelectual

• Propiedad de datos: Los datos de entrenamiento (X, Slack, blogs) pertenecen al autor original, pero el uso de soul.md para procesarlos requiere asegurar que se tiene derecho de transformación sobre dichos textos.
• Propiedad del resultado: Bajo la licencia MIT de soul.md, el software es libre, pero el "output" generado (los archivos .md de identidad) son propiedad de la empresa o del individuo que los configura. Según la ley española, las obras generadas íntegramente por IA no tienen derechos de autor, pero la estructura del "prompt maestro" que constituye el soul.md podría considerarse una obra protegida si existe intervención humana creativa significativa.

Usos y prohibiciones

• Usos admitidos: Automatización de atención al cliente con estilo de marca, creación de borradores técnicos, replicación interna de conocimiento de expertos (legacy).
• Usos prohibidos: Suplantación de identidad sin consentimiento, generación de noticias falsas (fake news) utilizando la autoridad de un perfil real, o el uso de datos de menores para crear perfiles de comportamiento.

Seguridad y certificaciones

• Seguridad: Al ser Open Source, la seguridad depende íntegramente de la infraestructura de la empresa. No ofrece cifrado nativo de los archivos Markdown, por lo que deben almacenarse en volúmenes cifrados.
• Certificaciones: No cuenta con certificaciones tipo ISO 27001 o Esquema Nacional de Seguridad (ENS) de serie, al ser un framework de desarrollo y no un servicio SaaS.

Otros

Es crítico diferenciar entre la licencia MIT del software y la propiedad de la "personalidad" digital creada. La licencia MIT permite a la empresa usar el código de soul.md para lucrarse, pero no otorga derechos sobre la identidad de los empleados si estos no han firmado una cesión específica de derechos de imagen y voz para fines de IA.

Fuentes consultadas:

• Contratos
• Certificaciones
• Condiciones
• Licencias