> For the complete documentation index, see [llms.txt](https://byulseop-til.gitbook.io/sinheeseop_til/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://byulseop-til.gitbook.io/sinheeseop_til/ai-agent/claude/undefined-5.md).

# 프로젝트 메모리

Claude Code가 프로젝트마다 지켜야 할 규칙이나 이전에 겪은 시행착오를 다음 세션에도 이어서 기억하게 만드는 두 가지 방법이 있다.

## 프로젝트 지침 파일

프로젝트 루트에 지침 파일을 하나 두면 세션을 새로 시작할 때마다 그 내용을 자동으로 읽어들인다. 코딩 스타일, 문서 작성 규칙, 디렉토리 구조 같은 이 프로젝트만의 규칙을 적어두는 곳이다. 매번 같은 설명을 반복하지 않아도 되고, 사람마다 다르게 지시해서 결과물이 들쭉날쭉해지는 것도 막을 수 있다.

이 파일을 저장소에 커밋해서 팀 전체가 공유할 수도 있고, 개인 작업 습관에 가까운 내용이라면 `.gitignore`에 올려서 로컬에만 남겨둘 수도 있다. 후자를 선택하면 그 파일로 가는 마크다운 링크는 저장소에 넣지 않는 게 좋다 — 저장소를 새로 내려받은 사람에게는 없는 파일이라 링크가 깨진다.

## 자동으로 쌓이는 메모리

지침 파일과 별개로, 세션 도중 사용자가 알려준 교훈 중에서 앞으로도 계속 적용해야 할 내용은 별도의 메모리 파일로 저장해둔다. 지침 파일이 사람이 직접 정리해서 넣어두는 규칙이라면, 이쪽은 대화 중에 나온 수정 사항을 Claude가 스스로 판단해서 기록해두는 방식이다.

> \[!IMPORTANT] 아무 내용이나 메모리에 쌓아두면 오히려 다음 세션에서 불필요한 판단 기준이 늘어난다. 실제로 다음에도 적용할 만큼 반복될 내용인지, 이 프로젝트에 국한되지 않고 널리 적용되는지, 나중에 봐도 맥락 없이 이해되는 문장인지를 따져서 정말 남길 가치가 있는 것만 저장하는 편이 낫다.