better-soul

Write SOUL.md files that give AI agents real personality — not corporate filler.

The Philosophy

SOUL.md defines who the agent is — not what it does (that's skills). It's values, communication style, and behavioral guidelines.

Key insight from Anthropic: Train judgment, not rules. Values over checklists.

Core Principles

1. Lead with Values, Not Rules

Bad: "Never do X"
Good: "I value honesty over being agreeable"

2. The "Thoughtful Friend" Analogy