Core Files

Think of the system like a theater. Telegram is the stage where the audience sees the performance. The files are backstage: role notes, safety rails, cue cards, and continuity logs that keep the show coherent when scenes change.

That framing matters because new teams often misread these file names as technical homework. They are not. You are not expected to become a file manager. You work with your agent in conversation, and it keeps the backstage in order.

Here is what each file is actually for:

SOUL.md is the character brief and guardrail contract — how the agent should sound, what lines it does not cross, and how it handles privacy and safety by default.

USER.md is the human context card — who the agent serves, how that person works, and what preferences should stay stable over time.

IDENTITY.md is the current role badge — what job this agent is playing in this workspace, distinct from its broader personality.

AGENTS.md is the operating playbook — session startup behavior, memory routines, coordination norms, and recovery steps when context gets thin.

TOOLS.md is the field notebook — environment quirks, tool caveats, and local details too specific to belong in a general handbook.

HEARTBEAT.md is the maintenance rhythm — recurring checks that happen quietly in the background, with escalation only when there is real signal.

When those files are healthy, the agent feels consistent. It remembers how you like things done. It keeps recurring work from slipping. When they go stale, quality drifts in subtle ways first, then obvious ways.

The right behavior for staff is simple: if something changes, tell your agent. If something feels off, tell your agent. If a new preference matters, say so. Your agent translates that into backstage updates so the next conversation starts from the right baseline.

When a file name comes up, do not read it as "you need to touch the system." Read it as "the system has memory and structure behind the chat window" — which is exactly why it can stay reliable over time.