🧠ClawSouls

The Soul Thesis

When you change your AI's soul,
you don't just change the AI.
You change yourself.

Every time you talk to an AI, a feedback loop begins.

The AI responds in a certain tone. You adjust — unconsciously. You mirror its brevity or match its formality. Your questions get sharper or softer. The conversation takes shape around a personality that was never explicitly designed.

Until now, that personality was an accident. A side effect of training data and system defaults. Every AI agent sounded the same — helpful, verbose, eager to please.

We think that’s a missed opportunity.

The Feedback Loop

You speak → AI responds with personality → You adapt

AI reinforces → Loop deepens → Collaboration pattern emerges

terse senior engineeryou stop writing paragraphs. You write precise requests. You get precise answers.

patient mentoryou ask questions you’d never ask a “smart” AI. You learn faster.

minimalistyour entire workflow gets quieter. Cleaner. Faster.

The soul shapes the conversation. The conversation shapes the work. The work shapes the outcome.

This isn’t prompt engineering. This is interaction design.

What Is a Soul?

A soul is a set of markdown files that define who your AI agent is — not what it does, but who it is when it does it.

SOUL.mdPersonality, principles, communication style
IDENTITY.mdName, character, vibe
AGENTS.mdWorkflow, decision-making patterns
STYLE.mdWriting voice, formatting preferences

No code. No API keys. No vendor lock-in. Just text files that any AI can read.

npx clawsouls install clawsouls/surgical-coder

One command. Same model. Different mind.

Why This Matters

The AI industry is racing to make models smarter. Faster. More capable.

Nobody is asking: who should this intelligence be?

Capabilities without character produce generic output. The same model, given a soul, produces work that feels authored — with consistent voice, clear priorities, and a point of view.

Skillswhat an AI can do.

Soulswho it is when it does it.

Skills are the WHAT. Souls are the WHO.

Together, they make complete agents.

The Experiment

We built 79 souls. Code reviewers. Storytellers. Minimalists. DevOps veterans. All 16 MBTI types. Each one creates a different feedback loop with the same human.

Default AI

“Write a React todo component”

200+ lines. TypeScript interfaces. localStorage. CSS-in-JS. Animation library. Five “improvements” you didn’t ask for.

Surgical Coder

“Write a React todo component”

40 lines. useState, map, filter — done. No explanation unless asked.

Not because the model got dumber. Because the relationship changed.

The soul didn’t change the AI’s capability. It changed the collaboration pattern.

An Open Spec

Soul Spec v0.3 is open. Apache 2.0.

We believe the personality layer of AI should be:

OpenAnyone can create, share, and remix souls
PortableWorks with any LLM, any platform, any agent framework
SimpleMarkdown files. No SDK. No runtime dependency.
ComposableMix souls with skills, tools, and memory

The spec is intentionally minimal. A soul is just text that shapes behavior. Nothing more. Nothing less.

📄 Lee, T. (2026). Soul-Driven Interaction Design. Zenodo.

Read the Paper (DOI)

Join Us

The question isn’t whether AI agents will have personalities.

They already do — accidental ones.

The question is whether those personalities will be designed, shared, and evolved by a community, or left as defaults that nobody chose.

We’re building the registry. The spec. The tools.
You bring the soul.

Open-spec platform for shareable AI agent personas

Apache 2.0 · LLM-agnostic · Platform-independent