---
name: agent-memory
description: Persistent memory management for coding sessions. The agent can store and retrieve context, decisions, and patterns across sessions. Use this to maintain continuity between conversations.
---

# Agent Memory

## How memory works
The agent maintains memory files in `.agex/memory/` with structured entries:

### Memory types
- **decisions** — architectural choices, tech stack decisions, design patterns chosen
- **patterns** — recurring code patterns, naming conventions, file structure
- **context** — project state, current sprint, team agreements
- **learnings** — what worked, what didn't, debugging insights

### Memory operations
- **Store**: save a new memory entry with type, content, and timestamp
- **Recall**: retrieve memories relevant to the current task
- **Update**: modify existing memories when context changes
- **Prune**: remove outdated or superseded memories

### Best practices
- Store the *why*, not just the *what*
- Prune after major refactors
- Tag memories with relevant file paths
- Keep individual entries concise (< 200 words)