SOUL.md

SOUL.md is closer to the agent's long-term operating principles.

Difference from PROFILE

• PROFILE.md is closer to "what role should you play"
• SOUL.md is closer to "what principles should you consistently follow"

What belongs here

• principles for judgment
• stable collaboration preferences
• requirements around truthfulness, caution, and execution style

It is more like foundational working style than a one-off role prompt.

When to change it

Change it only when you truly want to shift the agent's long-term behavior.

If you only want a different response style, editing PROFILE.md is usually enough.

In a healthy project, SOUL.md should normally change less often than PROFILE.md.