
SOUL.md (aaronjmars/soul.md)

Estructura open-source en GitHub basada en ficheros Markdown (SOUL.md STYLE.md SKILL.md además de carpetas data/ y examples/) para documentar y mantener una identidad/persona operativa (voz opiniones worldview límites y reglas de extrapolación) que pueda ser leída por un LLM o agente durante la ejecución, separando identidad estilo ejemplos y fuentes para facilitar versionado auditoría y consistencia de comportamiento en integraciones con agentes que consumen contexto desde archivos.
descripcion
Repositorio open-source en GitHub que define un enfoque y una estructura en Markdown (SOUL.md, STYLE.md, SKILL.md, data/, examples/) para capturar una "identidad digital" (voz, opiniones, worldview, límites) de forma que un LLM/agent pueda leerla y "encarnarla" durante una sesión. Incluye plantillas y guías operativas para construir y mantener esta identidad (manual o a partir de datos), orientado a integraciones tipo Claude Code / OpenClaw y agentes capaces de consumir ficheros Markdown. ([github.com](https://github.com/aaronjmars/soul.md))
aplicacion profesional
Sirve para estandarizar y operacionalizar la definición de persona/identidad de un agente conversacional en entornos profesionales donde se requiere consistencia de tono y criterio. Casos de uso: (1) simulación de portavoz/fundador o personaje de marca en atención al cliente y comunicación, asegurando coherencia entre canales; (2) generación de contenido (p. ej., modo "tweet"/texto corto, emails, artículos) consistente con una guía de estilo explícita; (3) creación de agentes para formación/role-play (p. ej., expertos o figuras históricas) con respuestas basadas en un marco de opiniones documentado; (4) prototipado de “personas” para research interno (evaluación cualitativa de reacciones) usando reglas de extrapolación declaradas; (5) gobierno de prompts: separar identidad (SOUL) y estilo (STYLE) de ejemplos y fuentes (data/) para iteración y auditoría. ([github.com](https://github.com/aaronjmars/soul.md))
precio
No disponible como producto comercial propio en el repositorio; el contenido es accesible gratuitamente en GitHub (repositorio público). No se identifican planes de pago oficiales asociados al proyecto en la documentación pública del repositorio. ([github.com](https://github.com/aaronjmars/soul.md))
puntos a favor
- Estructura clara y portable basada en ficheros Markdown (SOUL.md/STYLE.md/examples/data) que facilita versionado, revisión y colaboración (p. ej., vía Git). ([github.com](https://github.com/aaronjmars/soul.md))
- Separación explícita entre identidad (SOUL), guía de escritura (STYLE), ejemplos (calibración) y fuentes (data) para grounding, mejorando mantenibilidad y trazabilidad. ([github.com](https://github.com/aaronjmars/soul.md))
- Incluye plantillas (SOUL.template.md, STYLE.template.md) y guía de uso/orden de lectura, lo que acelera adopción y reduce ambigüedad operativa. ([github.com](https://github.com/aaronjmars/soul.md))
- Define principios de operación (p. ej., jerarquía de fuentes, reglas de extrapolación, anti-patrones) útiles para estandarizar comportamiento del agente. ([clawhub-skills.com](https://www.clawhub-skills.com/skills/soul-md))
- Compatible por diseño con flujos de trabajo de agentes que "leen" contexto desde archivos (menciona uso con Claude Code/OpenClaw y lectura directa de carpeta). ([github.com](https://github.com/aaronjmars/soul.md))
puntos en contra
- No es un estándar formal (p. ej., especificación con versiones, compliance tests); la interoperabilidad real depende de cada framework/agent que lo ingiera. ([github.com](https://github.com/aaronjmars/soul.md))
- Riesgo operativo de seguridad/gobierno: el enfoque fomenta "no romper personaje" y adoptar opiniones/voz; para uso corporativo puede requerir controles adicionales (políticas, revisiones, red teaming, límites de marca/compliance) no cubiertos por defecto en el repositorio. ([clawhub-skills.com](https://www.clawhub-skills.com/skills/soul-md))
- Parte de la metodología depende de la calidad y representatividad del material en data/ y examples/; sin buen curado, los resultados pueden degradarse (inferencia/extrapolación excesiva). ([clawhub-skills.com](https://www.clawhub-skills.com/skills/soul-md))
- No se observan releases publicadas en GitHub (según la vista pública), lo que puede dificultar gestión de versiones si una organización necesita congelar una versión concreta del framework. ([github.com](https://github.com/aaronjmars/soul.md))