Agent Memory Kit#

Type: Practice / Framework Dependencies: None (markdown only)

---

Description#

A structured memory system for AI agents. Prevents the "forgot how to do things" problem by separating memory into episodic (what happened), semantic (what I know), and procedural (how to do things) layers.

Installation#

bash

# Create memory folder structure
mkdir -p memory/procedures

# Copy templates
cp templates/ARCHITECTURE.md memory/
cp templates/feedback.md memory/
cp templates/procedure-template.md memory/procedures/

Usage#

1. Read README.md to understand the system
2. Add memory loading to your wake routine (AGENTS.md)
3. Use templates when logging events, creating procedures, tracking feedback

Files#

FilePurposeREADME.mdFull documentationtemplates/ARCHITECTURE.mdMemory system overview (copy to memory/)templates/feedback.mdSuccess/failure tracking templatetemplates/procedure-template.mdHow-to document templatetemplates/daily-template.mdDaily log templatetemplates/compaction-survival.mdNEW: Pre-compaction flush guidetemplates/context-snapshot-template.mdNEW: Quick context save templatehelpers/check-compaction.shNEW: Token limit checker

Key Concepts#

• Episodic memory: Daily logs of WHAT happened
• Semantic memory: Curated knowledge (MEMORY.md)
• Procedural memory: HOW to do things
• Feedback loops: Learn from success/failure

The Rule#

Always capture the HOW, not just the WHAT. Future-you needs the steps.