Subagent Persistent Memory (user · project · local 범위)
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 와 동일 규칙)

  1. Subagent 시스템 프롬프트에 메모리 디렉토리 읽기·쓰기 지침 포함
  2. MEMORY.md처음 200줄 또는 25KB 시스템 프롬프트 포함 (둘 중 먼저)
  3. Read·Write·Edit 도구 자동 활성화
  4. 임계 초과 시 큐레이션 지침 포함

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).