memory-maintenance

name	memory-maintenance
description	Review recent daily logs and update MEMORY.md with significant learnings. Run weekly or on demand to keep long-term memory current.
disable-model-invocation	true

Memory Maintenance Protocol

Run this periodically (weekly recommended) to keep MEMORY.md current and useful.

Overview

• Daily logs (memory/YYYY-MM-DD.md) = raw notes, what happened
• MEMORY.md (context/MEMORY.md) = curated wisdom, long-term memory

Like a human reviewing their journal and updating their mental model.

Step 1: Read Recent Daily Logs

Read the last 7 days of daily logs from: memory/

List available files:

ls -la memory/

Step 2: Identify Significant Items

Look for items worth adding to MEMORY.md:

Personal Context:

• Family updates (schedules, milestones)
• Health appointments or changes
• Routine changes

Professional Context:

• New colleagues or contacts
• Project milestones or pivots
• Important meetings and outcomes
• Deadlines or commitments made

Working Relationship:

• What worked well in our collaboration
• Preferences discovered
• Tools or approaches that helped

Lessons Learned:

• Problems solved (and how)
• Mistakes to avoid
• Insights or "aha" moments

Step 3: Update MEMORY.md

Read current: context/MEMORY.md

Add:

• New learnings to appropriate sections
• Updated status on projects
• New contacts with context

Remove:

• Outdated information
• Completed items that no longer need tracking
• Stale context

Keep it under 300 lines - if getting too long, prioritize and trim.

Step 4: Archive Old Daily Logs (Optional)

If daily logs are piling up (30+ days):

mkdir -p memory/archive
mv memory/2026-02-*.md memory/archive/

Keep recent 30 days active, archive the rest.

Step 5: Update Timestamp

At the top of MEMORY.md, update:

_Last updated: [Today's date]_

Output

After completing maintenance, summarize:

• Items added to MEMORY.md
• Items removed or updated
• Any patterns noticed
• Suggested improvements

Schedule

Recommended: Run every Sunday evening or Monday morning as part of weekly planning.

Can also run:

• After major project completions
• After significant life events
• When MEMORY.md feels stale