CLAUDE.md가 잡동사니 서랍처럼 변해서 수동 관리를 포기했습니다
My CLAUDE.md turned into a junk drawer so I stopped maintaining it by hand
핵심 요약
CLAUDE.md 관리의 어려움을 토로하며, 세션 로그를 기반으로 학습하는 자동화 메모리 시스템 memU 도입 사례를 공유합니다.
- CLAUDE.md 한계 — 규칙이 쌓이면서 관리 불가능한 잡동사니가 됨
- memU 도입 — 세션 로그를 분석해 필요한 규칙을 자동으로 추출함
- 메모리 관리 — 모델이 학습한 내용을 파일로 직접 수정 가능함
- 주의 사항 — 로그 기반 학습이라 잘못된 습관까지 학습할 위험이 있음
여기 있는 모두가 결국 겪게 되는 문제에 부딪혔음. CLAUDE.md는 처음엔 "pnpm 사용, 마이그레이션 건드리지 말 것" 같은 다섯 줄로 시작했는데, 몇 달 지나니 내가 쓴 건지 기억도 가물가물한 수백 줄짜리 잡동사니가 됐음. 상당 부분은 구식이 됐고. Claude는 매 세션마다 이 모든 걸 읽는데, 정작 중요한 규칙들은 3월에 삭제한 서비스를 위해 썼던 규칙들 사이에 파묻혀 있음.
임포트 문을 써서 docs 폴더로 분리해 봤지만 문제만 옮겨놓은 꼴이었음.
실제로 도움이 된 건 세션 로그를 가리키는 방식이었음. memU, Apache-2.0 라이선스, 무료, 내가 쓰는 부분엔 유료 티어 없음: https://github.com/NevaMind-AI/memU
설치 과정은 예상치 못한 부분이었음. 직접 설정 가이드를 따라갈 필요가 없음. Claude Code에 이 링크를 던져주면 알아서 함: https://raw.githubusercontent.com/NevaMind-AI/memU/main/SKILL.md
어떤 호스트인지 파악하고, 자체 어댑터를 선택하고, 세션 로그를 메모리로 추출하는 작업을 등록하고, 답변하기 전에 검색하도록 명령어 블록 하나를 패치함. 기록하고 주입하는 것, 그게 전부임. 내가 메시지 하나 보내면, 몇 분 동안 Claude가 스스로 검토하는 걸 지켜보기만 하면 됨.
메모리는 내가 열어볼 수 있는 파일 형태로 남음. 잘못된 걸 학습하면 블랙박스와 싸우는 대신 파일을 직접 수정하면 됨.
매일 달라진 점은 세션을 시작할 때 "기억해, 우리는 X를 써"라고 말할 필요가 없어졌다는 거임. 몇 주 전 다른 브랜치에서 설명했던 내용들이 알아서 다시 나옴. CLAUDE.md는 다시 실제 핵심 규칙들만 남게 됐음.
솔직히 경고하자면, 베타 버전이고 Python 3.13을 요구해서 10분 동안 욕하면서 설치했음. 그리고 로그에 실제로 일어난 일을 기반으로 학습하기 때문에, 내가 한 시간 동안 삽질한 세션은 모델이 그 삽질을 학습할 수 있는 세션이 됨.
혹시 몇 달 넘게 잘 유지되는 거대한 수동 관리 CLAUDE.md를 가진 사람 있음? 진짜 나만 겪는 문제인가 싶어서.

