Skip to main content
ClaudeWave
Skill1.3k repo starsupdated today

session-memory

Session Memory implements permission-free persistent storage across Claude Code session resets by maintaining three markdown files (activeContext.md, patterns.md, progress.md) in the .claude/cc10x/ directory. Use this skill at the start of every workflow to load prior context and decisions, before key decision points to check established patterns, and at the end of workflows to update learnings and task progress, ensuring continuity and consistency across message compaction events.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/a5c-ai/babysitter /tmp/session-memory && cp -r /tmp/session-memory/library/methodologies/cc10x/skills/session-memory ~/.claude/skills/session-memory
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Session Memory

## Overview

Persistent memory system that survives Claude Code's message compaction. Uses three markdown files in `.claude/cc10x/` as a permission-free database for continuity, consistency, and pattern compounding.

## Memory Surfaces

1. **activeContext.md** -- Current focus, decisions, learnings, next steps, blockers
2. **patterns.md** -- Project conventions, architecture decisions, common gotchas, reusable solutions
3. **progress.md** -- Task completion tracking with verification evidence

## Iron Law

EVERY WORKFLOW MUST:
1. LOAD memory at START (and before key decisions)
2. UPDATE memory at END (and after learnings/decisions)

## Stable Edit Anchors

Safe section headers for Edit operations:
- activeContext: `## Recent Changes`, `## Learnings`, `## References`
- patterns: `## Common Gotchas`, `## Project SKILL_HINTS`
- progress: `## Completed`, `## Verification`

## Read-Edit-Verify Pattern

1. Read file
2. Verify anchor exists
3. Edit with exact `old_string`
4. Read back to confirm

## Tool Rules

- Use `Write()` for NEW files (permission-free)
- Use `Edit()` for EXISTING files (permission-free)
- Never use `Write()` to overwrite existing files
- Never compound commands (`mkdir && cat`)

## When to Use

- At the start of every CC10X workflow (load)
- At the end of every CC10X workflow (update)
- Before making key decisions (check patterns)
- After discovering learnings or gotchas (persist)

## Agents Used

All CC10X agents use this skill. The cc10x-router manages load/update lifecycle.