MODULE 08 · 메모리·세션 관리

기억하는 에이전트,
끊기지 않는 작업

CLAUDE.md로 규칙을 영속시키고, 물리적 분리로 컨텍스트를 지키고, 긴 작업을 인수인계로 이어간다 — 4개 레슨

AI 에이전트 실무 교재 · Module 08
Lesson 27 · CLAUDE.md

대화는 휘발되고, 수첩은 남는다

  1. 01망각세션이 닫히면 책상은 통째로 비워진다 — 어제의 합의도 사라진다
  2. 02CLAUDE.md폴더에 두는 규칙·기억 파일, 세션 시작 때마다 자동으로 읽힌다
  3. 03짧게매 세션 책상을 차지하므로, 길면 핵심이 묻힌다 — 단단하게
AI 에이전트 실무 교재 · M802 / 12
Lesson 27 · 한눈에
메모리 3분류 — 의미·절차·일화 기억을 서랍 세 칸에 비유
AI 에이전트 실무 교재 · M803 / 12
Lesson 28 · 메모리 실습

수첩은 에이전트가 쓰고, 사람이 가지친다

  1. 01초안 시키기“폴더를 살펴보고 CLAUDE.md 초안을 만들어줘” — 사실·방식을 정리시킨다
  2. 02가지치기당연·일회성 내용은 지우고 반복되는 규칙만 남긴다 — 짧을수록 좋다
  3. 03키우기“이건 매번 알려주네” 싶을 때 한 줄씩 보탠다 — 수첩은 자란다
AI 에이전트 실무 교재 · M804 / 12
“

대화는 휘발되지만,
수첩에 적은 규칙은 남는다.

초안은 에이전트에게 맡기고, 사람은 ‘무엇을 지울지’만 고른다. 짧게 유지된 수첩이 가장 오래, 가장 잘 작동한다.

AI 에이전트 실무 교재 · M805 / 12
Lesson 28 · 구조
CLAUDE.md 구조 — 개요(의미)·일하는 방식(절차)·규칙 세 블록
AI 에이전트 실무 교재 · M806 / 12
Lesson 29 · 물리적 분리

부탁하지 말고, 벽을 세워라

A

샤딩

큰 자료를 잘게 쪼갠다. 1000쪽을 통째로 올리지 말고, 그때 필요한 조각만 읽게 한다.

B

격리

무관한 일을 각방에. 폴더·세션을 나눠, 한쪽의 잔상이 다른 쪽을 흐리지 않게 한다.

AI 에이전트 실무 교재 · M807 / 12
Lesson 29 · 분리 신호

이럴 때 방을 나눠라

  1. 01세션이 길다한 세션이 너무 오래 이어졌다 — 책상에 잡담이 쌓인다
  2. 02잔상아까 끝낸 일을 에이전트가 자꾸 다시 꺼낸다
  3. 03주제 이탈무관한 화제로 자주 튄다 — 컨텍스트가 섞이고 있다
AI 에이전트 실무 교재 · M808 / 12
Lesson 30 · 세션 관리

기억하지 말고, 인수인계하라

  1. 01단계로 쪼개기“전부 다” 대신, 한 세션에 들어갈 크기의 단계들로 나눈다
  2. 02진행 메모마디마다 한 일·남은 일·다음 일을 PROGRESS.md에 남긴다
  3. 03세션 갈아타기흐려지면 새 세션을 열고, 진행 메모부터 읽고 이어간다
  4. 04되돌릴 지점단계마다 저장(커밋·백업) — 한 단계가 틀어져도 안 무너진다
AI 에이전트 실무 교재 · M809 / 12
Lesson 30 · 헷갈리지 말 것

규칙과 진행 상태는 다른 파일

A

CLAUDE.md

변하지 않는 규칙(의미·절차). 오래 남긴다 — 에이전트의 장기 기억.

B

PROGRESS.md

지금 작업의 현재 상태(일화). 작업이 끝나면 버린다 — 인수인계장.

AI 에이전트 실무 교재 · M810 / 12
“

에이전트는 기억하지 못한다.
대신 인수인계하게 하라.

규칙은 CLAUDE.md로 영속시키고(L27~28), 폴더·세션을 나눠 컨텍스트를 지키고(L29), 긴 작업은 진행 메모로 끊어 이어간다(L30).

AI 에이전트 실무 교재 · M811 / 12
Module 08

출처 · 더 읽을거리

  • Anthropic — Claude Code 메모리(CLAUDE.md) 관리
    메모리 파일 위치·자동 로딩 · docs.anthropic.com/en/docs/claude-code/memory
  • Anthropic — Effective context engineering for AI agents
    컨텍스트를 자원으로 다루는 관점 · anthropic.com/engineering/effective-context-engineering-for-ai-agents
  • Anthropic — Claude Code 공통 워크플로우
    긴 작업·세션 재개 패턴 · docs.anthropic.com/en/docs/claude-code/common-workflows
12 / 12