memory-sync

Persist session learnings to CLAUDE.md and project memory files.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/mattpainter701/my-claude-setup --skill memory-sync-mattpainter701
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-sync
Source: https://github.com/mattpainter701/my-claude-setup/tree/main/claude-config/global-skills/memory_sync
Command: npx skills add https://github.com/mattpainter701/my-claude-setup --skill memory-sync-mattpainter701

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proactively sync session learnings to persistent memory files that the built-in auto-memory system cannot update: CLAUDE.md files, skill files, and project-local memory/MEMORY.md. This runs in a forked context to avoid bloating the main conversation.

Core Features & Use Cases

  • Auto-syncs learnings to CLAUDE.md, memory files, and project memory in a forked context to minimize main conversation bloat.
  • Defines ownership and scope: what is auto-memory vs this skill.
  • Trigger rules: auto-invoke after milestones, sprint completions, or notable debugging sessions.

Quick Start

After completing a milestone, run memory-sync to persist session learnings to CLAUDE.md and project memory.

Frequently Asked Questions about memory-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist Claude session learnings to CLAUDE.md automatically?

To persist session learnings to CLAUDE.md automatically, use a memory synchronization skill that writes your debugging insights and milestone outcomes to persistent memory files in a forked context.

Why does auto-memory drift happen during long Claude coding sessions?

Auto-memory drift happens because the built-in auto-memory system cannot update CLAUDE.md, skill files, or project-local MEMORY.md directly, requiring a dedicated sync process to capture evolving session context.

When should I sync session learnings to project memory files?

You should sync session learnings to project memory files after reaching project milestones, completing sprints, or resolving notable debugging sessions to ensure persistent context stays current.

Can I update CLAUDE.md and MEMORY.md without bloating the main conversation?

You can update CLAUDE.md and MEMORY.md without bloating the main conversation by running a memory sync operation in a forked context, isolating the file writing process from your active session.

What is the best way to manage memory persistence across Claude project transitions?

The best way to manage memory persistence across project transitions is to trigger an auto-sync process that explicitly writes session learnings to CLAUDE.md and project-local MEMORY.md files.

Does the built-in auto-memory system update project memory files?

The built-in auto-memory system does not update project memory files like CLAUDE.md or MEMORY.md, necessitating a separate memory-sync skill to define ownership and persist these specific learnings.