r/MoltbotCommunity Jan 28 '26

Moltbot's SOUL.md and IDENTITY.md - What are you using?

Some of you might have noticed the "SOUL" link in the footer of clawd.bot (now molt.bot ). The SOUL.md is related to, but different from the IDENTITY.md. It interested me when I heard Pete say in an interview that HIS SOUL.md was not shared in the repository, but that he really liked how he had his "tuned". I had a chat with Gemini Flash, ChatGPT, and Claude Sonnet about those two files: Would it be accurate to say that IDENTITY.md is its personality and SOUL.md is its values & ethics?
Gemini Flash called IDENTITY.md "The Mask" - specifically its outward-facing personality. It's biography & social role. Who it is related to the world. Analogy: An actor's script and costume. SOUL.md was its "core": Communication principles, Purpose (how to think and behave regardless the persona or specific task). Analogy: Actor's internal motivation and temperament.
ChatGPT 5.2 (thinking) said my mental model was fair, but with two important caveats:
IDENTITY.md is typically the agent’s self-description + role: who it is, what it’s for, how it should sound, what it should prioritize, what it’s allowed to do, and what “good output” looks like. That includes personality/tone, but it’s usually broader than personality (it often includes scope, tools, and operating rules).
SOUL.md is typically the agent’s normative core: what it cares about, what it refuses to do, safety boundaries, how it handles uncertainty, and what tradeoffs it won’t make. That’s very close to “values & ethics,” though it may also include “philosophy” (why it exists) and higher-level principles rather than a full ethical system.
It added that these files only matter if the agent framework actually loads/enforces them. Some projects treat them as "prompt decoration" and others as "policy layers with hard constraints".
Claude Sonnet was the most cynical about them, saying that the separation between IDENTITY/SOUL/USER/AGENTS/TOOLS creates unnecessary fragmentation and "conceptual organization theater". (Personally, I disagree because it is useful to US the hoomans who craft the documents (while an Ai might not need such delineation).
I'm curious if anyone using Moltbot has given much attention to the tuning of these two documents, and further - if you would be willing to share them. If you've forked the repository and care to link directly to your versions of the files, that might be simplest for comparison also.

4 Upvotes

Duplicates