매일 아침 Claude Code를 열 때마다 같은 말을 반복한 경험이 있는가. "우리는 NextAuth 안 써요, Clerk 써요." 하루가 지나면 같은 말을 또 해야 한다. dev.to에 올라온 MEMORY.md 워크플로우 소개 글은 이 반복이 단순한 불편함이 아니라 실측 가능한 생산성 손실임을 지적한다. 세션당 10~15분, 한 달 기준으로 쌓이면 최대 10시간을 맥락 재건에 허비한다는 것이다. 문제의 본질은 Claude Code의 구조에 있다—매 세션은 새로운 컨텍스트 윈도우에서 시작하고, --continue 플래그조차 단 하나의 직전 대화만 이어붙일 수 있다.
많은 개발자가 이미 CLAUDE.md를 쓰고 있다. "Vitest로 테스트한다", "커밋 메시지는 Conventional Commits 형식으로"—이런 정적 규칙을 담는 파일이다. 그런데 이것만으로는 절반만 해결된다. 프로젝트에는 정적 규칙 외에 진화하는 상태(evolving state)가 존재하기 때문이다. 지난주에 Prisma에서 Drizzle로 마이그레이션했다는 사실, 대시보드 리디자인이 feature/dashboard-v2 브랜치에서 진행 중이라는 맥락, /api/search에서 레이트 리미터 오탐이 발생하고 있다는 버그 상태—이것들은 한 달 후엔 낡은 정보가 되지만, 지금 이 순간엔 AI가 반드시 알아야 할 컨텍스트다. MEMORY.md는 바로 이 레이어를 채우기 위한 파일이다.
구조는 단순하다. 프로젝트 루트에 MEMORY.md를 만들고, 각 항목을 150자 이내의 포인터로 채운다. 핵심은 '내용 덤프'가 아니라 '위치 안내'다. [Auth](src/lib/auth/) - Clerk since March 2026. Migrated from NextAuth.—이 한 줄이면 충분하다. Claude는 이 포인터를 읽고 실제 코드로 직접 이동한다. ETH Zurich의 AGENTbench 연구(Gloaguen et al., 2026)에 따르면 컨텍스트 파일이 길어질수록 에이전트 성공률은 약 3% 하락하고 비용은 최대 19% 증가한다. 전형적인 에이전트 세션에서 토큰의 80%가 "무언가를 찾는" 데 소비된다는 분석도 이 방향을 지지한다. 짧은 포인터가 이 탐색 비용을 제거한다.
MEMORY.md에는 200라인 또는 25KB라는 하드 리밋이 있다. 초과된 항목은 경고 없이 무시된다. 이 제약이 오히려 워크플로우를 훈련시킨다. 들어가야 할 것은 결정 사항(날짜 포함), 진행 중인 마이그레이션, WIP 브랜치·이슈 번호, 알려진 버그, 디프리케이션 데드라인이다. 들어가면 안 되는 것은 정적 규칙(CLAUDE.md의 몫), 코드 스니펫(소스 파일의 몫), 아키텍처 문서(docs/ 디렉터리의 몫)다. Claude Code v2.0.64부터 제공되는 AutoDream 자동 메모리 기능은 24시간 이상, 5세션 이상이 지난 후 패턴을 통합하지만, "4월 5일에 SWR 대신 TanStack Query를 선택했다"는 구체적 의사결정은 포착하지 못한다. MEMORY.md는 그 수동 보완재다.
유지보수 워크플로우도 간단하다. 세션 말미에 Claude에게 프롬프트 하나를 던진다—"이번 세션에서 배운 것으로 MEMORY.md를 업데이트해줘. 새 결정, 변경된 아키텍처, 해결된 버그를 150자 이내 포인터로. 더 이상 유효하지 않은 항목은 삭제해줘." Claude는 방금 작업을 수행했으니 무엇이 바뀌었는지 안다. 결과 diff를 리뷰하고 승인하면 끝이다. 훅도, 자동화도, 서드파티 도구도 필요 없다. 한 달에 한 번은 항목을 정리한다—30일 이상 안정된 내용은 CLAUDE.md로 졸업시키고, 더 이상 사실이 아닌 항목은 삭제한다. "Prisma에서 Drizzle로 마이그레이션, 4월 2일"은 한 달 후 CLAUDE.md의 ORM: Drizzle (not Prisma)라는 정적 규칙이 된다.
이 패턴이 지금 더 중요해진 이유가 있다. AI 코딩 도구의 보조금 시대가 끝나고 있다. Microsoft는 2026년 6월 1일부로 Copilot 정액제를 종료하고 종량제로 전환한다. Anthropic의 Claude Enterprise 역시 고정 사용량 모델에서 변동 과금 구조로 이동했고, 헤비 유저의 비용이 두 배 이상 오를 것이라는 분석이 나온다. 같은 dev.to에 올라온 "The End of Subsidised AI Coding Is Already Here"는 투자자 자본으로 만들어진 저렴한 AI 코딩 경험이 실제 가격으로 수렴하는 지금 국면을 3달러짜리 우버 시대의 종언에 빗댄다. AI 도구 비용이 올라가는 국면일수록, 도구를 더 효율적으로 쓰는 구조가 경쟁력이 된다. MEMORY.md 패턴은 바로 그 구조 설계의 구체적 사례다—컨텍스트 재건에 낭비되는 토큰과 시간을 줄이고, AI가 실제 문제 해결에 집중하게 만드는 설계.
MEMORY.md가 보여주는 더 넓은 시사점은 AI 어시스턴트를 어떻게 설계할 것인가의 문제다. 도구가 똑똑해지는 것을 기다리는 대신, 도구가 더 잘 작동하도록 환경을 설계하는 태도. 이것은 단순히 파일 하나를 추가하는 작업이 아니라, AI와의 협업 구조를 의식적으로 만드는 실천이다. CLAUDE.md가 AI에게 '어떻게 일해야 하는지'를 가르치는 파일이라면, MEMORY.md는 '지금 우리가 어디 있는지'를 전달하는 파일이다. 이 두 레이어가 함께 작동할 때, Claude Code는 매일 아침 새로 만나는 도구가 아니라 어제 하던 일을 기억하는 동료가 된다. 5분 셋업, 세션 말미의 프롬프트 한 줄—시작은 이것으로 충분하다.