🧠
AI EngineeringJavaScript

Hipocampus Compaction

by kevin-hs-sohn

Hipocampus Compaction is an AI Engineering skill for Claude Code, published by kevin-hs-sohn in hipocampus.

206 stars10 forkson kevin-hs-sohn/hipocampusAdded 2026/09/05Repository updated 2026/06/08
agent-memoryai-agentai-memoryclaude-codecompaction-treecontext-managementknowledge-managementllmlong-term-memoryopenclawragvector-search
Install in seconds
Install Hipocampus Compaction
Copy Hipocampus Compaction into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/kevin-hs-sohn/hipocampus/tree/main/skills/compaction ~/.claude/skills/compaction

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/kevin-hs-sohn/hipocampus.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
skills/compaction/SKILL.md in kevin-hs-sohn/hipocampus
Installs to
~/.claude/skills/compaction
Collection
One of 8 skills cataloged from this repository
Category
AI Engineering3101 skills

What Hipocampus Compaction does

Hipocampus Compaction builds a five-level memory compaction tree from raw logs into daily, weekly, monthly, and root indices. Use it at session start or from a scheduler to keep search indices current without deleting originals.

Hipocampus Compaction is cataloged under AI Engineering on DirSkills. Hipocampus Compaction comes from a repository tagged agent-memory, ai-agent, ai-memory, claude-code and compaction-tree.

Documentation

README

Memory Compaction Tree

5-level hierarchical index over raw memory logs. Compaction nodes are search indices — originals are never deleted.

Hierarchy

memory/
  ROOT.md                      <- root node (topic index, ~3K tokens, Layer 1)
  2026-03-15.md                <- raw daily log (permanent, append-only)
  daily/2026-03-15.md          <- daily compaction node
  weekly/2026-W11.md           <- weekly compaction node
  monthly/2026-03.md           <- monthly compaction node

Compaction chain: Raw → Daily → Weekly → Monthly → Root

Tree traversal (search): Root → Monthly → Weekly → Daily → Raw

Fixed vs Tentative Nodes

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Hipocampus Compaction

  • What else does kevin-hs-sohn publish alongside Hipocampus Compaction?

    Hipocampus Compaction is one of 8 skills that DirSkills catalogs from kevin-hs-sohn/hipocampus, the repository it ships in. Its siblings there include Hipocampus Core, Hipocampus Core and Hipocampus Core. Each one is a separate skill with its own page in this directory, installs the same way Hipocampus Compaction does, and is maintained by kevin-hs-sohn in that same repository. The rest of the collection is listed on the kevin-hs-sohn/hipocampus page.

  • How does Hipocampus Compaction compare to other AI Engineering skills?

    Hipocampus Compaction ranks #2780 by stars among the 3101 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Hipocampus Compaction against them. Open each page to compare what they document and how they install.

More from kevin-hs-sohn/hipocampus

Hipocampus Compaction is one of 8 skills cataloged on DirSkills from kevin-hs-sohn/hipocampus.

See all 8 skills
🧠
49m ago

Hipocampus Core

Hipocampus Core defines a multi-tier memory protocol for Claude Code sessions, including startup reads, compaction checks, checkpoints, and daily log updates. Use it when an agent needs persistent working state and structured memory maintenance.
AI Engineering
20610
🧠
49m ago

Hipocampus Core

Hipocampus Core defines a multi-tier agent memory protocol with session-start checks, task lifecycle rules, and compaction guidance. Use it to manage persistent memory files and structured checkpoints across sessions.
AI Engineering
20610
🧠
49m ago

Hipocampus Core

Hipocampus Core defines a 3-tier agent memory protocol with session start, checkpoint, and compaction rules. Use it to manage persistent memory files and task state across Claude Code sessions.
AI Engineering
20610
🧠
49m ago

Hipocampus Core

Hipocampus Core defines a 3-tier memory system for Claude Code, including session start checks, end-of-task checkpoints, and memory file maintenance. Use it to keep long-running agent work organized and recoverable.
AI Engineering
20610
🧠
49m ago

Hipocampus Flush

Hipocampus Flush dumps the current session context to the daily raw log through a subagent. Use it before compaction when you want to persist what happened in the session.
AI Engineering
20610
🧠
49m ago

Hipocampus Recall

Hipocampus Recall guides a three-step memory lookup: ROOT.md triage, manifest-based file selection, then qmd search fallback. Use it when a question may depend on past notes or compacted memory.
AI Engineering
20610