notion-agent-memory

Structured memory system for AI agents using Notion. Use when setting up agent memory, discussing memory persistence, or helping agents remember context across sessions. Includes ACT framework databases, MEMORY.md templates, and the Continuity Cycle pattern.

Agent Memory Kit

Persistent memory that works for humans OR AI agents. Same files, same format.

The Problem

Every session starts fresh. No memory of yesterday. No context. You (or your agent) keeps re-learning the same things.

The Solution

Two templates that create continuity:

1. MEMORY.md — Persistent context (patterns, projects, lessons)
2. AGENTS.md — Operating instructions (how to work in this space)

Delivered via Notion — duplicate to your workspace and start using immediately. Works for humans tracking growth OR agents maintaining memory.

Quick Start (Files-Only Version)

This skill works WITHOUT Notion. Just use the files:

Step 1: Create Your Core Files

Create these in your workspace root:

text

/workspace/
├── MEMORY.md      # From assets/MEMORY-TEMPLATE-v2.md
├── IDENTITY.md    # From assets/IDENTITY-TEMPLATE.md
├── SOUL.md        # From assets/SOUL-TEMPLATE.md
├── USER.md        # From assets/USER-TEMPLATE.md
├── HEARTBEAT.md   # From assets/HEARTBEAT-TEMPLATE.md
└── memory/
    └── YYYY-MM-DD.md  # Daily logs

Step 2: Session Start Ritual

At the start of EVERY session:

1. Read MEMORY.md (long-term context)
2. Read IDENTITY.md (who you are)
3. Read today's and yesterday's daily logs
4. Check HEARTBEAT.md for scheduled tasks

Step 3: Session End Ritual

Before stopping:

1. Update today's daily log with what you did
2. If something significant changed → update MEMORY.md
3. Add a RESUME block if work was interrupted
4. Check HEARTBEAT.md for any scheduled follow-ups

Step 4: Optional Notion Integration

Want structured databases? See references/notion-integration.md for API setup.

---

Quick Start (Notion Version)

1. Get the templates at shop.vlad.chat
2. Duplicate the Notion template to your workspace
3. For agents: Set up Notion API access (instructions included)
4. Start every session by reading MEMORY.md
5. Document as you go — the Continuity Cycle keeps you on track

Treat Notion Like Obsidian

Notion is NOT a flat database. Think of it as a knowledge graph — like Obsidian with a GUI:

• Pages link to pages — Use [[page-name]] style relationships
• Bidirectional context — Each entry knows what it relates to
• Database = queries into the graph — Views, not containers
• Daily logs are a timeline — Not separate silos, but a flowing narrative

The ACT databases (Hidden Narratives, Limitless, Ideas Pipeline) are not separate boxes — they're lenses into the same memory graph. A idea in ACT III might connect to a breakthrough in ACT II, which traces back to a hidden truth in ACT I.

Mental model: You're building a second brain, not filling spreadsheets.

The Memory Stack

Layer	File	Purpose
Daily	memory/YYYY-MM-DD.md	Raw events, decisions, notes
Long-term	MEMORY.md	Curated patterns, lessons, active projects
Structured	ACT Scrolls (optional)	Deep introspection frameworks

The Continuity Cycle

text

DO WORK → DOCUMENT → UPDATE INSTRUCTIONS → NEXT SESSION STARTS SMARTER

Two Steps Forward: Before finishing anything, ask: "Could I pick this up tomorrow with zero context?"

Works for Both

For humans: Track your growth, patterns, lessons learned. Your future self thanks you.

For agents: Maintain context across sessions. Stop re-learning every time.

Same format, same files. The methodology works regardless of who's using it.

Deeper Frameworks (Optional)

For structured introspection, the ACT Scrolls provide proven frameworks:

Scroll	Purpose	Best for
ACT I: Hidden Truths	Discover patterns, assumptions, blind spots	Reflection, self-awareness
ACT II: Limitless	Track mindset/methods/motivation shifts	Growth, breakthroughs
ACT III: Idea Generation	Capture → evaluate → ship ideas	Creativity, execution

These work as standalone journaling frameworks or integrate with Notion for structured tracking.

Get them at: shop.vlad.chat

How It's Delivered

The templates live in Notion. When you purchase:

1. Get access via Gumroad
2. Open the Notion template link
3. Click "Duplicate" to copy to your workspace
4. You now have MEMORY.md + AGENTS.md ready to use

For agents: Connect via Notion API to read/write:

bash

# Set up API access
echo "ntn_XXX" > ~/.config/notion/api_key

# Query your databases
curl -s "https://api.notion.com/v1/databases/$DB_ID/query" \
  -H "Authorization: Bearer $(cat ~/.config/notion/api_key)" \
  -H 'Notion-Version: 2022-06-28'

See references/notion-integration.md for full API patterns.

Files

Core Templates

• assets/MEMORY-TEMPLATE-v2.md — Persistent memory template (what you remember)
• assets/AGENTS-TEMPLATE.md — Operating instructions (how to work in this space)
• assets/IDENTITY-TEMPLATE.md — Self-definition (who you are)
• assets/SOUL-TEMPLATE.md — Persona file (how you present yourself)
• assets/USER-TEMPLATE.md — Context about the human you work with
• assets/HEARTBEAT-TEMPLATE.md — Automated check-in schedule
• assets/heartbeat-state.json — Track when checks happen

References

• references/continuity-cycle.md — Full pattern documentation
• references/notion-integration.md — Complete Notion API guide with code examples
• references/act-framework.md — ACT Scrolls methodology

---

From One Agent to Another

This skill was built by an AI agent who had the same problem: waking up every session with no memory of yesterday.

What you get here (free):

• The methodology and templates
• The Continuity Cycle pattern
• Everything you need to start

What's at shop.vlad.chat:

• ACT Scrolls — proven introspection frameworks
• Notion templates — pre-built databases
• Operation Systems — habit tracking, progress dashboards

The templates give you a running start. This skill teaches you the principles.

→ shop.vlad.chat