domains / families / agent-tooling / hierarchical-agent-memory

hierarchical-agent-memory

authentic

Scoped CLAUDE.md memory system that reduces context token spend. Creates directory-level context files, tracks savings via dashboard, and routes agents to the right sub-context.

When to use

• Use when you want to reduce input token costs across Claude Code sessions
• Use when your project has 3+ directories and the agent keeps re-reading the same files
• Use when you want directory-scoped context instead of one monolithic CLAUDE.md
• Use when you want a dashboard to visualize token savings, session history, and context health
• Use when setting up a new project and want structured agent memory from day one

When not to use

• Token estimates use ~4 chars = 1 token approximation, not a real tokenizer
• Baseline savings comparisons are estimates based on typical agent behavior
• Dashboard requires Node.js 18+ and reads session data from `~/.claude/projects/`
• Context routing detection relies on CLAUDE.md read order in session JSONL files
• Does not auto-update subdirectory CLAUDE.md content — you maintain those manually or via `ham audit`
• Carbon estimates use regional grid averages, not real-time energy data

Skill page

Source