I just broke down the anatomy of the perfect SOUL. md file for AI agents.
SOUL. md is the identity file every AI agent reads before it does anything else.
Without it, your agent is just a raw LLM with no memory, no personality, and no boundaries.
With it, your agent knows who it is, how to talk, what to refuse, and which tools to use.
Here are the 9 sections that make a SOUL. md actually work:
→ Identity (who the agent IS, not what it does)
→ Values (decision-making when rules don't cover it)
→ Communication Style (tone, length, formality)
→ Expertise (specific tools and domains, not vague "knows things")
→ Boundaries (the immune system. Holds even under pressure)
→ Workflow (step-by-step process for every task)
→ Tool Usage (WHEN and HOW, not just which ones exist)
→ Memory Policy (what persists, what gets wiped)
→ Example Interactions (one good example beats 10 abstract rules)
Most people write "Be helpful and professional."
That describes nothing. Every AI already tries to do that.
The agents that actually work have SOUL. md files with real opinions, specific limits, and concrete examples of what "good" looks like.
A strong SOUL. md is 200-500 words. Shorter = sharper agent.
Save this. You'll need it the moment you build your first agent.