01-개념

01. 개념 — 잊지 않는 것은 파일이다

”각 새 세션은 기억 없이 시작한다”

Anthropic의 “Effective Harnesses for Long-Running Agents”는 장기 작업의 핵심 문제를 한 줄로 요약한다.

“Each new session begins with no memory of what came before.”

의역: “각 새 세션은 이전의 어떤 기억도 없이 시작한다.”

해결책은 단순하다 — 세션 밖에 파일을 둔다. 같은 글이 권하는 약속된 파일은 claude-progress.txt, init.sh, 그리고 git 커밋 히스토리.

Memory Tool — Anthropic 공식

Claude Developer Platform의 Memory Tool은 “file-based system” — “파일 기반 시스템” 으로 작동한다. Claude가 전용 디렉터리에 파일을 만들고 읽고 갱신·삭제한다. 세션을 넘는다.

성능 수치 재인용:

• Memory Tool + Context Editing 결합: +39% 성능 (에이전트 검색).
• Context Editing 단독: +29%.
• 100턴 웹 검색에서 토큰 사용량 -84%.

OMC의 3종 세트

OMC CLAUDE.md가 명시한 디렉터리.

.omc/state/              # 모드 상태 (JSON)
.omc/state/sessions/{id}/
.omc/notepad.md          # 세션 지속 노트
.omc/project-memory.json # 세션을 넘는 프로젝트 지식
.omc/plans/              # 계획 문서
.omc/research/
.omc/logs/

세 가지 라이프사이클이 분리돼 있다.

파일	라이프사이클	용도
state/	모드 1회 실행	ralph/team 등 실행 모드의 진행 상태
notepad.md	세션 단위	같은 세션의 결정·메모
project-memory.json	프로젝트 영구	세션을 넘는 패턴·디렉티브

”코드처럼 관리되는 메모리”

핵심 통찰: 메모리도 git diff로 본다. 매 회 무엇이 추가/수정/삭제됐는지 사람이 검토 가능. 모델이 임의로 덮어쓰지 못하게 권한과 절차를 둔다 — OMC의 notepad_write_priority, project_memory_add_directive 같은 도구가 그 절차다.