memory-architecture

Claude Code Memory Architecture

Content Preview
# Claude Code Memory Architecture

A complete reference for how Claude Code's memory systems work together.

## Three Memory Systems

### 1. CLAUDE.md Files (You → Claude)

**Purpose:** Persistent instructions you write to guide Claude's behavior.

**Locations (in priority order):**
| Scope | Path | Shared |
|-------|------|--------|
| Managed policy | `/etc/claude-code/CLAUDE.md` (Linux) | All users |
| Project | `./CLAUDE.md` or `./.claude/CLAUDE.md` | Team (git) |
| User | `~/.claude/CLAUDE.m
How to Use

Recommended: Install to project (local)

mkdir -p .claude/skills
curl -o .claude/skills/memory-architecture.md \
  https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/engineering-team/self-improving-agent/reference/memory-architecture.md

Skill is scoped to this project only. Add .claude/skills/ to your .gitignoreif you don't want to commit it.

Alternative: Clone full repo

git clone https://github.com/alirezarezvani/claude-skills

Then reference at engineering-team/self-improving-agent/reference/memory-architecture.md

Related Skills