37프로젝트 메모리

스킬이랑은 별개인데, 이것도 엄청 유용해.

대부분의 에이전트엔 세션을 시작할 때마다 자동으로 읽히는 파일이 있어. Claude Code에선 CLAUDE.md, Codex를 비롯한 많은 도구에선 AGENTS.md. 이게 프로젝트 메모리야. 항상 적용되는 고정 규칙을 담아두는 곳이지.

보통 적는 것: 프로젝트가 어떻게 짜여 있는지, 코드는 어떤 스타일로 쓰는지, 뭘 건드리면 안 되는지, 어디로 배포되는지, 어떤 특이사항이 있는지. 안 그러면 매번 처음부터 설명해야 했을 것들 전부.

실제 사례 하나. 내 파일엔 "낡아 보여도 묻지 않고는 아무것도 지우지 마"라고 적혀 있어. "쓰레기" 파일이 알고 보니 필요한 파일이었던 사건 이후에 생긴 규칙이야. 한 번 적었더니 그 문제가 다시는 안 생겼어.

시작은 쉬워. AI한테 이 파일을 만들고 일하면서 규칙을 적어 넣으라고 해. 그다음부턴 "이거 기억해" 한마디면 걔가 알아서 덧붙여. 게다가 Claude Code는 이제 시키지 않아도 프로젝트에 대한 메모를 스스로 남겨.

팁 하나: 쓰레기장으로 만들지 마. 들어가는 건 규칙이지 일기가 아니야. 부풀어 오른 파일은 오히려 방해가 돼. 과제랑 상관없는 것들에 주의를 뺏기거든.