Hierarchical Agent Memory (HAM)

Scoped memory system that gives AI coding agents a cheat sheet for each directory instead of re-reading your entire project every prompt. Root CLAUDE.md holds global context (~200 tokens), subdirectory CLAUDE.md files hold scoped context (~250 tokens each), and a .memory/ layer stores decisions, patterns, and an inbox for unconfirmed inferences.

When to Use This Skill

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

How It Works

Step 1: Setup ("go ham")

Auto-detects your project platform and maturity, then generates the memory structure:

Hierarchical Agent Memory (HAM)

When to Use This Skill

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

How It Works

Step 1: Setup ("go ham")

Auto-detects your project platform and maturity, then generates the memory structure:

Trigger	What it does
`go ham`	Set up HAM — auto-detect platform, generate CLAUDE.md files
`ham savings`	Show token and cost savings report
`ham dashboard`	Launch the interactive web dashboard
`ham audit`	Health check on memory files
`ham insights`	Generate actionable insights from session data
`ham route`	Add/update Context Routing section in root CLAUDE.md
`ham carbon`	Show energy and carbon efficiency data

Hierarchical Agent Memory

Hierarchical Agent Memory (HAM)

When to Use This Skill

How It Works

Step 1: Setup ("go ham")

Hierarchical Agent Memory

Hierarchical Agent Memory (HAM)

When to Use This Skill

How It Works

Step 1: Setup ("go ham")

Step 2: Context Routing

Step 3: Dashboard ("ham dashboard")

Commands

Examples

Example 1: First-time setup

Example 2: Checking savings

Best Practices

Limitations

Mcporter

Sonoscli

Openhue

Healthcheck

Things Mac

Eightctl

Hierarchical Agent Memory

Hierarchical Agent Memory (HAM)

When to Use This Skill

How It Works

Step 1: Setup ("go ham")

Hierarchical Agent Memory

Hierarchical Agent Memory (HAM)

When to Use This Skill

How It Works

Step 1: Setup ("go ham")

Step 2: Context Routing

Step 3: Dashboard ("ham dashboard")

Commands

Examples

Example 1: First-time setup

Example 2: Checking savings

Best Practices

Limitations

Related Skills

Mcporter

Sonoscli

Openhue

Healthcheck

Things Mac

Eightctl