tiered-memory

Implement hot, cold, and wiki memory tiers to reduce agent context load.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/Leep-GH/Lee-s-squad --skill tiered-memory-leep-gh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tiered-memory
Source: https://github.com/Leep-GH/Lee-s-squad/tree/main/packages/squad-cli/templates/skills/tiered-memory
Command: npx skills add https://github.com/Leep-GH/Lee-s-squad --skill tiered-memory-leep-gh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Context bloat occurs when Squad agents load their full history on every spawn, producing payloads of 34–74KB per agent and a large amount of obsolete data. Tiered-memory reduces this by organizing memory into Hot, Cold, and Wiki tiers, delivering substantial context reductions while preserving essential task knowledge.

Core Features & Use Cases

  • Hot Tier — Current session context is always loaded for immediate decisions and actions.
  • Cold Tier — Summarized cross-session history loaded on demand with a 30-day TTL to maintain continuity without replays.
  • Wiki Tier — Durable, structured knowledge loaded when domain expertise or stable conventions are required.
  • Use Case: Onboarding to unfamiliar subsystems, debugging recurring issues, and ADR-driven architectural decisions.

Quick Start

Spawn a Squad agent with tiered-memory to optimize context usage during a long-running task.

Frequently Asked Questions about tiered-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce agent context load for long-running tasks?

Apply a tiered memory model to reduce agent context load, organizing data into hot, cold, and wiki tiers to eliminate payload bloat during long-running tasks. This approach prevents agents from loading full history and obsolete data on every spawn.

What is the best way to manage AI agent memory across multiple sessions?

Manage AI agent memory across sessions by using a cold tier with a 30-day TTL that summarizes cross-session history. This loads on demand to maintain continuity without replaying past interactions, keeping active payloads small.

How does tiered memory work with spawn templates?

Tiered memory integrates directly into spawn templates by defining policies where hot memory is always loaded for immediate actions, cold memory is loaded on demand, and wiki knowledge is available when domain expertise is required.

Can I use tiered memory for debugging recurring agent issues?

Yes, you can use tiered memory for debugging recurring agent issues. The wiki tier provides durable, structured knowledge of stable conventions, while the cold tier maintains summarized cross-session history to track recurring problems efficiently.

Why does my Squad agent load a 74KB payload on every spawn?

Your Squad agent loads large 74KB payloads on every spawn because it loads its full history, including obsolete data. Implementing a tiered memory model separates hot, cold, and wiki tiers to deliver substantial context reductions.

Do I need tiered memory for ADR-driven architecture work?

Tiered memory is highly effective for ADR-driven architecture work because the wiki tier stores durable, structured knowledge for stable conventions. It ensures domain expertise is available on demand without bloating the active agent context.