memory-systemlisted

# Memory System — Persistent Cross-Session Memory > Enables agents to remember across sessions. Never re-discover what was already learned. ## Overview The Memory System provides **persistent, searchable memory** that survives across sessions. Instead of re-explaining preferences, conventions, and past decisions every time, agents read a structured MEMORY.md index and topic files. **Token Impact:** +1,000 tokens to load index, but saves 3,000-10,000 tokens by eliminating re-discovery. --- ## Architecture ``` .aim-agents/memory/ ├── MEMORY.md ← Lightweight index (max 200 lines) ├── user-preferences.md ← Topic file: user role, style, tools ├── project-conventions.md ← Topic file: coding standards, patterns ├── tech-decisions.md ← Topic file: past architectural decisions ├── feedback-history.md ← Topic file: what user liked/disliked └── [topic-name].md ← Additional topic files as needed ``` --- ## MEMORY.md Index Format The index is a **lightweight pointer file** — short entries that reference topic files for details. **Rules:** - Maximum **200 lines** total - Each entry: **~150 characters max** - Format: `- [type] summary → topic-file.md` - Types: `[user]` `[feedback]` `[project]` `[reference]` **Example:** ```markdown # Memory Index ## User - [user] Prefers dark mode, uses Windows 11, PowerShell → user-preferences.md - [user] Senior DevOps engineer, 8 years experience → user-preferences.md - [user] Primary language: English, sometime