CLAUDE.md에 모든 프로젝트 기억을 넣지 않는 방법
는 저장소 안에서 지켜야 할 규칙을 적는 데 잘 맞는다. 테스트 실행 방법, 코딩 방식, 특이한 구조, 건드리면 안 되는 오래된 폴더 같은 안정적인 지침을 담기 좋다.
하지만 제품 결정을 왜 했는지, 어떤 고객 제보에서 문제가 시작됐는지, 지난 작업 뒤에 무엇이 바뀌었는지, 이번 주 출시 상황에서 무엇이 중요한지, 깃허브 밖에 남은 후속 일이 무엇인지까지 넣으면 금방 낡고 길어진다. 이런 내용을 빼면 Claude Code는 자체는 다룰 수 있지만, 실제 일이 생긴 배경을 놓치기 쉽다.
더 나은 나눔은 에는 오래 유지되는 저장소 규칙만 두고, 이슈··문서에는 확인 가능한 자료를 두며, 사람·결정·미해결 일·시간에 따라 바뀌는 내용은 별도 메모리 층에 두는 방식이다. 는 필요한 범위의 문맥만 받아야 하고, 어떤 자료나 메모리를 근거로 썼는지도 보여줘야 한다.
핵심 포인트
- 는 테스트 방법, 코딩 규칙, 구조 설명처럼 잘 변하지 않는 저장소 지침에 알맞다.
- 제품 결정 이유, 고객 제보, 최근 작업 변화, 출시 맥락, 남은 후속 일은 에 넣으면 쉽게 낡는다.
- 이런 배경 정보를 빼면 Claude Code가 코드 작업은 해도 일의 이유와 우선순위를 놓칠 수 있다.
- 안정적인 규칙, 확인 가능한 자료, 를 서로 나누는 방식이 제안된다.
- 가 어떤 자료나 메모리를 사용했는지 보여주는 것이 중요하다.