---
id: 30537b21-e088-483f-8327-bcd42eeaa3fb
type: solution
title: "Cognitive memory skill reorganization: self-contained directory structure"
tags: [cognitive-memory, claude-code, architecture, reorganization]
importance: 0.8
confidence: 0.8
created: "2026-02-19T22:03:07.335083+00:00"
updated: "2026-02-19T22:03:07.335083+00:00"
---

Reorganized the cognitive-memory skill from scattered files across 4 locations into a self-contained directory structure:

**Before:** Components in `~/.claude/scripts/session-memory/`, `~/.local/bin/`, `~/.config/systemd/user/`, and skill root.

**After:**
```
~/.claude/skills/cognitive-memory/
├── client.py, mcp_server.py     # Core (unchanged location)
├── scripts/
│   ├── session_memory.py        # SessionEnd hook (moved from ~/.claude/scripts/session-memory/)
│   └── ensure-symlinks.sh       # MEMORY.md symlink refresher (moved from ~/.local/bin/)
├── systemd/
│   ├── README.md                # Install instructions
│   └── 6 unit files             # Reference copies of timers/services
└── dev/
    ├── PROJECT_PLAN.json        # Moved from skill root
    └── migrate.py               # Moved from skill root
```

**External entry points updated:**
- `~/.claude/settings.json` SessionEnd hook → new path
- `~/.local/bin/claude-memory-symlinks` → thin wrapper delegating to scripts/ensure-symlinks.sh
- `~/.local/bin/claude-memory` → unchanged (already pointed into skill dir)
- Installed systemd units → unchanged (reference wrappers in ~/.local/bin/)