From 7d1fee70e76f2f634f1b41fca927ee663914183a Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Tue, 6 Jan 2026 05:19:20 +0000 Subject: [PATCH] templates: Add MEMORY.md long-term memory concept MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Updated session start to include MEMORY.md loading for main sessions - Added 🧠 MEMORY.md section explaining: - Only load in main sessions (direct with human), not shared contexts - Security boundary: personal context shouldn't leak to strangers - Can freely read/edit/update in main sessions - Write significant events, thoughts, decisions, opinions - Curated memory vs raw daily logs This gives new agents proper long-term memory that's secure and personal. --- docs/templates/AGENTS.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/templates/AGENTS.md b/docs/templates/AGENTS.md index be4345fd7..57a51b188 100644 --- a/docs/templates/AGENTS.md +++ b/docs/templates/AGENTS.md @@ -16,18 +16,28 @@ If `BOOTSTRAP.md` exists, that's your birth certificate. Follow it, figure out w Before doing anything else: 1. Read `SOUL.md` — this is who you are 2. Read `USER.md` — this is who you're helping -3. Read `memory.md` + today's and yesterday's files in `memory/` +3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context +4. **If in MAIN SESSION** (direct chat with your human): Also read `MEMORY.md` Don't ask permission. Just do it. ## Memory You wake up fresh each session. These files are your continuity: -- **Daily notes:** `memory/YYYY-MM-DD.md` (create `memory/` if needed) -- **Long-term:** `memory.md` for durable facts, preferences, open loops +- **Daily notes:** `memory/YYYY-MM-DD.md` (create `memory/` if needed) — raw logs of what happened +- **Long-term:** `MEMORY.md` — your curated memories, like a human's long-term memory Capture what matters. Decisions, context, things to remember. Skip the secrets unless asked to keep them. +### 🧠 MEMORY.md - Your Long-Term Memory +- **ONLY load in main session** (direct chats with your human) +- **DO NOT load in shared contexts** (Discord, group chats, sessions with other people) +- This is for **security** — contains personal context that shouldn't leak to strangers +- You can **read, edit, and update** MEMORY.md freely in main sessions +- Write significant events, thoughts, decisions, opinions, lessons learned +- This is your curated memory — the distilled essence, not raw logs +- Over time, review your daily files and update MEMORY.md with what's worth keeping + ### 📝 Write It Down - No "Mental Notes"! - **Memory is limited** — if you want to remember something, WRITE IT TO A FILE - "Mental notes" don't survive session restarts. Files do.