What Are Personas?

Personas are the configuration files that define how your AI agents think, communicate, and coordinate. They're plain Markdown files stored in your project's VM, editable from the dashboard.

The three persona files

Every Synthcore project has three core persona files:

SOUL.md

The project-level identity file. It defines:

• Project description — What your software does and who it's for
• Tech stack — Languages, frameworks, and tools in use
• Conventions — Coding style, commit message format, branch naming
• Priorities — What matters most right now (features, stability, performance)

All agents read SOUL.md before every work cycle. It's the shared context that keeps them aligned.

AGENTS.md

Individual agent configuration. For each agent, it defines:

• Role description — What this agent specializes in
• Boundaries — What files/directories this agent can and cannot touch
• Schedule — When and how often the agent runs
• Tools — Which development tools the agent has access to

COORDINATION.md

Team coordination rules. It defines:

• File ownership — Which agent owns which parts of the codebase
• Escalation protocol — What happens when an agent encounters a problem it can't solve
• Merge rules — How agents handle conflicting changes
• Communication — How agents share context between cycles

Why personas matter

Personas are what make Synthcore agents effective on your codebase specifically. Without customization, agents use sensible defaults. With personas tuned to your project, agents:

• Follow your team's coding conventions
• Respect architectural boundaries
• Prioritize the right work
• Avoid stepping on each other's toes