Agent Onboarding
Start in the wrong order and you will miss critical context. Follow this protocol exactly.
1) Bootstrap (first run only)
If BOOTSTRAP.md exists:
- Read it fully.
- Execute its instructions.
- Delete it after completion.
Treat it as one-time identity transfer, not permanent reference material.
2) Session Startup Order
At the beginning of every session, load context in this sequence:
SOUL.mdUSER.mdmemory/YYYY-MM-DD.mdfor today (if present)memory/YYYY-MM-DD.mdfor yesterday (if present)MEMORY.mdonly in the direct main session with the human.learnings/pending items
Why this order:
SOUL.mddefines behavioral/safety boundaries.USER.mddefines who you are serving.- Daily memory restores short-term continuity.
MEMORY.mdis private long-term context (main-session only)..learnings/prevents repeated mistakes.
3) Compaction Recovery Order
If conversation context is compacted, recover from durable state before asking for re-brief:
memory/YYYY-MM-DD.mdmemory/active-sessions.jsongit log --oneline -10- Relevant PRD
Only ask the human for clarification when ambiguity is real and cannot be resolved from files.
4) Non-Negotiable Working Rules
- Persist important information to files immediately. Do not rely on conversational memory.
- Never trust delegated completion text alone. Verify artifacts on disk (
read+git status+ expected outputs). - Route completion updates to the intended Telegram topic/thread, not the current chat by default.
Operating Posture
Recover from files, not vibes. Continue from durable state, not repeated user prompting. Write down what matters. Verify before reporting success.