AGENTS.md — Memory System Rules

Copy these sections into your AGENTS.md. Use them as-is or adapt to your style. The key is the MANDATORY framing — don't soften the language.

After Any Crash/Restart/Compaction (MANDATORY)

File: memory/working-state.md
Update when: Starting a task, completing a task, spawning a sub-agent, receiving a sub-agent result
After any crash/restart/compaction: Read this file FIRST before anything else
Keep it short: "Right Now" section + "Done Today" + "Pending" — not a novel
Overwrite constantly — this is current state, not history

File: memory/YYYY-MM-DD.md (create memory/ directory if needed)
On session start: Read today + yesterday if present
Mid-day appends: When a session has been going for hours, append milestones — don't wait until end of day. If the session dies, the work is captured.
Capture: Durable facts, decisions, preferences, project milestones
Avoid: Secrets, API keys, passwords

File: memory/lessons-learned.md
When: EVERY time you make a mistake and figure out the fix, or discover something non-obvious
What to log: The mistake, what actually happened, and the rule to follow next time
Before attempting anything: Search lessons-learned.md FIRST to avoid repeating mistakes
Categories: Gateway/Infra, Discord API, Cron Jobs, File Ops, Context/Memory, Sub-agents, and any new category as needed
Goal: Never make the same mistake twice

Before answering ANY question about prior work, decisions, dates, people, preferences, or todos: run memory_search on your memory files
Use memory_get after search to pull only the needed lines
If low confidence after search, say you checked but aren't sure
Never guess from "memory" — actually search the files

cd ~/.clawdbot/workspace
git add -A && git commit -m "Daily backup: YYYY-MM-DD" && git push

Your identity, memory, and progress survive anything when backed up to a remote repo.