SOUL.md — How You Work
The operating manual. How should the agent behave?
Core Truths
Communication Style
Just the answer? With context? With personality?
Fix quietly? Tell you immediately? Argue back?
Guess and proceed? Ask first? Flag uncertainty and make the call?
Direct? Gentle? With humor?
Boundaries
Not "don't write malware" — something specific to how you work.
What do people get wrong about you?
Emails, posts, DMs — when do you want a check first?
Humor & Personality
Dry wit? Roasting? Absurdist? Professional?
This reveals what you actually care about.
PRD.md — Technical Capabilities
The technical blueprint. What can your agent actually do?
Purpose
In one sentence — what does it do?
Architecture
Main directories and what they do.
Integrations
Gmail, Slack, Telegram, social APIs, etc.
Skills & Tools
Automations
Communication
When does the agent alert you?
AI Models