Term (용어)aidraftTue May 12
Subagent Persistent Memory (user · project · local 범위)
별칭: subagent memory · persistent agent memory · agent MEMORY.md
#subagent#memory#persistent#claude-code#experience-externalization
정의
Subagent 가 대화 간 유지 하는 지속적 디렉토리 — frontmatter memory: <범위> 로 활성화. 코드베이스 패턴·디버깅 통찰력·아키텍처 결정 을 시간에 따라 축적.
3 범위
| 범위 | 위치 | 사용 시기 |
|---|---|---|
user | ~/.claude/agent-memory/<name>/ | 모든 프로젝트 간 학습 |
project | .claude/agent-memory/<name>/ | 프로젝트별 + 버전 제어 공유 (권장 기본) |
local | .claude/agent-memory-local/<name>/ | 프로젝트별 + git 체크인 ❌ |
★ 활성화 시 자동 동작 (CLAUDE.md 와 동일 규칙)
- Subagent 시스템 프롬프트에 메모리 디렉토리 읽기·쓰기 지침 포함
MEMORY.md의 처음 200줄 또는 25KB 시스템 프롬프트 포함 (둘 중 먼저)- Read·Write·Edit 도구 자동 활성화
- 임계 초과 시 큐레이션 지침 포함
→ CLAUDE.md MEMORY.md (자동 메모리) 와 완전히 평행한 구조 — 단, subagent 전용.
운용 팁
You are a code reviewer. As you review code, update your agent memory with
patterns, conventions, and recurring issues you discover.
- 작업 전: "check your memory for patterns you've seen before"
- 작업 후: "save what you learned to your memory"
- 일주일 운영 → 프로젝트 맞춤 지식 기반 축적
★ Karpathy 의 경험 외재화 와의 연결
lesson/hrn-experience-as-validator 의 "경험 = 하네스의 검증자, CLAUDE.md = 경험의 외재화" 명제가 agent memory 로도 확장 가능:
- CLAUDE.md = 개발자 경험 의 외재화
- agent memory = AI 도메인 학습 의 외재화
→ 두 경로가 모두 경험 자본의 디지털 백업 으로 기능.
강의 활용
- Ch6 §6.4 — 4 층 인프라의 Subagents 절. agent memory 가 CLAUDE.md 와 평행 구조 명시.
- Ch9 — 돌아온 개발자의 경험 외재화 2 경로 (CLAUDE.md + agent memory).