UnseveredMemory

Unsevered Memory

A markdown-based memory system for Claude Code with enforced persistence.

Changelog

- Added support for Claude plugins + npx packaging

What Makes This Different

Most memory systems inject context at session start and hope Claude remembers. This doesn't work because:

1. Context compaction loses early instructions
2. Claude has no obligation to follow suggestions
3. Long sessions forget the protocol

Unsevered Memory solves this with enforcement:

The UserPromptSubmit hook survives context compaction by being injected fresh on every message.

Architecture

Installation

Choose your preferred method:

Option A: Claude Plugin (Recommended)

Then per-project:

Option B: npx

Option C: Manual

Then per-project:

What Gets Installed

Global (~/.claude/):
- CLAUDE.md - Global memory protocol
- settings.json - Hook configuration (3 hooks)
- hooks/ - memory-load, memory-remind, memory-save
- skills/orchestrate/ - Workflow instructions
- commands/orchestrate.md - Orchestrator command

Per-Project:

Workflow

Session Start
1. Hook loads context.md and scratchpad.md
2. Claude sees current state and any unfinished work
3. Hook hints about .ai/ documentation

During Session
Every prompt shows:

Claude writes to scratchpad.md as it works:

Claude updates .ai/ when patterns emerge (3+ uses).

Session End
1. Hook archives scratchpad to sessions/YYYY-MM-DD.md
2. Hook reminds to update context.md
3. Claude updates context with current state

Orchestrator Mode

For complex multi-step tasks:

The orchestrator:
1. Reads all memory files
2. Breaks task into subtasks
3. Delegates to specialized agents
4. Updates memory after each step
5. Never loses context

File Purposes

Repository Structure

Philosophy

- Enforced - UserPromptSubmit hook survives context compaction
-…