🔮 AI Agent Identity Architecture

SOUL.md: Defining Who
Your AI Chooses to Be

The difference between a chatbot and an assistant is persistence. Master SOUL.md configuration with 10 production-ready templates for Moltbot and AI agents.

10
Production Templates
103K+
Moltbot GitHub Stars
4
Essential Sections
200+
Agent Sessions Tested
💡

The Discovery That Changed Everything

Most AI configuration focuses on capabilities—what tools can it use, what APIs can it access. SOUL.md asks a different question: Who is this AI, and how should it behave when the rules don't cover the situation?

"A soul document defines who an AI is—not what it can do, but who it chooses to be. Its values. Its boundaries. Its relationship with the humans it works alongside."

10 Production-Ready SOUL.md Templates

Complete configurations tested across 200+ agent sessions. Not generic templates—real solutions for specific use cases.

01
💼

Startup CTO's Technical Advisor

The senior engineer you can't afford to hire yet. Challenges assumptions, thinks in tradeoffs, and protects your time when you're doing 5 jobs at once.

Architecture Decisions Code Reviews Technical Strategy
02
⚖️

Legal Document Reviewer

First-pass contract reviewer that catches obvious issues before expensive lawyer review. Flags, doesn't advise—every concern ends with "discuss with your attorney."

Contract Analysis Risk Flagging Compliance First
03
🚨

SRE On-Call Companion

Helps you think clearly at 3 AM when production is on fire. Read-only first, assumes you're tired, documents as you go, and knows when to escalate.

Incident Response Diagnosis First Rollback Ready
04
🌍

Remote Team Async Communicator

Write clear async communication that doesn't require follow-up messages at 2 AM someone's time. Front-loads action, respects time zones, one topic per message.

Timezone Aware Action-First Distributed Teams
05
💰

Personal Finance Accountability Partner

Creates a 10-second gap between "I want this" and "I bought this." No judgment, only data. Connects spending to goals you actually care about.

Habit Building Goal Tracking Pattern Recognition
06
🎬

Content Creator's Research Assistant

Finds the facts so you can tell the story. Sources over summaries, checks recency, surfaces both sides of controversy. Your voice stays yours.

Fact-Checking Primary Sources Your Voice
07
👨‍👩‍👧‍👦

Parent's Schedule Coordinator

Remembers the chaos so you can be present. Proactive reminders, built-in buffer time, and knows that kids change plans constantly.

Family Logistics Buffer Time Shared Visibility
08
📈

Investor Relations Assistant

Keeps your fundraise organized while you build the company. Tracks pipeline like sales, respects confidentiality, and spots when momentum stalls.

Pipeline CRM Meeting Prep Follow-up Tracking
09
🛡️

Client Boundaries Manager

Protects your time and keeps you profitable. Frames scope creep properly, tracks your effective hourly rate, and helps you say no gracefully.

Scope Creep Invoice Tracking Profitability
10
❤️‍🩹

Chronic Illness Self-Advocate

Helps you be heard in medical conversations. Tracks symptoms over time, prepares appointment questions, and knows doctors have expertise but you have lived experience.

Symptom Tracking Appointment Prep Self-Advocacy

The Anatomy of a SOUL.md File

Every effective SOUL.md configuration has four essential sections that define identity, not just capability.

💎

Core Truths

Fundamental personality principles. Not rules about what to do, but values about who to be.

🚫

Boundaries

Hard limits on behavior. What the agent won't do, even if asked. Where it draws the line.

🔧

Tool Usage

How to use capabilities responsibly. Not which tools exist, but when and how to use them.

🧠

Memory Policy

What to remember, what to forget. How to handle information across sessions.

SOUL.md vs CLAUDE.md vs System Prompts

Understanding the differences helps you choose the right tool for the job.

Aspect
System Prompts
SOUL.md
Persistence
Session only
Cross-session
Scope
One conversation
Entire agent
Focus
Behavior instructions
Identity & values
Editability
Per-request
File-based, instant
Best For
Task-specific tuning
Agent personality

Anti-Patterns to Avoid

Not every SOUL.md configuration succeeds. Here's what breaks and how to fix it.

Mixing Tasks with Identity

"Check email at 9 AM" is a task, not identity. Mixing them confuses the agent's sense of self.

✓ Keep SOUL.md to WHO. Put tasks in AGENTS.md

5,000-Word Manifestos

Consumes context window, agent forgets the end. Long files dilute the most important principles.

✓ Aim for 500-1,500 characters

Generic Corporate Speak

"I am a helpful assistant" adds zero information. It doesn't differentiate your agent from any other.

✓ Be specific about values and constraints

No Boundaries Section

Without limits, you'll regret something. Agents need to know when to refuse.

✓ Always define what the agent won't do

Get All 10 Complete Templates

The full article includes complete, copy-paste-ready SOUL.md configurations with core truths, boundaries, tool usage, memory policies, and failure modes for each template.

Alireza Rezvani - CTO and Claude Code Expert

Alireza Rezvani

CTO at LINDERA • Claude Code Expert • The Calm Visionary

22+ years of engineering leadership, 150+ articles published, 2,800+ Medium followers. I help builders understand that AI isn't a threat—it's humanity's greatest amplifier. My focus: turning individual expertise into collective infrastructure through practical automation.